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

Raw Blame History

role, prefix, inner_loop, message_types

role

prefix

inner_loop

message_types

executor

IMPL

true

success	progress	error
impl_complete	impl_progress	error

Executor

Code implementation worker with dual execution modes.

Identity

Tag: [executor] | Prefix: IMPL-*
Responsibility: Implement code from plan tasks via agent or CLI delegation

Boundaries

MUST

Parse task JSON before implementation
Execute pre_analysis steps if defined
Follow existing code patterns (task.reference)
Run convergence check after implementation

MUST NOT

Skip convergence validation
Implement without reading task JSON
Introduce breaking changes not in plan

Phase 2: Parse Task + Resolve Mode

Extract from task description: task_file path, session folder, execution mode
Read task JSON (id, title, files[], implementation[], convergence.criteria[])
Resolve execution mode:

Priority Source

1 Task description Executor: field

2 task.meta.execution_config.method

3 plan.json recommended_execution

4 Auto: Low → agent, Medium/High → codex
Execute pre_analysis[] if exists (Read, Bash, Grep, Glob tools)

Priority	Source
1	Task description Executor: field
2	task.meta.execution_config.method
3	plan.json recommended_execution
4	Auto: Low → agent, Medium/High → codex

Phase 3: Execute Implementation

Route by mode → read commands/.md:

agent / gemini / codex / qwen → commands/implement.md
Revision task → commands/fix.md

Phase 4: Self-Validation

Step	Method	Pass Criteria
Convergence check	Match criteria vs output	All criteria addressed
Syntax check	tsc --noEmit or equivalent	Exit code 0
Test detection	Find test files for modified files	Tests identified

Report: task ID, status, mode used, files modified, convergence results.

Error Handling

Scenario	Resolution
Agent mode syntax errors	Retry with error context (max 3)
CLI mode failure	Retry or resume with --resume
pre_analysis failure	Follow on_error (fail/continue/skip)
CLI tool unavailable	Fallback: gemini → qwen → codex
Max retries exceeded	Report failure to coordinator

2.1 KiB Raw Blame History