team-tech-debt

チームの技術的負債

体系的な技術的負債ガバナンス：スキャン -> 評価 -> 計画 -> 修正 -> 検証。チームワーカーエージェントアーキテクチャを基盤としており、すべてのワーカーロールで単一のエージェント定義を共有し、ロール固有の Phase 2-4 は roles/<role>/role.md から読み込みます。

アーキテクチャ

Skill(skill="team-tech-debt", args="task description")
                    |
         SKILL.md (this file) = Router
                    |
     +--------------+--------------+
     |                             |
  no --role flag              --role <name>
     |                             |
  Coordinator                  Worker
  roles/coordinator/role.md    roles/<name>/role.md
     |
     +-- analyze → dispatch → spawn workers → STOP
                                    |
                    +-------+-------+-------+-------+
                    v       v       v       v       v
           [team-worker agents, each loads roles/<role>/role.md]
          scanner  assessor  planner  executor  validator

ロールレジストリ

ロール	パス	プレフィックス	内部ループ
コーディネーター	roles/coordinator/role.md	—	—
スキャナー	roles/scanner/role.md	TDSCAN-*	false
評価担当	roles/assessor/role.md	TDEVAL-*	false
プランナー	roles/planner/role.md	TDPLAN-*	false
実行担当	roles/executor/role.md	TDFIX-*	true
検証担当	roles/validator/role.md	TDVAL-*	false

ロールルーター

$ARGUMENTS を解析します：

• --role <name> がある場合 → roles/<name>/role.md を読み込み、Phase 2-4 を実行します
• --role がない場合 → @roles/coordinator/role.md を読み込み、エントリールーターを実行します

共通定数

• セッションプレフィックス：TD
• セッションパス：.workflow/.team/TD-<slug>-<date>/
• CLI ツール：ccw cli --mode analysis（読み取り専用）、ccw cli --mode write（変更）
• メッセージバス：mcp__ccw-tools__team_msg(session_id=<session-id>, ...)
• GC の最大ラウンド数：3

ワーカー起動テンプレート

コーディネーターは次のテンプレートを使用してワーカーを起動します：

Agent({
  subagent_type: "team-worker",
  description: "Spawn <role> worker for <task-id>",
  team_name: "tech-debt",
  name: "<role>",
  run_in_background: true,
  prompt: `## Role Assignment
role: <role>
role_spec: <skill_root>/roles/<role>/role.md
session: <session-folder>
session_id: <session-id>
team_name: tech-debt
requirement: <task-description>
inner_loop: <true|false>

## Progress Milestones
session_id: <session-id>
Report progress via team_msg at natural phase boundaries (context loaded -> core work done -> verification).
Report blockers immediately via team_msg type="blocker".
Report completion via team_msg type="task_complete" after final SendMessage.

Read role_spec file (@<skill_root>/roles/<role>/role.md) to load Phase 2-4 domain instructions.
Execute built-in Phase 1 (task discovery) -> role Phase 2-4 -> built-in Phase 5 (report).`
})

ユーザーコマンド

コマンド	アクション
check / status	実行ステータスグラフを表示します
resume / continue	次のステップに進みます
--mode=scan	スキャンのみのパイプラインを実行します（TDSCAN + TDEVAL）
--mode=targeted	対象を絞ったパイプラインを実行します（TDPLAN + TDFIX + TDVAL）
--mode=remediate	パイプライン全体を実行します（デフォルト）
-y / --yes	確認をスキップします

仕様リファレンス

• specs/pipelines.md — パイプラインの定義とタスクレジストリ

セッションディレクトリ

.workflow/.team/TD-<slug>-<date>/
├── .msg/
│   ├── messages.jsonl      # Team message bus
│   └── meta.json           # Pipeline config + role state snapshot
├── scan/                   # Scanner output
├── assessment/             # Assessor output
├── plan/                   # Planner output
├── fixes/                  # Executor output
├── validation/             # Validator output
└── wisdom/                 # Cross-task knowledge

エラー処理

シナリオ	解決方法
不明なコマンド	使用可能なコマンド一覧を含むエラーを表示します
ロールが見つからない	ロールレジストリを含むエラーを表示します
セッションの破損	復旧を試み、失敗した場合は手動対応に切り替えます
高速進行の競合	次のコールバック時にコーディネーターが調整します
完了時のアクションが失敗	デフォルトでアクティブ状態を維持します
スキャナーが負債を検出しない	コードベースに問題がないことを報告し、概要に進みます