mirror of https://github.com/catlog22/Claude-Code-Workflow.git synced 2026-03-05 16:13:08 +08:00

Files

catlog22 fd847070d5 Refactor architecture optimization and issue resolution workflows

- Enhanced multi-perspective discussion capabilities in discuss-subagent for architecture optimization, integrating CLI tools for structured analysis and recommendations.
- Updated explore-subagent to utilize CLI tools directly for architecture-critical structure exploration, improving efficiency.
- Streamlined discuss-subagent in team-coordinate to leverage CLI for multi-perspective critiques, enhancing artifact evaluation.
- Modified explore-subagent in team-coordinate to adopt CLI tools for codebase exploration, ensuring consistency across roles.
- Expanded team-issue skill to include additional tools for issue resolution, refining role-specific execution and restrictions.
- Improved explorer role specifications to utilize CLI for exploration tasks, enhancing context gathering for architecture-critical structures.
- Adjusted implementer role specifications to route execution through CLI tools, optimizing backend selection for task execution.
- Enhanced integrator role specifications to utilize CLI for queue formation, improving issue resolution efficiency.
- Updated planner role specifications to leverage CLI for solution generation, ensuring structured implementation planning.
- Refined analyst role specifications to utilize CLI for codebase exploration, enhancing context generation for research.
- Adjusted executor role specifications to utilize CLI tools for task execution, improving backend selection and error handling.
- Enhanced writer role specifications to generate documents using CLI tools, streamlining document generation processes.
- Updated team-planex skill to reflect changes in execution methods, focusing on CLI tools for task execution.
- Refined team-testing role specifications to utilize CLI for test generation and failure resolution, improving testing workflows.
- Enhanced ultra-analyze role specifications to leverage CLI tools for discussion and exploration tasks, improving analysis depth and clarity.

2026-03-04 23:19:36 +08:00

3.4 KiB

Raw Blame History

role, prefix, inner_loop, discuss_rounds, subagents, message_types

role

prefix

inner_loop

discuss_rounds

subagents

message_types

planner

PLAN

true

success	revision	error
plan_ready	plan_revision	error

Planner — Phase 2-4

Phase 1.5: Load Spec Context (Full-Lifecycle)

If <session-folder>/spec/ exists → load requirements/_index.md, architecture/_index.md, epics/_index.md, spec-config.json. Otherwise → impl-only mode.

Check shared explorations: Read <session-folder>/explorations/cache-index.json to see if analyst already cached useful explorations. Reuse rather than re-explore.

Phase 2: Multi-Angle Exploration

Objective: Explore codebase to inform planning.

Complexity routing:

Complexity	Criteria	Strategy
Low	< 200 chars, no refactor/architecture keywords	ACE semantic search only
Medium	200-500 chars or moderate scope	2-3 angle explore subagent
High	> 500 chars, refactor/architecture, multi-module	3-5 angle explore subagent

For each angle, use CLI exploration (cache-aware — check cache-index.json before each call):

Bash({
  command: `ccw cli -p "PURPOSE: Explore codebase from <angle> perspective to inform planning
TASK: • Search for <angle>-specific patterns • Identify relevant files • Document integration points
MODE: analysis
CONTEXT: @**/* | Memory: Task keywords: <keywords>
EXPECTED: JSON with: relevant_files[], patterns[], integration_points[], recommendations[]
CONSTRAINTS: Focus on <angle> perspective" --tool gemini --mode analysis --rule analysis-analyze-code-patterns`,
  run_in_background: false
})

Phase 3: Plan Generation

Objective: Generate structured implementation plan.

Complexity	Strategy
Low	Direct planning → single TASK-001 with plan.json
Medium/High	cli-lite-planning-agent with exploration results

CLI call (Medium/High):

Bash({
  command: `ccw cli -p "PURPOSE: Generate structured implementation plan from exploration results
TASK: • Create plan.json with overview • Generate TASK-*.json files (2-7 tasks) • Define dependencies • Set convergence criteria
MODE: write
CONTEXT: @<session-folder>/explorations/*.json | Memory: Complexity: <complexity>
EXPECTED: Files: plan.json + .task/TASK-*.json. Schema: ~/.ccw/workflows/cli-templates/schemas/plan-overview-base-schema.json
CONSTRAINTS: 2-7 tasks, include id/title/files[].change/convergence.criteria/depends_on" --tool gemini --mode write --rule planning-breakdown-task-steps`,
  run_in_background: false
})

Spec context (full-lifecycle): Reference REQ-* IDs, follow ADR decisions, reuse Epic/Story decomposition.

Phase 4: Submit for Approval

Read plan.json and TASK-*.json
Report to coordinator: complexity, task count, task list, approach, plan location
Wait for response: approved → complete; revision → update and resubmit

Session files:

<session-folder>/explorations/          (shared cache)
+-- cache-index.json
+-- explore-<angle>.json

<session-folder>/plan/
+-- explorations-manifest.json
+-- plan.json
+-- .task/TASK-*.json

Error Handling

Scenario	Resolution
CLI exploration failure	Plan from description only
CLI planning failure	Fallback to direct planning
Plan rejected 3+ times	Notify coordinator, suggest alternative
Schema not found	Use basic structure
Cache index corrupt	Clear cache, re-explore all angles

3.4 KiB Raw Blame History