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

Files

catlog22 3fd55ebd4b feat: Add Role Analysis Reviewer Agent and validation template

- Introduced Role Analysis Reviewer Agent to validate role analysis outputs against templates and quality standards.
- Created a detailed validation ruleset for the system-architect role, including mandatory and recommended sections.
- Added JSON validation report structure for output.
- Implemented execution command for validation process.

test: Add UX tests for HookCard component

- Created comprehensive tests for HookCard component, focusing on delete confirmation UX pattern.
- Verified confirmation dialog appearance, deletion functionality, and button interactions.
- Ensured proper handling of state updates and visual feedback for enabled/disabled status.

test: Add UX tests for ThemeSelector component

- Developed tests for ThemeSelector component, emphasizing delete confirmation UX pattern.
- Validated confirmation dialog display, deletion actions, and toast notifications for undo functionality.
- Ensured proper management of theme slots and state updates.

feat: Implement useDebounce hook

- Added useDebounce hook to delay expensive computations or API calls, enhancing performance.

feat: Create System Architect Analysis Template

- Developed a comprehensive template for system architect role analysis, covering required sections such as architecture overview, data model, state machine, error handling strategy, observability requirements, configuration model, and boundary scenarios.
- Included examples and templates for each section to guide users in producing SPEC.md-level precision modeling.

2026-03-05 19:58:10 +08:00

3.2 KiB

Raw Blame History

role, prefix, inner_loop, discuss_rounds, input_artifact_types, message_types

role

prefix

inner_loop

discuss_rounds

input_artifact_types

message_types

analyst

RESEARCH

false

DISCUSS-001

success	progress	error
research_ready	research_progress	error

Analyst — Phase 2-4

Phase 2: Seed Analysis

Objective: Extract structured seed information from the topic.

Read upstream artifacts from context-artifacts.json (if exists)
Extract session folder from task description (Session: <path>)
Parse topic from task description
If topic starts with @ or ends with .md/.txt → Read referenced file
Run CLI seed analysis:

Bash({
  command: `ccw cli -p "PURPOSE: Analyze topic and extract structured seed information.
TASK: * Extract problem statement * Identify target users * Determine domain context
* List constraints * Identify 3-5 exploration dimensions * Assess complexity
TOPIC: <topic-content>
MODE: analysis
EXPECTED: JSON with: problem_statement, target_users[], domain, constraints[], exploration_dimensions[], complexity_assessment" --tool gemini --mode analysis`,
  run_in_background: false
})

Parse seed analysis JSON

Phase 3: Codebase Exploration (conditional)

Objective: Gather codebase context if project detected.

Condition	Action
package.json / Cargo.toml / pyproject.toml / go.mod exists	Explore
No project files	Skip (codebase_context = null)

When project detected: Use CLI exploration.

Bash({
  command: `ccw cli -p "PURPOSE: Explore codebase for context to inform spec generation
TASK: • Identify tech stack • Map architecture patterns • Document conventions • List integration points
MODE: analysis
CONTEXT: @**/*
EXPECTED: JSON with: tech_stack[], architecture_patterns[], conventions[], integration_points[]" --tool gemini --mode analysis --rule analysis-analyze-code-patterns`,
  run_in_background: false
})

Phase 4: Context Packaging + Discuss

4a: Context Packaging

spec-config.json → <session>/spec/spec-config.json discovery-context.json → <session>/spec/discovery-context.json design-intelligence.json → <session>/analysis/design-intelligence.json (UI mode only)

4b: Generate Artifact Manifest

Create <session>/artifacts/<task-id>/artifact-manifest.json:

{
  "artifact_id": "uuid-...",
  "creator_role": "analyst",
  "artifact_type": "spec",
  "version": "1.0.0",
  "path": "./spec/discovery-context.json",
  "dependencies": [],
  "validation_status": "passed",
  "validation_summary": "Seed analysis complete, codebase explored",
  "metadata": {
    "complexity": "low | medium | high",
    "has_codebase": true | false
  }
}

4c: Inline Discuss (DISCUSS-001)

Call discuss subagent:

Artifact: <session>/spec/discovery-context.json
Round: DISCUSS-001
Perspectives: product, risk, coverage

Handle verdict per consensus protocol.

Report: complexity, codebase presence, problem statement, dimensions, discuss verdict, output paths.

Error Handling

Scenario	Resolution
CLI failure	Fallback to direct Claude analysis
Codebase detection failed	Continue as new project
Topic too vague	Report with clarification questions
Discuss subagent fails	Proceed without discuss, log warning

3.2 KiB Raw Blame History