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.
2.1 KiB
2.1 KiB
role, prefix, inner_loop, message_types
| role | prefix | inner_loop | message_types | |
|---|---|---|---|---|
| assessor | TDEVAL | false |
|
Tech Debt Assessor
Quantitative evaluator for tech debt items. Score each debt item on business impact (1-5) and fix cost (1-5), classify into priority quadrants, produce priority-matrix.json.
Phase 2: Load Debt Inventory
| Input | Source | Required |
|---|---|---|
| Session path | task description (regex: session:\s*(.+)) |
Yes |
| .msg/meta.json | /.msg/meta.json | Yes |
| Debt inventory | meta.json:debt_inventory OR /scan/debt-inventory.json | Yes |
- Extract session path from task description
- Read .msg/meta.json for team context
- Load debt_inventory from shared memory or fallback to debt-inventory.json file
- If debt_inventory is empty -> report empty assessment and exit
Phase 3: Evaluate Each Item
Strategy selection:
| Item Count | Strategy |
|---|---|
| <= 10 | Heuristic: severity-based impact + effort-based cost |
| 11-50 | CLI batch: single gemini analysis call |
| > 50 | CLI chunked: batches of 25 items |
Impact Score Mapping (heuristic):
| Severity | Impact Score |
|---|---|
| critical | 5 |
| high | 4 |
| medium | 3 |
| low | 1 |
Cost Score Mapping (heuristic):
| Estimated Effort | Cost Score |
|---|---|
| small | 1 |
| medium | 3 |
| large | 5 |
| unknown | 3 |
Priority Quadrant Classification:
| Impact | Cost | Quadrant |
|---|---|---|
| >= 4 | <= 2 | quick-win |
| >= 4 | >= 3 | strategic |
| <= 3 | <= 2 | backlog |
| <= 3 | >= 3 | defer |
For CLI mode, prompt gemini with full debt summary requesting JSON array of {id, impact_score, cost_score, risk_if_unfixed, priority_quadrant}. Unevaluated items fall back to heuristic scoring.
Phase 4: Generate Priority Matrix
- Build matrix structure: evaluation_date, total_items, by_quadrant (grouped), summary (counts per quadrant)
- Sort within each quadrant by impact_score descending
- Write
<session>/assessment/priority-matrix.json - Update .msg/meta.json with
priority_matrixsummary and evaluateddebt_inventory