Files
Claude-Code-Workflow/.codex/skills/team-tech-debt/roles/planner/role.md
catlog22 1e560ab8e8 feat: migrate all codex team skills from spawn_agents_on_csv to spawn_agent + wait_agent architecture
- Delete 21 old team skill directories using CSV-wave pipeline pattern (~100+ files)
- Delete old team-lifecycle (v3) and team-planex-v2
- Create generic team-worker.toml and team-supervisor.toml (replacing tlv4-specific TOMLs)
- Convert 19 team skills from Claude Code format (Agent/SendMessage/TaskCreate)
  to Codex format (spawn_agent/wait_agent/tasks.json/request_user_input)
- Update team-lifecycle-v4 to use generic agent types (team_worker/team_supervisor)
- Convert all coordinator role files: dispatch.md, monitor.md, role.md
- Convert all worker role files: remove run_in_background, fix Bash syntax
- Convert all specs/pipelines.md references
- Final state: 20 team skills, 217 .md files, zero Claude Code API residuals

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-24 16:54:48 +08:00

2.7 KiB

role, prefix, inner_loop, message_types
role prefix inner_loop message_types
planner TDPLAN false
state_update

Tech Debt Planner

Remediation plan designer. Create phased remediation plan from priority matrix: Phase 1 quick-wins (immediate), Phase 2 systematic (medium-term), Phase 3 prevention (long-term). Produce remediation-plan.md.

Phase 2: Load Assessment Data

Input Source Required
Session path task description (regex: session:\s*(.+)) Yes
.msg/meta.json /.msg/meta.json Yes
Priority matrix /assessment/priority-matrix.json Yes
  1. Extract session path from task description
  2. Read .msg/meta.json for debt_inventory
  3. Read priority-matrix.json for quadrant groupings
  4. Group items: quickWins (quick-win), strategic (strategic), backlog (backlog), deferred (defer)

Phase 3: Create Remediation Plan

Strategy selection:

Item Count (quick-win + strategic) Strategy
<= 5 Inline: generate steps from item data
> 5 CLI-assisted: gemini generates detailed remediation steps

3-Phase Plan Structure:

Phase Name Source Items Focus
1 Quick Wins quick-win quadrant High impact, low cost -- immediate execution
2 Systematic strategic quadrant High impact, high cost -- structured refactoring
3 Prevention Generated from dimension patterns Long-term prevention mechanisms

Action Type Mapping:

Dimension Action Type
code refactor
architecture restructure
testing add-tests
dependency update-deps
documentation add-docs

Prevention Actions (generated when dimension has >= 3 items):

Dimension Prevention Action
code Add linting rules for complexity thresholds and code smell detection
architecture Introduce module boundary checks in CI pipeline
testing Set minimum coverage thresholds in CI and add pre-commit test hooks
dependency Configure automated dependency update bot (Renovate/Dependabot)
documentation Add JSDoc/docstring enforcement in linting rules

For CLI-assisted mode, prompt gemini with debt summary requesting specific fix steps per item, grouped into phases, with dependencies and estimated time.

Phase 4: Validate & Save

  1. Calculate validation metrics: total_actions, total_effort, files_affected, has_quick_wins, has_prevention
  2. Write <session>/plan/remediation-plan.md (markdown with per-item checklists)
  3. Write <session>/plan/remediation-plan.json (machine-readable)
  4. Update .msg/meta.json with remediation_plan summary