mirror of https://github.com/catlog22/Claude-Code-Workflow.git synced 2026-03-10 17:11:04 +08:00

Files

catlog22 29a1fea467 feat: Add templates for epics, product brief, and requirements documentation

- 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.

2026-03-07 13:32:04 +08:00

2.7 KiB

Raw Blame History

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

Extract session path from task description
Read .msg/meta.json for debt_inventory
Read priority-matrix.json for quadrant groupings
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

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

2.7 KiB Raw Blame History

Tech Debt Planner

Phase 2: Load Assessment Data

Phase 3: Create Remediation Plan

Phase 4: Validate & Save

2.7 KiB

Raw Blame History