| name | create-plan |
| description | Create a PLANS.md execution plan document for project management |
| disable-model-invocation | true |
Create Plan
プロジェクトルートに、実行計画を管理するための PLANS.md を作成する。
引数
受け付ける入力:
- プロジェクトの説明・文脈 (自由記述)
- GitHub Issue 番号 (例:
123 または #123)
- GitHub Issue の URL
$ARGUMENTS
入力の扱い
引数が GitHub Issue を参照している場合:
- 引数から Issue 番号を抽出する (形式:
#123, 123, または GitHub URL)
gh issue view <issue-number> --json number,title,body,url で Issue を取得する
- Issue から要件と文脈を把握する
- 必要に応じてコードベースから関連ファイルを検索する
- Issue の情報で PLANS.md の各セクションを埋める
- Issue メタデータをフロントマターに追加する (後述の Frontmatter セクション参照)
- PLANS.md 作成後、Issue に初回の sync コメントを投稿する
Frontmatter (Issue 連携時)
Issue と紐づく PLANS.md を作る際は、以下のフロントマターを先頭に追加する:
---
issue: 123
issue_url: https://github.com/owner/repo/issues/123
last_synced: 2025-11-12T10:30:00Z
---
issue: Issue 番号
issue_url: Issue の完全な GitHub URL
last_synced: 最終同期日時 (ISO 8601)。date -u +"%Y-%m-%dT%H:%M:%SZ" で生成
PLANS.md の構成
-
Purpose / Overview
- プロジェクトゴールの要約
- 中核的な価値提案
- 解決する問題
-
Context & Direction
-
Validation & Acceptance Criteria
- テスト可能な受け入れ基準
- テストシナリオ
- 成功指標
-
Specification
-
Open Questions
- 未解決の問い
- 検討中の選択肢
- ブロッカー・不確実性
-
Discoveries & Insights
-
Decision Log
- 主要な判断 (日付付き)
- 根拠と文脈
- 検討したトレードオフ
-
Outcomes & Retrospectives
- マイルストーンの結果
- 学び
- 良かった点・改善できる点
-
Follow-up Issues
ガイドライン
- 現時点で得られるプロジェクトコンテキストから着手する
- ユーザー入力を参照してプロジェクトの範囲を理解する
- 簡潔さと網羅性を両立する
- 継続的に更新される「生きたドキュメント」として整形する
- 追跡可能なタスクには Markdown チェックボックス (
- [ ]) を使う
- 重要: PLANS.md を作成する前にプレビューを提示し、ユーザー承認 (y/n) を得ること
Issue コメント同期 (Issue 連携時)
Issue フロントマター付き PLANS.md を作成したら、Issue にコメントを投稿する:
- リポジトリ情報を取得:
gh repo view --json owner,name
- タイムスタンプ付きの同期マーカーを生成する
- マーカー + PLANS.md 本文 (フロントマターを除く) をコメントとして投稿する:
TIMESTAMP=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
CONTENT="<!-- PLANS_SYNC_MARKER:${TIMESTAMP} -->
$(tail -n +5 PLANS.md)"
gh issue comment <issue-number> --body "$CONTENT"
同期マーカーの形式: <!-- PLANS_SYNC_MARKER:2025-11-12T10:30:00Z -->
これにより、/sync-plan が後からこのコメントを発見・更新できるようになる。