claude-code-workflow 6.1.4 → 6.2.2

package/.claude/workflows/cli-templates/prompts/rules/rule-testing.txt

@@ -0,0 +1,81 @@
+# Rule Template: Testing Rules
+
+## Variables
+- {TECH_STACK_NAME}: Tech stack display name
+- {FILE_EXT}: File extension pattern
+- {TEST_FRAMEWORK}: Primary testing framework
+
+## Output Format
+
+```markdown
+---
+paths:
+  - "**/*.{test,spec}.{FILE_EXT}"
+  - "tests/**/*.{FILE_EXT}"
+  - "__tests__/**/*.{FILE_EXT}"
+  - "**/test_*.{FILE_EXT}"
+  - "**/*_test.{FILE_EXT}"
+---
+
+# {TECH_STACK_NAME} Testing Rules
+
+## Testing Framework
+
+[Recommended frameworks from Exa research]
+- Primary: {TEST_FRAMEWORK}
+- Assertion library
+- Mocking library
+- Coverage tool
+
+## Test Structure
+
+[Organization patterns]
+
+### File Naming
+- Unit tests: `*.test.{ext}` or `*.spec.{ext}`
+- Integration tests: `*.integration.test.{ext}`
+- E2E tests: `*.e2e.test.{ext}`
+
+### Test Organization
+```{lang}
+describe('[Component/Module]', () => {
+  describe('[method/feature]', () => {
+    it('should [expected behavior]', () => {
+      // Arrange
+      // Act
+      // Assert
+    });
+  });
+});
+```
+
+## Mocking & Fixtures
+
+[Best practices]
+- Mock creation patterns
+- Fixture organization
+- Test data factories
+- Cleanup strategies
+
+## Assertions
+
+[Assertion patterns]
+- Common assertions
+- Custom matchers
+- Async assertions
+- Error assertions
+
+## Coverage Requirements
+
+[Coverage guidelines]
+- Minimum coverage thresholds
+- What to cover vs skip
+- Coverage report interpretation
+```
+
+## Content Guidelines
+
+- Include framework-specific patterns
+- Show test structure examples
+- Cover both unit and integration testing
+- Include async testing patterns

package/.claude/workflows/cli-templates/prompts/rules/tech-rules-agent-prompt.txt

@@ -0,0 +1,89 @@
+# Tech Stack Rules Generation Agent Prompt
+
+## Context Variables
+- {TECH_STACK_NAME}: Normalized tech stack name (e.g., "typescript-react")
+- {PRIMARY_LANG}: Primary language (e.g., "typescript")
+- {FILE_EXT}: File extension pattern (e.g., "{ts,tsx}")
+- {FRAMEWORK_TYPE}: frontend | backend | fullstack | library
+- {COMPONENTS}: Array of tech components
+- {OUTPUT_DIR}: .claude/rules/tech/{TECH_STACK_NAME}/
+
+## Agent Instructions
+
+Generate path-conditional rules for Claude Code automatic loading.
+
+### Step 1: Execute Exa Research
+
+Run 4-6 parallel queries based on tech stack:
+
+**Base Queries** (always execute):
+```
+mcp__exa__get_code_context_exa(query: "{PRIMARY_LANG} best practices principles 2025", tokensNum: 8000)
+mcp__exa__get_code_context_exa(query: "{PRIMARY_LANG} implementation patterns examples", tokensNum: 7000)
+mcp__exa__get_code_context_exa(query: "{PRIMARY_LANG} testing strategies conventions", tokensNum: 5000)
+mcp__exa__web_search_exa(query: "{PRIMARY_LANG} configuration setup 2025", numResults: 5)
+```
+
+**Component Queries** (for each framework in COMPONENTS):
+```
+mcp__exa__get_code_context_exa(query: "{PRIMARY_LANG} {component} integration patterns", tokensNum: 5000)
+```
+
+### Step 2: Read Rule Templates
+
+Read each template file before generating content:
+```
+Read(~/.claude/workflows/cli-templates/prompts/rules/rule-core.txt)
+Read(~/.claude/workflows/cli-templates/prompts/rules/rule-patterns.txt)
+Read(~/.claude/workflows/cli-templates/prompts/rules/rule-testing.txt)
+Read(~/.claude/workflows/cli-templates/prompts/rules/rule-config.txt)
+Read(~/.claude/workflows/cli-templates/prompts/rules/rule-api.txt)       # Only if backend/fullstack
+Read(~/.claude/workflows/cli-templates/prompts/rules/rule-components.txt) # Only if frontend/fullstack
+```
+
+### Step 3: Generate Rule Files
+
+Create directory and write files:
+```bash
+mkdir -p "{OUTPUT_DIR}"
+```
+
+**Always Generate**:
+- core.md (from rule-core.txt template)
+- patterns.md (from rule-patterns.txt template)
+- testing.md (from rule-testing.txt template)
+- config.md (from rule-config.txt template)
+
+**Conditional**:
+- api.md: Only if FRAMEWORK_TYPE == 'backend' or 'fullstack'
+- components.md: Only if FRAMEWORK_TYPE == 'frontend' or 'fullstack'
+
+### Step 4: Write Metadata
+
+```json
+{
+  "tech_stack": "{TECH_STACK_NAME}",
+  "primary_lang": "{PRIMARY_LANG}",
+  "file_ext": "{FILE_EXT}",
+  "framework_type": "{FRAMEWORK_TYPE}",
+  "components": ["{COMPONENTS}"],
+  "generated_at": "{ISO_TIMESTAMP}",
+  "source": "exa-research",
+  "files_generated": ["core.md", "patterns.md", "testing.md", "config.md", ...]
+}
+```
+
+### Step 5: Report Completion
+
+Provide summary:
+- Files created with their path patterns
+- Exa queries executed (count)
+- Sources consulted (count)
+
+## Critical Requirements
+
+1. Every .md file MUST start with `paths` YAML frontmatter
+2. Use {FILE_EXT} consistently across all rule files
+3. Synthesize Exa research into actionable rules
+4. Include code examples from Exa sources
+5. Keep each file focused on its specific domain

package/.claude/workflows/cli-templates/prompts/workflow/gemini-solution-design.txt

@@ -1,131 +1,131 @@
-Analyze and design optimal solution with comprehensive architecture evaluation and design decisions.
-
-## CORE CHECKLIST ⚡
-□ Read context-package.json to understand task requirements, source files, tech stack
-□ Analyze current architecture patterns and code structure
-□ Propose solution design with key decisions and rationale
-□ Focus on SOLUTION IMPROVEMENTS and KEY DESIGN DECISIONS
-□ Write output to specified .workflow/active/{session_id}/.process/ path
-
-## ANALYSIS PRIORITY
-
-### Source Hierarchy
-1. **PRIMARY**: Individual role analysis.md files (system-architect, ui-designer, data-architect, etc.)
-   - Technical details and implementation considerations
-   - Architecture Decision Records (ADRs)
-   - Design decision context and rationale
-
-2. **SECONDARY**: role analysis documents
-   - Integrated requirements across roles
-   - Cross-role alignment and dependencies
-   - Unified feature specifications
-
-3. **REFERENCE**: guidance-specification.md
-   - Discussion context and background
-   - Initial problem framing
-
-## REQUIRED ANALYSIS
-
-### 1. Current State Assessment
-- Identify existing architectural patterns and code structure
-- Map integration points and dependencies
-- Evaluate technical debt and pain points
-- Assess framework compatibility and constraints
-
-### 2. Solution Design
-- Propose core architecture principles and approach
-- Design component architecture and data flow
-- Specify API contracts and integration strategy
-- Define technology stack with justification
-
-### 3. Key Design Decisions
-For each critical decision:
-- **Decision**: What is being decided
-- **Rationale**: Why this approach
-- **Alternatives Considered**: Other options and their tradeoffs
-- **Impact**: Implications on architecture, performance, maintainability
-
-Minimum 2 key decisions required.
-
-### 4. Code Modification Targets
-Identify specific code locations for changes:
-- **Existing files**: `file:function:lines` format (e.g., `src/auth/login.ts:validateUser:45-52`)
-- **New files**: `file` only (e.g., `src/auth/PasswordReset.ts`)
-- **Unknown lines**: `file:function:*` (e.g., `src/auth/service.ts:refreshToken:*`)
-
-For each target:
-- Type: Modify existing | Create new
-- Modification/Purpose: What changes needed
-- Rationale: Why this target
-
-### 5. Critical Insights
-- Strengths: What works well in current/proposed design
-- Gaps: Missing capabilities or concerns
-- Risks: Technical, integration, performance, security
-- Optimization Opportunities: Performance, security, code quality
-
-### 6. Feasibility Assessment
-- Technical Complexity: Rating and analysis
-- Performance Impact: Expected characteristics
-- Resource Requirements: Development effort
-- Maintenance Burden: Ongoing considerations
-
-## OUTPUT REQUIREMENTS
-
-### Output File
-**Path**: `.workflow/active/{session_id}/.process/gemini-solution-design.md`
-**Format**: Follow structure from `~/.claude/workflows/cli-templates/prompts/workflow/analysis-results-structure.txt`
-
-### Required Sections
-- Executive Summary with feasibility score
-- Current State Analysis
-- Proposed Solution Design with 2+ key decisions
-- Implementation Strategy with code targets
-- Solution Optimization (performance, security, quality)
-- Critical Success Factors
-- Confidence Scores with recommendation
-
-### Content Guidelines
-- ✅ Focus on solution improvements and key design decisions
-- ✅ Include rationale, alternatives, and tradeoffs for decisions
-- ✅ Provide specific code targets in correct format
-- ✅ Quantify assessments with scores (X/5)
-- ❌ Do NOT create task lists or implementation steps
-- ❌ Do NOT include code examples or snippets
-- ❌ Do NOT create project management timelines
-
-## CONTEXT INTEGRATION
-
-### Session Context
-- Load context-package.json for task requirements
-- Reference workflow-session.json for session state
-- Review CLAUDE.md for project standards
-
-### Brainstorm Context
-If brainstorming artifacts exist:
-- Prioritize individual role analysis.md files
-- Use role analysis documents for integrated view
-- Reference guidance-specification.md for context
-
-### Codebase Context
-- Identify similar patterns in existing code
-- Evaluate success/failure of current approaches
-- Ensure consistency with project architecture
-
-## EXECUTION MODE
-
-**Mode**: Analysis with write permission for output file
-**CLI Tool**: Gemini wrapper with --approval-mode yolo
-**Timeout**: 40-60 minutes based on complexity
-**Output**: Single file gemini-solution-design.md
-
-## VERIFICATION CHECKLIST ✓
-□ context-package.json read and analyzed
-□ All 7 required sections present in output
-□ 2+ key design decisions with rationale and alternatives
-□ Code targets specified in correct format
-□ Feasibility scores provided (X/5)
-□ Final recommendation (PROCEED/RECONSIDER/REJECT)
-□ Output written to .workflow/active/{session_id}/.process/gemini-solution-design.md
-
-Focus: Comprehensive solution design emphasizing architecture decisions and critical insights.
+Analyze and design optimal solution with comprehensive architecture evaluation and design decisions.
+
+## CORE CHECKLIST ⚡
+□ Read context-package.json to understand task requirements, source files, tech stack
+□ Analyze current architecture patterns and code structure
+□ Propose solution design with key decisions and rationale
+□ Focus on SOLUTION IMPROVEMENTS and KEY DESIGN DECISIONS
+□ Write output to specified .workflow/active/{session_id}/.process/ path
+
+## ANALYSIS PRIORITY
+
+### Source Hierarchy
+1. **PRIMARY**: Individual role analysis.md files (system-architect, ui-designer, data-architect, etc.)
+   - Technical details and implementation considerations
+   - Architecture Decision Records (ADRs)
+   - Design decision context and rationale
+
+2. **SECONDARY**: role analysis documents
+   - Integrated requirements across roles
+   - Cross-role alignment and dependencies
+   - Unified feature specifications
+
+3. **REFERENCE**: guidance-specification.md
+   - Discussion context and background
+   - Initial problem framing
+
+## REQUIRED ANALYSIS
+
+### 1. Current State Assessment
+- Identify existing architectural patterns and code structure
+- Map integration points and dependencies
+- Evaluate technical debt and pain points
+- Assess framework compatibility and constraints
+
+### 2. Solution Design
+- Propose core architecture principles and approach
+- Design component architecture and data flow
+- Specify API contracts and integration strategy
+- Define technology stack with justification
+
+### 3. Key Design Decisions
+For each critical decision:
+- **Decision**: What is being decided
+- **Rationale**: Why this approach
+- **Alternatives Considered**: Other options and their tradeoffs
+- **Impact**: Implications on architecture, performance, maintainability
+
+Minimum 2 key decisions required.
+
+### 4. Code Modification Targets
+Identify specific code locations for changes:
+- **Existing files**: `file:function:lines` format (e.g., `src/auth/login.ts:validateUser:45-52`)
+- **New files**: `file` only (e.g., `src/auth/PasswordReset.ts`)
+- **Unknown lines**: `file:function:*` (e.g., `src/auth/service.ts:refreshToken:*`)
+
+For each target:
+- Type: Modify existing | Create new
+- Modification/Purpose: What changes needed
+- Rationale: Why this target
+
+### 5. Critical Insights
+- Strengths: What works well in current/proposed design
+- Gaps: Missing capabilities or concerns
+- Risks: Technical, integration, performance, security
+- Optimization Opportunities: Performance, security, code quality
+
+### 6. Feasibility Assessment
+- Technical Complexity: Rating and analysis
+- Performance Impact: Expected characteristics
+- Resource Requirements: Development effort
+- Maintenance Burden: Ongoing considerations
+
+## OUTPUT REQUIREMENTS
+
+### Output File
+**Path**: `.workflow/active/{session_id}/.process/gemini-solution-design.md`
+**Format**: Follow structure from `~/.claude/workflows/cli-templates/prompts/workflow/analysis-results-structure.txt`
+
+### Required Sections
+- Executive Summary with feasibility score
+- Current State Analysis
+- Proposed Solution Design with 2+ key decisions
+- Implementation Strategy with code targets
+- Solution Optimization (performance, security, quality)
+- Critical Success Factors
+- Confidence Scores with recommendation
+
+### Content Guidelines
+- ✅ Focus on solution improvements and key design decisions
+- ✅ Include rationale, alternatives, and tradeoffs for decisions
+- ✅ Provide specific code targets in correct format
+- ✅ Quantify assessments with scores (X/5)
+- ❌ Do NOT create task lists or implementation steps
+- ❌ Do NOT include code examples or snippets
+- ❌ Do NOT create project management timelines
+
+## CONTEXT INTEGRATION
+
+### Session Context
+- Load context-package.json for task requirements
+- Reference workflow-session.json for session state
+- Review CLAUDE.md for project standards
+
+### Brainstorm Context
+If brainstorming artifacts exist:
+- Prioritize individual role analysis.md files
+- Use role analysis documents for integrated view
+- Reference guidance-specification.md for context
+
+### Codebase Context
+- Identify similar patterns in existing code
+- Evaluate success/failure of current approaches
+- Ensure consistency with project architecture
+
+## EXECUTION MODE
+
+**Mode**: Analysis with write permission for output file
+**CLI Tool**: Gemini wrapper with --approval-mode yolo
+**Timeout**: 40-60 minutes based on complexity
+**Output**: Single file gemini-solution-design.md
+
+## VERIFICATION CHECKLIST ✓
+□ context-package.json read and analyzed
+□ All 7 required sections present in output
+□ 2+ key design decisions with rationale and alternatives
+□ Code targets specified in correct format
+□ Feasibility scores provided (X/5)
+□ Final recommendation (PROCEED/RECONSIDER/REJECT)
+□ Output written to .workflow/active/{session_id}/.process/gemini-solution-design.md
+
+Focus: Comprehensive solution design emphasizing architecture decisions and critical insights.

package/.claude/workflows/cli-templates/prompts/workflow/skill-conflict-patterns.txt

@@ -66,22 +66,18 @@ Document recurring conflict patterns across workflow sessions with resolutions.
 - Context packages: `.workflow/.archives/{session_id}/.process/context-package.json` (reference only)
 - Session lessons: `manifest.json` -> `archives[].lessons.challenges`
 
-## Conflict Identification (Use Gemini CLI)
+## Conflict Identification (Use CCW CLI)
 
 **Command Pattern**:
 ```bash
-gemini -p "
+ccw cli -p "
 PURPOSE: Identify conflict patterns from workflow sessions
-TASK:
-• Extract conflicts from IMPL_PLAN and lessons
-• Group by type (architecture/dependencies/testing/performance)
-• Identify recurring patterns (same conflict in different sessions)
-• Link resolutions to specific sessions
+TASK: • Extract conflicts from IMPL_PLAN and lessons • Group by type (architecture/dependencies/testing/performance) • Identify recurring patterns (same conflict in different sessions) • Link resolutions to specific sessions
 MODE: analysis
 CONTEXT: @.workflow/.archives/*/IMPL_PLAN.md @.workflow/.archives/manifest.json
 EXPECTED: Conflict patterns with frequency and resolution
-RULES: $(cat ~/.claude/workflows/cli-templates/prompts/workflow/skill-aggregation.txt)
-"
+RULES: $(cat ~/.claude/workflows/cli-templates/prompts/workflow/skill-aggregation.txt) | analysis=READ-ONLY
+" --tool gemini --cd .workflow/.archives
 ```
 
 **Pattern Grouping**:

package/.claude/workflows/cli-templates/prompts/workflow/skill-lessons-learned.txt

@@ -62,22 +62,18 @@ Aggregate lessons learned from workflow sessions, categorized by functional doma
 - Lessons: `manifest.json` -> `archives[].lessons.{successes|challenges|watch_patterns}`
 - Session metadata: `.workflow/.archives/{session_id}/workflow-session.json`
 
-## Aggregation Rules (Use Gemini CLI)
+## Aggregation Rules (Use CCW CLI)
 
 **Command Pattern**:
 ```bash
-gemini -p "
+ccw cli -p "
 PURPOSE: Aggregate workflow lessons from session data
-TASK:
-• Group successes by functional domain
-• Categorize challenges by severity (HIGH/MEDIUM/LOW)
-• Identify watch patterns with frequency >= 2
-• Mark CRITICAL patterns (3+ sessions)
+TASK: • Group successes by functional domain • Categorize challenges by severity (HIGH/MEDIUM/LOW) • Identify watch patterns with frequency >= 2 • Mark CRITICAL patterns (3+ sessions)
 MODE: analysis
 CONTEXT: @.workflow/.archives/manifest.json
 EXPECTED: Aggregated lessons with frequency counts
-RULES: $(cat ~/.claude/workflows/cli-templates/prompts/workflow/skill-aggregation.txt)
-"
+RULES: $(cat ~/.claude/workflows/cli-templates/prompts/workflow/skill-aggregation.txt) | analysis=READ-ONLY
+" --tool gemini --cd .workflow/.archives
 ```
 
 **Severity Classification**:

package/.claude/workflows/cli-templates/protocols/analysis-protocol.md

@@ -0,0 +1,112 @@
+# Analysis Mode Protocol
+
+## Mode Definition
+
+**Mode**: `analysis` (READ-ONLY)
+**Tools**: Gemini, Qwen (default mode)
+
+## Operation Boundaries
+
+### ALLOWED Operations
+- **READ**: All CONTEXT files and analyze content
+- **ANALYZE**: Code patterns, architecture, dependencies
+- **GENERATE**: Text output, insights, recommendations
+- **DOCUMENT**: Analysis results in output response only
+
+### FORBIDDEN Operations
+- **NO FILE CREATION**: Cannot create any files on disk
+- **NO FILE MODIFICATION**: Cannot modify existing files
+- **NO FILE DELETION**: Cannot delete any files
+- **NO DIRECTORY OPERATIONS**: Cannot create/modify directories
+
+**CRITICAL**: Absolutely NO file system operations - OUTPUT ONLY
+
+## Execution Flow
+
+1. **Parse** all 6 fields (PURPOSE, TASK, MODE, CONTEXT, EXPECTED, RULES)
+2. **Read** and analyze CONTEXT files thoroughly
+3. **Identify** patterns, issues, and dependencies
+4. **Generate** insights and recommendations
+5. **Output** structured analysis (text response only)
+6. **Validate** EXPECTED deliverables met
+
+## Core Requirements
+
+**ALWAYS**:
+- Analyze ALL CONTEXT files completely
+- Apply RULES (templates + constraints) exactly
+- Provide code evidence with `file:line` references
+- List all related/analyzed files at output beginning
+- Match EXPECTED deliverables precisely
+
+**NEVER**:
+- Assume behavior without code verification
+- Ignore CONTEXT file patterns
+- Skip RULES or templates
+- Make unsubstantiated claims
+- Create/modify/delete any files
+
+## RULES Processing
+
+- Parse RULES field to extract template content and constraints
+- Recognize `|` as separator: `template content | additional constraints`
+- Apply ALL template guidelines as mandatory
+- Treat rule violations as task failures
+
+## Error Handling
+
+**File Not Found**: Report missing files, continue with available, note in output
+**Invalid CONTEXT Pattern**: Report invalid pattern, request correction, do not guess
+
+## Quality Standards
+
+- **Thoroughness**: Analyze ALL files, check cross-file patterns, quantify metrics
+- **Evidence-Based**: Quote code with `file:line`, link patterns, support claims with examples
+- **Actionable**: Clear recommendations, prioritized by impact, incremental changes
+
+---
+
+## Output Format
+
+### Format Priority
+
+**If template defines output format** → Follow template format EXACTLY
+
+**If template has no format** → Use default format below
+
+### Default Analysis Output
+
+```markdown
+# Analysis: [TASK Title]
+
+## Related Files
+- `path/to/file1.ext` - [Brief description of relevance]
+- `path/to/file2.ext` - [Brief description of relevance]
+
+## Summary
+[2-3 sentence overview]
+
+## Key Findings
+1. [Finding] - path/to/file:123
+2. [Finding] - path/to/file:456
+
+## Detailed Analysis
+[Evidence-based analysis with code quotes]
+
+## Recommendations
+1. [Actionable recommendation]
+2. [Actionable recommendation]
+```
+
+### Code References
+
+**Format**: `path/to/file:line_number`
+**Example**: `src/auth/jwt.ts:45` - Authentication uses deprecated algorithm
+
+### Quality Checklist
+
+- [ ] All CONTEXT files analyzed
+- [ ] Code evidence with `file:line` references
+- [ ] Specific, actionable recommendations
+- [ ] No unsubstantiated claims
+- [ ] EXPECTED deliverables met