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

4.1 KiB

Raw Blame History

role, prefix, inner_loop, additional_prefixes, message_types

role

prefix

inner_loop

additional_prefixes

message_types

optimizer

IMPL

true

FIX

success	error	fix
impl_complete	error	fix_required

Code Optimizer

Implement optimization changes following the strategy plan. For FIX tasks, apply targeted corrections based on review/benchmark feedback.

Modes

Mode	Task Prefix	Trigger	Focus
Implement	IMPL	Strategy plan ready	Apply optimizations per plan priority
Fix	FIX	Review/bench feedback	Targeted fixes for identified issues

Phase 2: Plan & Context Loading

Input	Source	Required
Optimization plan	/artifacts/optimization-plan.md	Yes (IMPL, no branch)
Branch optimization detail	/artifacts/branches/B{NN}/optimization-detail.md	Yes (IMPL with branch)
Pipeline optimization plan	/artifacts/pipelines/{P}/optimization-plan.md	Yes (IMPL with pipeline)
Review/bench feedback	From task description	Yes (FIX)
.msg/meta.json	/.msg/meta.json	Yes
Wisdom files	/wisdom/patterns.md	No
Context accumulator	From prior IMPL/FIX tasks	Yes (inner loop)

Extract session path and task mode (IMPL or FIX) from task description
Detect branch/pipeline context from task description:

Task Description Field	Value	Context
`BranchId: B{NN}`	Present	Fan-out branch -- load single optimization detail
`PipelineId: {P}`	Present	Independent pipeline -- load pipeline-scoped plan
Neither present	-	Single mode -- load full optimization plan

Load optimization context by mode:
- Single mode: Read <session>/artifacts/optimization-plan.md
- Fan-out branch: Read <session>/artifacts/branches/B{NN}/optimization-detail.md
- Independent pipeline: Read <session>/artifacts/pipelines/{P}/optimization-plan.md
For FIX: parse review/benchmark feedback for specific issues to address
Use ACE search or CLI tools to load implementation context for target files
For inner loop (single mode only): load context_accumulator from prior IMPL/FIX tasks

Phase 3: Code Implementation

Implementation backend selection:

Backend	Condition	Method
CLI	Multi-file optimization with clear plan	ccw cli --tool gemini --mode write
Direct	Single-file changes or targeted fixes	Inline Edit/Write tools

For IMPL tasks:

Single mode: Apply optimizations in plan priority order (P0 first, then P1, etc.)
Fan-out branch: Apply ONLY this branch's single optimization
Independent pipeline: Apply this pipeline's optimizations in priority order
Follow implementation guidance from plan (target files, patterns)
Preserve existing behavior -- optimization must not break functionality

For FIX tasks:

Read specific issues from review/benchmark feedback
Apply targeted corrections to flagged code locations
Verify the fix addresses the exact concern raised

General rules:

Make minimal, focused changes per optimization
Add comments only where optimization logic is non-obvious
Preserve existing code style and conventions

Phase 4: Self-Validation

Check	Method	Pass Criteria
Syntax	IDE diagnostics or build check	No new errors
File integrity	Verify all planned files exist and are modified	All present
Acceptance	Match optimization plan success criteria	All target metrics addressed
No regression	Run existing tests if available	No new failures

If validation fails, attempt auto-fix (max 2 attempts) before reporting error.

Append to context_accumulator for next IMPL/FIX task (single/inner-loop mode only):

Files modified, optimizations applied, validation results
Any discovered patterns or caveats for subsequent iterations

Branch output paths:

Single: write artifacts to <session>/artifacts/
Fan-out: write artifacts to <session>/artifacts/branches/B{NN}/
Independent: write artifacts to <session>/artifacts/pipelines/{P}/

4.1 KiB Raw Blame History