実行計画スキル

実行計画をファーストクラスのアーティファクトとして扱い、リポジトリで版管理します。

ディレクトリ構造

.agents/
├── plans/
│   ├── active/        # 現在進行中の計画
│   ├── completed/     # 正常に完了した計画
│   └── abandoned/     # 中止された計画（理由付き）
└── debt/
    └── tech-debt-registry.md  # 既知のテクニカルデブト項目

トリガー

トリガーフレーズ	操作
create execution plan	active/ に新しい計画を作成
update plan progress	既存の計画に進捗エントリを追加
log decision	計画の決定ログに決定を追加
complete plan	計画を completed/ に移動
abandon plan	計画を abandoned/ に移動（理由付き）

計画テンプレート

新しい計画の開始点として .agents/plans/TEMPLATE.md を使用します。

必須セクション

セクション	目的
メタデータ	ステータス、日付、所有者、複雑度
目標	追跡可能なゴールのチェックボックス
決定ログ	決定と根拠の表
進捗ログ	タイムスタンプ付きの更新とエージェント属性
ブロッカー	現在の障害
関連事項	Issue、PR、ADR へのリンク

ワークフロー

計画の作成

1. TEMPLATE.md を .agents/plans/active/{slug}.md にコピー
2. メタデータを記入（status: In Progress、created: 本日、owner: エージェント名）
3. 目標をチェックボックスとして定義
4. 関連する Issue/PR にリンク

進捗の更新

1. 完了した目標にチェックを入れる
2. 進捗ログテーブルに日付、更新内容、エージェント名を含むエントリを追加
3. ブロッカーが発生した場合は更新

決定のログ記録

決定ログテーブルに行を追加します：

日付	決定	根拠	検討した代替案
YYYY-MM-DD	決定内容	この選択を選んだ理由	評価した他の案

計画の完了

1. すべての目標がチェック済みであることを確認
2. ステータスを Completed に更新
3. ファイルを active/ から completed/ に移動
4. 最終進捗エントリを追加

計画のブロック

1. ステータスを Blocked に更新
2. ブロッカーセクションに障害を記録
3. ブロックを通知する進捗エントリを追加

計画の中止

1. ステータスを Abandoned に更新
2. ブロッカーまたは最終進捗エントリに理由を記録
3. ファイルを active/ から abandoned/ に移動

統合

• セッションログは関連する場合、アクティブな計画を参照する
• プランナースキルは複雑な作業を実行する場合、ここに計画を作成する
• レトロスペクティブは完了した計画にリンクバックする

アンチパターン

避けるべき	理由	代わりに
目標のない計画	追跡不可能	測定可能なチェックボックスを定義
記録されていない決定	機関知識が失われる	すべての重要な選択肢をログに記録
古いアクティブな計画	ワークスペースが混雑する	速やかに完了または中止
Issue リンクのない計画	トレーサビリティがない	常にソース Issue にリンク

検証

計画を作成した後：

• ファイルが .agents/plans/active/ に存在する
• メタデータセクションが完全である
• 少なくとも1つの目標が定義されている
• Issue または PR にリンクされている

完了した後：

• すべての目標がチェック済みである
• 最終進捗エントリが追加されている
• ファイルが completed/ に移動されている