context-mate

Context Mate

Claude Code の自然な流れに沿って使えるツールキットです。役立つものを使い、そうでないものは無視してください。

---

このスキルが有効になったとき

context-mate が呼び出されたら、ツールを推奨する前にまずプロジェクトを分析してください。

Step 1：プロジェクトを簡単にスキャンする

次のファイルを確認してください（内容はまだ読み込まず、Glob を使用します）。

ファイル／パターン	示す内容
SESSION.md	セッション追跡が有効
IMPLEMENTATION_PHASES.md	フェーズごとの計画を使用中
PROJECT_BRIEF.md	プロジェクトの調査／計画済み
CLAUDE.md or .claude/	AI コンテキストが存在
.claude/rules/	修正ルールが存在
package.json or requirements.txt	依存関係がある
tests/ or *.test.*	テスト基盤がある

Step 2：Git の状態（Git リポジトリの場合）

git status --short            # Uncommitted changes?
git log --oneline -3          # Recent commit messages?

Step 3：段階を評価して推奨する

プロジェクトの段階：

段階	兆候	推奨
新規プロジェクト	CLAUDE.md もフェーズもない	/explore-idea または /plan-project
開発中	SESSION.md またはフェーズが存在する	/continue-session、開発者エージェント
メンテナンスモード	ドキュメントはあるが、SESSION.md はない	新しい作業には /plan-feature、監査には project-health
セッション途中	未コミットの変更と SESSION.md がある	現在の作業を続け、完了したら /wrap-session

Step 4：簡潔に出力する

ユーザーに次の内容を伝えてください。

1. すでに設定されているもの（例：「SESSION.md とフェーズがあります。プロジェクトの中盤です」）
2. 今役立つこと（例：「再開するには /continue-session を実行してください」）
3. 利用可能だが、まだ使われていないもの（例：「テストはまだありません。test-runner を利用できます」）

例：

プロジェクト分析

✓ CLAUDE.md - AI コンテキストを設定済み ✓ SESSION.md - セッション追跡が有効（フェーズ 2 を進行中） ✓ .claude/rules/ - 修正ルールが 3 件 ○ テストファイルは検出されませんでした

推奨事項：

• フェーズ 2 の作業を再開するには /continue-session を実行
• コミットの準備ができたら commit-helper エージェントを使用
• テストを追加するときは test-runner エージェントを検討

10 行以内に収めてください。情報を詰め込みすぎず、関連する内容だけを強調してください。

---

名前には二重の意味があります。

1. 親しみやすいコンテキストの相棒（ツールキット）
2. 「大事なのはコンテキストだよ、相棒！」（理念）

これは「物事の正しいやり方」ではありません。これらのツールがあるのは、コンテキストウィンドウが実際の制約だからであり、方法論を押しつけるためではありません。

---

クイックリファレンス

スラッシュコマンド（入力して使用）

コマンド	機能
/context-mate	プロジェクトを分析し、ツールを推奨する
/explore-idea	漠然としたアイデアから始める
/plan-project	新しいプロジェクトを計画する
/plan-feature	特定の機能を計画する
/wrap-session	作業セッションを終了する
/continue-session	前回のセッションから再開する
/docs-init	プロジェクトのドキュメントを作成する
/docs-update	変更後にドキュメントを更新する
/brief	クリアする前にコンテキストを保持する
/reflect	学びをルール、スキル、メモリに記録する
/release	デプロイの準備をする

エージェント（Claude が自動的に使用）

エージェント	機能
commit-helper	コミットメッセージを作成する
code-reviewer	コードの品質をレビューする
debugger	バグを調査する
test-runner	テストを実行／作成する
build-verifier	dist がソースと一致するか確認する
documentation-expert	ドキュメントを作成／更新する
orchestrator	複数ステップの作業を調整する

スキル（バックグラウンド知識）

スキル	提供する内容
project-planning	フェーズベースの計画テンプレート
project-session-management	SESSION.md のパターン
docs-workflow	ドキュメント保守コマンド
deep-debug	複数エージェントによるデバッグ
project-health	AI 可読性の監査
developer-toolbox	上記の 7 つのエージェント

---

ツールキットの概要

┌─────────────────────────────────────────────────────────────┐
│                    PROJECT LIFECYCLE                        │
├─────────────────────────────────────────────────────────────┤
│  /explore-idea → /plan-project → [work] → /wrap-session    │
│       ↓              ↓              ↓           ↓          │
│  PROJECT_BRIEF   PHASES.md     SESSION.md   git checkpoint │
│                                     ↓                      │
│                              /continue-session             │
│                                     ↓                      │
│                              [resume work]                 │
│                                     ↓                      │
│                    /reflect → /release                     │
└─────────────────────────────────────────────────────────────┘

---

どれを使うか

したいこと	使用するもの
曖昧なアイデアを掘り下げる	/explore-idea
新しいプロジェクトを計画する	/plan-project
特定の機能を計画する	/plan-feature
作業セッションを終了する	/wrap-session
休憩後に再開する	/continue-session
ドキュメントを作成・更新する	/docs-init、/docs-update
解決が難しい問題をデバッグする	deep-debug スキル
コードの品質をレビューする	code-reviewer エージェント
TDD でテストを実行する	test-runner エージェント
Git コミットを準備する	commit-helper エージェント
ビルド出力を検証する	build-verifier エージェント
ドキュメントが AI に読み取りやすいか確認する	context-auditor エージェント
ワークフローが機能するか検証する	workflow-validator エージェント
セッション引き継ぎの品質を確認する	handoff-checker エージェント

---

コンポーネントスキル

プロジェクトライフサイクル（project-workflow）

プロジェクトのライフサイクル全体をカバーする、統合された 9 つのコマンドです。

コマンド	用途
/explore-idea	プロジェクトのアイデアをブレインストーミングし、妥当性を検証する
/plan-project	段階的な実装計画を作成する
/plan-feature	特定の機能追加を計画する
/docs-init	プロジェクトの初期ドキュメントを作成する
/docs-update	変更後にドキュメントを更新する
/wrap-session	Git のチェックポイントを作成してセッションを終了する
/continue-session	SESSION.md から再開する
/reflect	進捗を振り返り、次のステップを計画する
/release	デプロイ／リリースの準備をする

呼び出し：Skill(skill: "project-workflow")

セッション管理（project-session-management）

Git のチェックポイントを使い、SESSION.md でコンテキストウィンドウをまたいで進捗を追跡します。

• IMPLEMENTATION_PHASES.md を実行可能な進捗管理に変換します
• 復旧ポイントとして、意味のある Git コミットを作成します
• 再開時に取る具体的な次のアクションを記録します
• セッション間でのコンテキストの喪失を防ぎます

呼び出し：Skill(skill: "project-session-management")

開発者エージェント（developer-toolbox）

一般的な開発タスクに対応する、7 つの専門エージェントです。

エージェント	用途
commit-helper	意味のあるコミットメッセージを作成する
code-reviewer	セキュリティ、品質、アーキテクチャをレビューする
debugger	バグを体系的に調査する
test-runner	TDD ワークフローやテスト作成に対応する
build-verifier	dist/ がソースと一致することを検証する
documentation-expert	プロジェクトのドキュメントを作成・更新する
orchestrator	複数のステップからなるプロジェクトを調整する

呼び出し：Skill(skill: "developer-toolbox")

詳細なデバッグ（deep-debug）

通常のデバッグでは解決できない、厄介なバグを複数のエージェントで調査します。

• 並行して調査するエージェントを起動します
• 調査結果を相互参照します
• ブラウザー／ランタイムの問題に対応します
• バグの調査が行き詰まったときに最適です

呼び出し：Skill(skill: "deep-debug")

品質監査（project-health）

AI からの読み取りやすさとワークフローの品質を確認する、3 つのエージェントです。

エージェント	用途
context-auditor	ドキュメントが AI に読み取りやすいか確認する（スコア 0～100）
workflow-validator	ドキュメントに記載されたプロセスが機能するか検証する（スコア 0～100）
handoff-checker	セッションの継続性の品質を検証する（スコア 0～100）

呼び出し：Skill(skill: "project-health")

ドキュメントのライフサイクル（docs-workflow）

ドキュメント管理のための 4 つのコマンドです。

コマンド	用途
/docs	ドキュメントをすばやく検索する
/docs-init	初期ドキュメントを作成する
/docs-update	変更後に更新する
/docs-claude	AI 向けに最適化された CLAUDE.md を生成する

呼び出し：Skill(skill: "docs-workflow")

---

基本概念

セッション ≠ フェーズ

セッションはコンテキストウィンドウです（コンテキストがいっぱいになるまでの 2～4 時間の作業）。

フェーズは作業単位です（「フェーズ 1：データベースのセットアップ」のような論理的なまとまり）。

1 つのフェーズが複数のセッションにまたがることもあります。1 つのセッションで複数のフェーズに取り組むこともあります。これらは別々の概念です。

チェックポイント付きの進捗

Git コミットは、単なるバージョン管理ではなく、意味のあるチェックポイントとして機能します。

# Bad: commits as save points
git commit -m "WIP"
git commit -m "more changes"

# Good: commits as progress markers
git commit -m "Complete Phase 1: Database schema and migrations"
git commit -m "Phase 2 partial: Auth middleware working, UI pending"

/continue-session で再開するとき、これらのコミットから現在の状況を把握できます。

段階的な開示

スキルはコンテキストを維持するため、段階的に読み込まれます。

1. メタデータ（約50トークン）- 常にコンテキスト内にあり、スキルの読み込みをトリガーします
2. SKILL.md 本文（5,000語未満）- スキルが有効になると読み込まれます
3. バンドルされたリソース - 必要に応じて読み込まれます（テンプレート、リファレンス、スクリプト）

つまり、50個のスキルからなるツールキットでも、実際に何かを使うまでは約2,500トークンしか消費しません。

スキルが教え、ルールが修正する

2つの知識システムが相互に補完します。

	スキル	ルール
場所	~/.claude/skills/	.claude/rules/（プロジェクト）
内容	充実したバンドル	単一の Markdown ファイル
目的	X の使い方を教える	古くなったパターンを修正する
例	Tailwind v4 のセットアップ方法	Claude が提案する可能性のある v3 の構文を修正

ルールはプロジェクト間で共有できます。リポジトリと一緒に移動するため、どの Claude インスタンスでも修正内容を利用できます。

分離のためのサブエージェント

コードレビュー、デバッグ、テストなどの負荷の高いタスクは、サブエージェントで実行します。

• 詳細な出力をメインのコンテキストに含めない
• 並列実行を可能にする
• 専門的なツールへのアクセスを提供する
• 簡潔な要約を返す

---

はじめに

新しいプロジェクト

/explore-idea    # Optional: clarify what you're building
/plan-project    # Generate phased plan
                 # Work on Phase 1...
/wrap-session    # End with checkpoint

作業の再開

/continue-session    # Reads SESSION.md, suggests next steps
                     # Continue working...
/wrap-session        # Checkpoint again

機能の追加

/plan-feature    # Plan the specific feature
                 # Implement...
/wrap-session    # Checkpoint

デバッグセッション

# If normal debugging isn't working:
Skill(skill: "deep-debug")
# Spawns investigation agents

---

考え方

コンテキストウィンドウには限りがあります。 いっぱいになります。作業が失われます。セッションは終了します。

このツールはそれに抗うのではなく、制約を受け入れて活用します。

• SESSION.md が次のセッションに向けて状態を記録します
• Git チェックポイント が復旧ポイントを作成します
• サブエージェント が負荷の高い作業を分離します
• 段階的な開示 がコンテキストの予算を維持します

役立つものを使ってください。そうでないものは無視してください。

これはナイフとスプーン流のプロジェクト管理です。

従来のプロジェクト管理	Context Mate
「方法論に従いましょう」	「なんとかなるさ」
「ガントチャートを更新しましょう」	/wrap-session
「RACI マトリックスを参照しましょう」	「おい Claude、次は何をするんだ？」

儀式はありません。AI との朝会もありません。バーンダウンチャートもありません。

Homer Simpson が30秒で理解できないなら、複雑すぎます。

大事なのはコンテキストなんだよ、相棒。 🥄