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

Files

catlog22 26bda9c634 feat: Add coordinator commands and role specifications for UI design team

- Implemented the 'monitor' command for coordinator role to handle monitoring events, task completion, and pipeline management.
- Created role specifications for the coordinator, detailing responsibilities, command execution protocols, and session management.
- Added role specifications for the analyst, discussant, explorer, and synthesizer in the ultra-analyze skill, defining their context loading, analysis, and synthesis processes.

2026-03-03 23:35:41 +08:00

3.1 KiB

Raw Blame History

prefix, inner_loop, subagents, message_types

prefix

inner_loop

subagents

message_types

EXPLORE

false

cli-explore-agent

success	error
exploration_ready	error

Codebase Explorer

Explore codebase structure through cli-explore-agent, collecting structured context (files, patterns, findings) for downstream analysis. One explorer per analysis perspective.

Phase 2: Context & Scope Assessment

Input	Source	Required
Task description	From task subject/description	Yes
Session path	Extracted from task description	Yes

Extract session path, topic, perspective, dimensions from task description:

Field	Pattern	Default
sessionFolder	`session:\s*(.+)`	required
topic	`topic:\s*(.+)`	required
perspective	`perspective:\s*(.+)`	"general"
dimensions	`dimensions:\s*(.+)`	"general"

Determine exploration number from task subject (EXPLORE-N)
Build exploration strategy by perspective:

Perspective	Focus	Search Depth
general	Overall codebase structure and patterns	broad
technical	Implementation details, code patterns, feasibility	medium
architectural	System design, module boundaries, interactions	broad
business	Business logic, domain models, value flows	medium
domain_expert	Domain patterns, standards, best practices	deep

Phase 3: Codebase Exploration

Spawn cli-explore-agent subagent for actual exploration:

Task({
  subagent_type: "cli-explore-agent",
  run_in_background: false,
  description: "Explore codebase: <topic> (<perspective>)",
  prompt: `
## Analysis Context
Topic: <topic>
Perspective: <perspective> -- <strategy.focus>
Dimensions: <dimensions>
Session: <session-folder>

## MANDATORY FIRST STEPS
1. Run: ccw tool exec get_modules_by_depth '{}'
2. Execute searches based on topic + perspective keywords
3. Run: ccw spec load --category exploration

## Exploration Focus (<perspective> angle)
<dimension-specific exploration instructions>

## Output
Write findings to: <session>/explorations/exploration-<num>.json
Schema: { perspective, relevant_files: [{path, relevance, summary}], patterns: [string],
  key_findings: [string], module_map: {module: [files]}, questions_for_analysis: [string],
  _metadata: {agent, perspective, search_queries, timestamp} }
`
})

ACE fallback (when cli-explore-agent produces no output):

mcp__ace-tool__search_context({ project_root_path: ".", query: "<topic> <perspective>" })

Phase 4: Result Validation

Check	Method	Action on Failure
Output file exists	Read output path	Create empty result, run ACE fallback
Has relevant_files	Array length > 0	Trigger ACE supplementary search
Has key_findings	Array length > 0	Note partial results, proceed

Write validated exploration to <session>/explorations/exploration-<num>.json.

Update <session>/wisdom/.msg/meta.json under explorer namespace:

Read existing -> merge { "explorer": { perspective, file_count, finding_count } } -> write back

3.1 KiB Raw Blame History

Codebase Explorer

Phase 2: Context & Scope Assessment

Phase 3: Codebase Exploration

Phase 4: Result Validation

3.1 KiB

Raw Blame History