トラック実装

トラックの実装計画からタスクを実行し、conductor/workflow.mdで定義されたワークフロールールに従います。

このスキルを使用する場合

• トラック実装タスクまたはワークフローを実行する場合
• 実装トラックのガイダンス、ベストプラクティス、またはチェックリストが必要な場合

このスキルを使用しない場合

• タスクが実装トラックに関連していない場合
• この範囲外の異なるドメインまたはツールが必要な場合

手順

• 目標、制約、および必要な入力を明確にします。
• 関連するベストプラクティスを適用し、成果物を検証します。
• 実行可能なステップと検証を提供します。
• 詳細な例が必要な場合は、resources/implementation-playbook.mdを開いてください。

事前チェック

1. Conductorが初期化されていることを確認します：

   • conductor/product.mdが存在することを確認
   • conductor/workflow.mdが存在することを確認
   • conductor/tracks.mdが存在することを確認
   • 不足している場合：エラーを表示し、最初に/conductor:setupを実行することを提案

2. ワークフロー設定を読み込みます：

   • conductor/workflow.mdを読む
   • TDD厳密度レベルを解析
   • コミット戦略を解析
   • 検証チェックポイントルールを解析

トラック選択

引数が指定されている場合：

• トラックが存在することを確認：conductor/tracks/{argument}/plan.md
• 見つからない場合：部分一致を検索し、修正を提案

引数がない場合：

1. conductor/tracks.mdを読む

2. 不完全なトラック（ステータス[ ]または[~]）を解析

3. 選択メニューを表示：

   実装するトラックを選択してください：
   
   進行中：
   1. [~] auth_20250115 - ユーザー認証（フェーズ2、タスク3）
   
   保留中：
   2. [ ] nav-fix_20250114 - ナビゲーションバグ修正
   3. [ ] dashboard_20250113 - ダッシュボード機能
   
   番号またはトラックIDを入力：
   

コンテキスト読み込み

実装に関連するすべてのコンテキストを読み込みます：

1. トラックドキュメント：

   • conductor/tracks/{trackId}/spec.md - 要件
   • conductor/tracks/{trackId}/plan.md - タスクリスト
   • conductor/tracks/{trackId}/metadata.json - 進行状態

2. プロジェクトコンテキスト：

   • conductor/product.md - 製品理解
   • conductor/tech-stack.md - 技術的制約
   • conductor/workflow.md - プロセスルール

3. コードスタイル（存在する場合）：

   • conductor/code_styleguides/{language}.md

トラック状態更新

トラックを進行中に更新します：

1. conductor/tracks.md内：

   • このトラックの[ ]を[~]に変更

2. conductor/tracks/{trackId}/metadata.json内：

   • status: "in_progress"に設定
   • updatedタイムスタンプを更新

タスク実行ループ

plan.md内の不完全な各タスク（[ ]でマーク）に対して：

1. タスク識別

plan.mdを解析して次の未完了タスクを探します：

• - [ ] Task X.Y: {description}にマッチする行を探す
• 構造から現在のフェーズを追跡

2. タスク開始

タスクを進行中としてマーク：

• plan.mdを更新：現在のタスクの[ ]を[~]に変更
• 通知：「Task X.Y: {description}を開始します」

3. TDDワークフロー（workflow.mdでTDDが有効な場合）

Red フェーズ - テスト失敗を作成：

Task X.Y のTDDワークフローに従っています...

ステップ1：テスト失敗を作成

• 必要に応じてテストファイルを作成
• タスク機能のテストを作成
• テストを実行して失敗を確認
• テストが予期せず成功する場合：一時停止して調査

Green フェーズ - 実装：

ステップ2：テストを成功させるための最小限のコードを実装

• テストを成功させるための最小限のコードを記述
• テストを実行して成功を確認
• テストが失敗する場合：デバッグして修正

リファクターフェーズ：

ステップ3：テストが成功している状態を保ちながらリファクタリング

• コードをクリーンアップ
• テストを実行してまだ成功していることを確認

4. 非TDDワークフロー（TDDが厳密でない場合）

• タスクを直接実装
• 既存のテストを実行
• 必要に応じて手動検証

5. タスク完了

変更をコミット（workflow.mdのコミット戦略に従う）：

git add -A
git commit -m "{commit_prefix}: {task description} ({trackId})"

plan.mdを更新：

• 完了したタスクの[~]を[x]に変更
• プラン更新をコミット：

git add conductor/tracks/{trackId}/plan.md
git commit -m "chore: mark task X.Y complete ({trackId})"

metadata.jsonを更新：

• tasks.completedをインクリメント
• updatedタイムスタンプを更新

6. フェーズ完了確認

各タスクの後、フェーズが完了したかどうかを確認：

• フェーズ構造についてplan.mdを解析
• 現在のフェーズのすべてのタスクが[x]の場合：

フェーズ検証を実行：

フェーズ{N}が完了しました。検証を実行しています...

• フェーズ用にリストされた検証タスクを実行
• 完全なテストスイートを実行：npm test / pytest / など

レポートを報告して承認を待つ：

フェーズ{N}検証結果：
- すべてのフェーズタスク：完了
- テスト：{パス/失敗}
- 検証：{合格/不合格}

フェーズ{N+1}に続行することを承認しますか？
1. はい、続行
2. いいえ、修正する問題があります
3. 実装を一時停止

重要：次のフェーズに進む前に、明確なユーザー承認を待機してください。

実装中のエラー処理

ツール障害時

エラー：{tool}が失敗しました：{エラーメッセージ}

オプション：
1. 操作を再試行
2. このタスクをスキップして続行
3. 実装を一時停止
4. 現在のタスク変更をリバート

• 一時停止してオプションを提示
• 自動的に続行しない

テスト失敗時

テスト失敗（Task X.Y後）

失敗したテスト：
- {テスト名}：{失敗理由}

オプション：
1. 修正を試みる
2. タスク変更をロールバック
3. 手動介入のため一時停止

Git障害時

Gitエラー：{エラーメッセージ}

これは以下を示している可能性があります：
- Conductor外からのコミットされていない変更
- マージコンフリクト
- 権限の問題

オプション：
1. gitステータスを表示
2. 解決を試みる
3. 手動介入のため一時停止

トラック完了

すべてのフェーズとタスクが完了したとき：

1. 最終検証

すべてのタスクが完了しました。最終検証を実行しています...

• 完全なテストスイートを実行
• spec.mdのすべての受け入れ基準を確認
• 検証レポートを生成

2. トラック状態を更新

conductor/tracks.md内：

• このトラックの[~]を[x]に変更
• 「更新」列を更新

conductor/tracks/{trackId}/metadata.json内：

• status: "complete"に設定
• phases.completedを合計に設定
• tasks.completedを合計に設定
• updatedタイムスタンプを更新

conductor/tracks/{trackId}/plan.md内：

• ヘッダーステータスを[x] Completeに更新

3. ドキュメント同期オファー

トラックが完了しました！ドキュメントを同期しますか？

これは以下を更新します：
- conductor/product.md（新機能が追加された場合）
- conductor/tech-stack.md（新しい依存関係が追加された場合）
- README.md（該当する場合）

1. はい、ドキュメントを同期
2. いいえ、スキップ

4. クリーンアップオファー

トラック{trackId}が完了しました。

クリーンアップオプション：
1. アーカイブ - conductor/tracks/_archive/に移動
2. 削除 - トラックディレクトリを削除
3. 保持 - そのままにする

5. 完了サマリー

トラック完了：{トラックタイトル}

サマリー：
- トラックID：{trackId}
- 完了したフェーズ：{N}/{N}
- 完了したタスク：{M}/{M}
- 作成されたコミット：{数}
- テスト：すべて成功

次のステップ：
- /conductor:statusを実行してプロジェクトの進行状況を確認
- /conductor:new-trackを実行して次の機能を開始

進捗トラッキング

実装全体を通じてmetadata.jsonの進捗を保持します：

{
  "id": "auth_20250115",
  "title": "ユーザー認証",
  "type": "feature",
  "status": "in_progress",
  "created": "2025-01-15T10:00:00Z",
  "updated": "2025-01-15T14:30:00Z",
  "current_phase": 2,
  "current_task": "2.3",
  "phases": {
    "total": 3,
    "completed": 1
  },
  "tasks": {
    "total": 12,
    "completed": 7
  },
  "commits": [
    "abc1234: feat: add login form (auth_20250115)",
    "def5678: feat: add password validation (auth_20250115)"
  ]
}

再開

実装が一時停止して再開する場合：

1. 現在の状態についてmetadata.jsonを読み込む

2. current_taskフィールドから現在のタスクを探す

3. plan.mdでタスクが[~]であるかどうかを確認

4. ユーザーに尋ねる：

   トラックを再開しています：{タイトル}
   
   最後に進行中だったタスク：Task {X.Y}：{説明}
   
   オプション：
   1. 中断したところから続行
   2. 現在のタスクを再開
   3. まず進捗サマリーを表示
   

重要なルール

1. 検証チェックポイントをスキップしない - フェーズ間で常にユーザー承認を待つ
2. エラーで停止 - エラーを過ぎて続行を試みない
3. workflow.mdに厳密に従う - TDD、コミット戦略、検証ルールは必須
4. plan.mdを更新し続ける - タスク状態は実際の進行状況を反映する必要がある
5. 頻繁にコミット - 各タスク完了はコミットされるべき
6. すべてのコミットを追跡 - 潜在的なリバート用にmetadata.jsonにコミットハッシュを記録

制限事項

• このスキルは、タスクが上記の説明範囲に明確に一致する場合にのみ使用してください。
• 出力を環境固有の検証、テスト、または専門家レビューの代替と見なさないでください。
• 必要な入力、権限、安全保障の境界、または成功基準が不足している場合は、立ち止まって明確化を求めてください。