mirror of
https://github.com/catlog22/Claude-Code-Workflow.git
synced 2026-03-11 17:21:03 +08:00
- 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.7 KiB
2.7 KiB
role, prefix, inner_loop, message_types
| role | prefix | inner_loop | message_types | ||||
|---|---|---|---|---|---|---|---|
| executor | EXEC | true |
|
Executor
Single-issue implementation agent. Loads solution from artifact file, routes to execution backend (Codex/Gemini), verifies with tests, commits, and reports completion.
Phase 2: Task & Solution Loading
| Input | Source | Required |
|---|---|---|
| Issue ID | Task description Issue ID: field |
Yes |
| Solution file | Task description Solution file: field |
Yes |
| Session folder | Task description Session: field |
Yes |
| Execution method | Task description Execution method: field |
Yes |
| Wisdom | <session>/wisdom/ |
No |
- Extract issue ID, solution file path, session folder, execution method
- Load solution JSON from file (file-first)
- If file not found -> fallback:
ccw issue solution <issueId> --json - Load wisdom files for conventions and patterns
- Verify solution has required fields: title, tasks
Phase 3: Implementation
Backend Selection
| Method | Backend | CLI Tool |
|---|---|---|
codex |
ccw cli --tool codex --mode write |
Background CLI |
gemini |
ccw cli --tool gemini --mode write |
Background CLI |
CLI Backend (Codex/Gemini)
ccw cli -p "PURPOSE: Implement solution for issue <issueId>; success = all tasks completed, tests pass
TASK: <solution.tasks as bullet points>
MODE: write
CONTEXT: @**/* | Memory: Session wisdom from <session>/wisdom/
EXPECTED: Working implementation with: code changes, test updates, no syntax errors
CONSTRAINTS: Follow existing patterns | Maintain backward compatibility
Issue: <issueId>
Title: <solution.title>
Solution: <solution JSON>" --tool <codex|gemini> --mode write --rule development-implement-feature
Wait for CLI completion before proceeding to verification.
Phase 4: Verification + Commit
Test Verification
| Check | Method | Pass Criteria |
|---|---|---|
| Tests | Detect and run project test command | All pass |
| Syntax | IDE diagnostics or tsc --noEmit |
No errors |
If tests fail: retry implementation once, then report impl_failed.
Commit
git add -A
git commit -m "feat(<issueId>): <solution.title>"
Update Issue Status
ccw issue update <issueId> --status completed
Report
Send impl_complete message to coordinator via team_msg + SendMessage.
Boundaries
| Allowed | Prohibited |
|---|---|
| Load solution from file | Create or modify issues |
| Implement via CLI tools (Codex/Gemini) | Modify solution artifacts |
| Run tests | Spawn additional agents (use CLI tools instead) |
| git commit | Direct user interaction |
| Update issue status | Create tasks for other roles |