arc-planning-work

Arc Planning Work

コーディングを始める前に実装計画を作成します。冒頭のキーワードは計画前に確認です。タスクを提案する前に、作業項目と関連コードを確認してください。

共通の計画テンプレートについては、PLAN_FORMAT.md を読み込んでください。モードの検出後、出力先固有のコマンドについては、GITHUB_MODE.md、AGILE_ACCELERATOR_MODE.md、または PRD_MODE.md を読み込んでください。同期対象の docs/ 計画および進捗成果物については、arc-implementation-plan-progress/references/output-contract.md に従ってください。

手順

1. 計画のソースを特定します。

   • GitHub モード：Issue 番号／URL、#123、または GitHub Issue の明示的な依頼。
   • Agile Accelerator モード：W-000000 の作業項目、または Salesforce Agile Accelerator のストーリー。
   • PRD から計画へのモード：既存の PRD ドキュメントから実装計画を作成するようユーザーが依頼した場合。
   • 曖昧な場合は、計画を始める前に作業項目の管理場所を確認します。

   完了条件：計画のソースモードがちょうど 1 つに定まっているか、回答を止めて出力先／ソースの確認を求めていること。

2. ソース項目を読みます。

   • 関連する場合は、Issue／ストーリー／PRD の本文とコメントを取得します。
   • ソースの受け入れ条件、制約、コンテキストを保持します。
   • 新しいストーリー／Issue は作成しません。このスキルでは既存の作業を計画します。

   完了条件：ソースのすべての受け入れ条件またはシナリオを対応付けに使用できるか、ソースにアクセスできないことがブロッカーとして報告されていること。

3. コードベースを分析します。

   • 作業項目で参照されているファイルを読みます。
   • 関連するコンポーネント、ルート、モデル、テスト、ドキュメント、および類似の実装を検索します。
   • 依存関係、リスク、およびテスト対象となりそうな場所を特定します。

   完了条件：計画内のすべてのタスクに具体的なファイル／領域が記載されているか、ファイルパスが不明な理由が明示されていること。

4. 実装計画を作成します。

   • 順序付けされた、個別に実行可能なタスクを使用します。
   • 具体的なファイル変更とテスト戦略を含めます。
   • 各受け入れ条件を 1 つ以上のタスクおよび検証方法に対応付けます。
   • ソース ID がある場合は、それを使ってフィーチャーブランチに名前を付けます。

   完了条件：別のエージェントが、スコープを再調査したり基本的な順序について質問したりせずに計画を実行できること。

5. 計画をソースに公開します。

   • GitHub：Issue にコメントします。
   • Agile Accelerator：agf__Details__c に追記し、適切な場合はステータスを更新します。
   • PRD から計画へのモード：./plans/<feature>.md またはユーザー指定の計画パスに書き込みます。
   • リポジトリに対応する docs/sprints/ 計画がある場合は、スプリント計画ドキュメントも更新します。

   完了条件：計画が指定された出力先に投稿／書き込みされているか、正確な権限／ツール上のブロッカーが報告されていること。

6. 同期された docs/ の計画および進捗成果物を作成します。

   • ソース作業項目から <ID> を解決します。追跡 ID がある場合（例：W-000025、issue-42）はそれを使用し、ない場合は作業項目のタイトルから短いケバブケースのスラッグを作成します。
   • プロジェクトルートに docs/ があることを確認します。
   • arc-implementation-plan-progress/references/output-contract.md に従って docs/<ID>-IMPLEMENTATION_PLAN.md を作成します（作成した計画を必須セクションである、プロダクト目標、ベースライン、受け入れ条件付きのマイルストーン、リスク、直近の次の手順に対応付けます）。
   • arc-implementation-plan-progress/scripts/init_progress_txt.sh docs/<ID>-IMPLEMENTATION_PLAN.md docs/<ID>-progress.txt を使用して docs/<ID>-progress.txt を作成または更新します。スクリプトを使用できない場合は、手動で契約テンプレートに従います。
   • 両方の docs/ 成果物を、手順 5 で公開した内容と同期させます。

   完了条件：同じ <ID> プレフィックスを持つ docs/<ID>-IMPLEMENTATION_PLAN.md と docs/<ID>-progress.txt が存在し、フェーズの範囲が同期されていること。

境界

• 新しいユーザーストーリーの GitHub イシューバックログを作成するには、arc-creating-user-stories を使用します。
• ユーザーに作成先を尋ねてから、複数の作成先に新しい作業項目を作成するには、arc-defining-work を使用します。
• 出力先が実装計画ではなく、PRD から作成する新しい GitHub イシューの場合は、arc-prd-to-issues を使用します。
• ユーザーが計画を承認するまで、コーディングを開始しないでください。