mirror of
https://github.com/catlog22/Claude-Code-Workflow.git
synced 2026-03-10 17:11:04 +08:00
29a1fea467
- Introduced a comprehensive template for generating epics and stories in Phase 5, including an index and individual epic files. - Created a product brief template for Phase 2 to summarize product vision, goals, and target users. - Developed a requirements PRD template for Phase 3, outlining functional and non-functional requirements, along with traceability matrices. feat: Implement tech debt roles for assessment, execution, planning, scanning, validation, and analysis - Added roles for tech debt assessment, executor, planner, scanner, validator, and analyst, each with defined phases and processes for managing technical debt. - Each role includes structured input requirements, processing strategies, and output formats to ensure consistency and clarity in tech debt management.
70 lines
2.7 KiB
Markdown
70 lines
2.7 KiB
Markdown
---
|
|
role: planner
|
|
prefix: TDPLAN
|
|
inner_loop: false
|
|
message_types: [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 | <session>/.msg/meta.json | Yes |
|
|
| Priority matrix | <session>/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
|