Work Plan スキル
ワークプランはタイムスタンプ付きのMarkdownファイルであり、自動コンパクション後も保持されます。複数ステップの作業における外部の頭脳として機能します。
ファイル規則
- 場所: プロジェクトルート、gitignore対象
- 名前:
WORKPLAN-YYYYMMDD-slug.md（例:WORKPLAN-20260228-auth-refactor.md） - タスク/フェーズごとに1ファイル。 古いワークプランを再利用しないでください。それぞれの作業ごとに新しく作成します。
アクション
作成 (/workplan または /workplan create)
-
まず読み込む。 計画を書く前に、関連するすべてのファイル、Issue、コンテキストを読んでください。
-
.gitignoreにWORKPLAN-*.mdが含まれていることを確認する（含まれていない場合は追加）。 -
計画を書く前にスコープモードを選択する:
- EXPANSION（拡張）: 「10点満点の理想版は何か？」大きく夢を見て、スコープを押し上げます。
- HOLD（維持）: 「これを堅牢にしよう。」スコープは適切で、徹底的な検証を行います。
- REDUCTION（縮小）: 「価値を届ける最低限は何か？」徹底的に削減します。
デフォルト: 新機能 = EXPANSION、バグ修正/リリース準備 = HOLD、時間制約あり = REDUCTION。
-
以下のテンプレートでファイルを作成する:
# Work Plan: [タイトル]
作成日: YYYY-MM-DD HH:MM
最終更新: YYYY-MM-DD HH:MM
ステータス: IN PROGRESS
モード: HOLD / EXPANSION / REDUCTION
## コンテキスト
[この作業が存在する理由。問題。根本原因。主要な制約。Issue/PRへのリンク。]
## ロードマップ
- [ ] 1. ステップの説明
- [ ] 2. ステップの説明
- [ ] 3. ステップの説明
## 決定事項
[アーキテクチャやアプローチの決定をタイムスタンプとともに記録]
- [HH:MM] Z の理由で Y よりも X を選択
## 発見された問題
[元のスコープにはなかった途中で見つかったもの]
- [HH:MM] ステップ2の作業中に ... を発見
## 検証ログ
[完了した各項目に検証エントリを追加]
- [HH:MM] ステップ1: VERIFIED - `npm test` を実行、全42テスト合格
- [HH:MM] ステップ3: VERIFIED - ログインフローを手動テスト、OAuthとメールで動作確認
更新 (/workplan update)
- プロジェクトルートにあるアクティブな
WORKPLAN-*.mdファイルを読み込む。 - 「最終更新」タイムスタンプを更新する。
- 完了した項目を、検証タイムスタンプとともにチェックする。
- 新しい発見や決定事項を追加する。
- 現在のステータスをユーザーに報告する。
終了 (/workplan close)
- アクティブなワークプランを読み込む。
- すべての項目が検証タイムスタンプ付きでチェックされていることを確認する。
- 最終検証（ビルド、テスト、手動チェック）を実行する。
- ステータスを
DONEに変更する。 - 最終サマリーを追加する:
## 完了
終了日: YYYY-MM-DD HH:MM
全N項目が実装および検証されました。ビルド成功。テスト合格。
再開（コンパクション後）
コンテキストがコンパクションされた場合や、どこまで進めたかわからなくなった場合:
- アクティブなワークプランを探す: プロジェクトルートで
WORKPLAN-*.mdを探す。 - ワークプランファイルを読み込む。
- 最初の未チェック項目を特定する。
- そこから続行する。
ルール
- VERIFIED はテスト済みを意味する。 「動いていると思う」ではありません。実行し、合格を確認してからVERIFIEDとマークしてください。実行した内容と結果を含めてください。
- 変更のたびにタイムスタンプを更新する。 将来の自分（コンパクション後）がこれに依存します。
- 新しい発見はすぐに記録する。 コンテキスト内にだけ保持しないでください。
- ユーザーが作業完了を確認するまで、計画を決して削除しない。
- チェックリストの項目ごとに1つの関心事。 大きなステップは、検証可能な小さな単位に分割してください。
- ステップが検証に失敗した場合、 失敗を記録し、チェックされていない状態を維持し、何が問題だったかを追加してください。