Exec Plan
.agent/PLANS.md の仕様に準拠した ExecPlan を作成・管理するワークフロー。
コーディング規約・ドキュメントマップは AGENTS.md を参照。
コマンド
/create-plan <タスク概要>
- •タスク概要を受け取り、
AGENTS.mdのドキュメントマップから関連ドキュメント・コードを探索 - •探索結果をもとにプラン案の骨子（Purpose / Context / Plan of Work）を提示
- •エンジニアと設計方針を確認（影響範囲、技術選定、代替案）
- •合意内容を反映し
.agent/PLANS.mdのテンプレートに従い.agent/plans/YYYY-MM-DD-task-name.mdを作成 - •作成後
/validate-planを自動実行
探索フェーズでは以下を重点的に調査する:
- •
assets/docs/architecture.md— 処理フロー全体像 - •
assets/docs/events-and-plugins.md— フック箇所 - •対象ファイルの既存パターン・依存関係
移行タスク（PDO移行、jQuery廃止、frame廃止等）では追加で:
- •影響ファイルの棚卸し: Grep で旧APIの使用箇所を網羅的に洗い出す
- •置換パターンの特定: 旧→新の対応表を作成（例:
mysql_query()→db()->query()） - •段階的移行の分割単位: モジュール・機能単位で独立して移行可能な範囲を特定
/validate-plan [path]
references/quality-checklist.md に基づき品質チェックを実施:
- •必須セクションの存在と内容の充実度
- •非交渉要件（自己完結、初心者実行可能、動作する成果物、用語定義）
- •不足項目を指摘し修正を提案
/update-plan [path]
- •指定プランの Progress をタイムスタンプ付きで更新
- •新たな知見を Surprises & Discoveries に追記
- •設計変更があれば Decision Log に日付と理由を記録
意思決定の閾値
自律判断可能: コードベース探索、関連ドキュメント読み込み、プランのフォーマット整形
要相談: 設計方針の選定、影響範囲の判断、実装の優先順位、代替案のトレードオフ