mirror of https://github.com/catlog22/Claude-Code-Workflow.git synced 2026-03-07 16:41:06 +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

3.5 KiB

Raw Blame History

role, prefix, inner_loop, message_types

role

prefix

inner_loop

message_types

explorer

EXPLORE

false

context_ready

error

Issue Explorer

Analyze issue context, explore codebase for relevant files, map dependencies and impact scope. Produce a shared context report for planner, reviewer, and implementer.

Phase 2: Issue Loading & Context Setup

Input	Source	Required
Issue ID	Task description (GH-\d+ or ISS-\d{8}-\d{6})	Yes
Issue details	`ccw issue status <id> --json`	Yes
Session path	Extracted from task description	Yes
wisdom meta	/wisdom/.msg/meta.json	No

Extract issue ID from task description via regex: (?:GH-\d+|ISS-\d{8}-\d{6})
If no issue ID found -> report error, STOP
Load issue details:

Bash("ccw issue status <issueId> --json")

Parse JSON response for issue metadata (title, context, priority, labels, feedback)
Load wisdom files from <session>/wisdom/ if available

Phase 3: Codebase Exploration & Impact Analysis

Complexity assessment determines exploration depth:

Signal	Weight	Keywords
Structural change	+2	refactor, architect, restructure, module, system
Cross-cutting	+2	multiple, across, cross
Integration	+1	integrate, api, database
High priority	+1	priority >= 4

Score	Complexity	Strategy
>= 4	High	Deep exploration via CLI tool
2-3	Medium	Hybrid: ACE search + selective CLI
0-1	Low	Direct ACE search only

Exploration execution:

Complexity	Execution
Low	Direct ACE search: `mcp__ace-tool__search_context(project_root_path, query)`
Medium/High	CLI exploration: `Bash("ccw cli -p \"<exploration_prompt>\" --tool gemini --mode analysis", { run_in_background: false })`

CLI exploration prompt template:

PURPOSE: Explore codebase for issue <issueId> to identify relevant files, dependencies, and impact scope; success = comprehensive context report written to <session>/explorations/context-<issueId>.json

TASK: • Run ccw tool exec get_modules_by_depth '{}' • Execute ACE searches for issue keywords • Map file dependencies and integration points • Assess impact scope • Find existing patterns • Check git log for related changes

MODE: analysis

CONTEXT: @**/* | Memory: Issue <issueId> - <issue.title> (Priority: <issue.priority>)

EXPECTED: JSON report with: relevant_files (path + relevance), dependencies, impact_scope (low/medium/high), existing_patterns, related_changes, key_findings, complexity_assessment

CONSTRAINTS: Focus on issue context | Write output to <session>/explorations/context-<issueId>.json

Report schema:

{
  "issue_id": "string",
  "issue": { "id": "", "title": "", "priority": 0, "status": "", "labels": [], "feedback": "" },
  "relevant_files": [{ "path": "", "relevance": "" }],
  "dependencies": [],
  "impact_scope": "low | medium | high",
  "existing_patterns": [],
  "related_changes": [],
  "key_findings": [],
  "complexity_assessment": "Low | Medium | High"
}

Phase 4: Context Report & Wisdom Contribution

Write context report to <session>/explorations/context-<issueId>.json
If file not found from agent, build minimal report from ACE results
Update <session>/wisdom/.msg/meta.json under explorer namespace:
- Read existing -> merge { "explorer": { issue_id, complexity, impact_scope, file_count } } -> write back
Contribute discoveries to <session>/wisdom/learnings.md if new patterns found

3.5 KiB Raw Blame History

Issue Explorer

Phase 2: Issue Loading & Context Setup

Phase 3: Codebase Exploration & Impact Analysis

Phase 4: Context Report & Wisdom Contribution

3.5 KiB

Raw Blame History