mirror of https://github.com/catlog22/Claude-Code-Workflow.git synced 2026-02-05 01:50:27 +08:00

Files

catlog22 92c543aa45 release: v4.2.1 - Command rename and documentation updates

- Rename /workflow:concept-verify to /workflow:concept-clarify
- Update CHANGELOG.md with v4.2.1 release notes
- Improve command naming for better clarity

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

2025-10-10 09:58:23 +08:00

62 KiB

Raw Blame History

Changelog

All notable changes to Claude Code Workflow (CCW) will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[4.2.1] - 2025-10-10

📝 Command Renaming & Documentation Refactoring

This release includes a command rename for better clarity and refactors UI design workflow documentation for improved maintainability.

Changed

Command Renaming:

/workflow:concept-verify → /workflow:concept-clarify: Renamed for clearer intent
- Better reflects the command's purpose of clarifying underspecified areas
- Updated all internal references and documentation
- Command functionality remains unchanged

explore-auto.md (formerly auto.md):

File Reorganization: Reduced from 540 to 435 lines (19.4% reduction)
Merged Duplicate Content: Consolidated Overview, Coordinator Role, and Execution Model into single "Overview & Execution Model" section
Simplified Core Rules: From verbose descriptions to 5 concise rules
Streamlined TodoWrite Pattern: From detailed steps to concise mode with comments
Preserved Functionality: All 6-phase execution logic, intelligent parsing, interactive confirmation, and matrix mode intact

imitate-auto.md (NEW command):

File Reorganization: Reduced from 566 to 475 lines (16.1% reduction)
Merged Sections: Combined Overview, Core Philosophy, Execution Model, and Workflow Position into unified structure
Simplified Phase 0.5: Screenshot capture logic complete but reduced redundant error handling
Consolidated Performance: Merged "Key Differences" and "Performance Benefits" into single comparison table
Preserved Functionality: All 5-phase execution, auto-screenshot mechanism, direct token extraction, and error handling intact

Improved

Documentation Quality:

📚 Clearer structure with merged duplicate concepts
🎯 Reduced redundancy across command documentation
✨ Consistent formatting and organization patterns
📖 Improved maintainability with better content separation
🔍 All key functionality points preserved and highlighted

Total Impact:

explore-auto.md: 105 lines removed (19.4% reduction)
imitate-auto.md: 91 lines removed (16.1% reduction)
Combined: 196 lines of documentation optimized
Zero functionality loss: All features, workflows, and technical details preserved

[4.2.0] - 2025-10-09

🎯 Multi-Page Support Enhancement

Based on Gemini's analysis of the UI Design Workflow, this version implements four key optimizations to improve the multi-page design experience.

Added

Cross-Page Consistency Validation: New Phase 3.5 in generate command automatically validates design consistency (shared components, tokens, accessibility) across multiple pages
Side-by-Side Prototype Comparison: compare.html preview tool now includes "Side-by-Side" tab to compare any two prototypes with intelligent consistency hints
Batch Prototype Selection: compare.html features "By Style" and "By Layout" buttons for quick bulk prototype selection

Changed

Enhanced Page Inference: auto command's page detection uses multiple regex patterns with interactive user confirmation
Improved Export: Selection export from compare.html is now more structured with detailed metadata

[4.1.1] - 2025-10-09

🔧 Symlink Fix & Agent Optimization

Fixed

Windows Symbolic Link Creation: Corrected auto.md workflow to use mklink /D on Windows, preventing duplicate directories instead of symlinks

Changed

Agent Allocation Strategy: generate.md now allocates tasks by layout (layout-based) instead of style, improving performance and consistency for high variant counts by having one agent handle one layout strategy across multiple styles

[4.1.0] - 2025-10-09

🔄 Matrix-Only UI Design Workflow

Changed

Matrix Mode by Default: UI Design workflow now exclusively uses style × layout matrix mode with --style-variants and --layout-variants as standard parameters
Path Standardization: Standalone design sessions saved to .workflow/.scratchpad/ adhering to project architecture
Simplified Orchestration: auto.md command simplified to use single SlashCommand for generation phase, removing complex loop logic

Removed

Deprecated Parameters: Removed --variants and --creative-variants in favor of explicit --style-variants and --layout-variants
Standard/Creative Modes: Distinction between these modes removed

[4.0.2] - 2025-10-09

🔄 UI Design Workflow - Complete Refactoring

BREAKING CHANGES: Complete refactoring to pure Claude-native execution, removing all external tool dependencies.

Breaking Changes

Command Path Migration:

# ❌ Old (v4.0.1 and earlier)
/workflow:design:style-extract
/workflow:design:style-consolidate
/workflow:design:ui-generate
/workflow:design:design-update
/workflow:design:auto

# ✅ New (v4.0.2)
/workflow:ui-design:extract
/workflow:ui-design:consolidate
/workflow:ui-design:generate
/workflow:ui-design:update
/workflow:ui-design:auto

Parameter Removal:

--tool parameter removed: All commands now use Claude-native execution exclusively
No more --tool gemini or --tool codex options
Simplified command syntax

Execution Model Changes:

# ❌ Old: External CLI tools required
# Required: gemini-wrapper, codex, qwen-wrapper
/workflow:design:style-extract --tool gemini --images "refs/*.png"
/workflow:design:style-consolidate --tool gemini --variants "variant-1,variant-2"
/workflow:design:ui-generate --tool codex --pages "dashboard,auth"

# ✅ New: Pure Claude + agents
/workflow:ui-design:extract --images "refs/*.png" --variants 3
/workflow:ui-design:consolidate --variants "variant-1,variant-2"
/workflow:ui-design:generate --pages "dashboard,auth" --variants 2

Removed

External Tool Dependencies:

gemini-wrapper calls removed from style-extract and style-consolidate
codex calls removed from style-consolidate and ui-generate
qwen-wrapper calls removed entirely
All bash() wrapped CLI tool invocations eliminated

Intermediate Output Files:

semantic_style_analysis.json (replaced by embedded data in style-cards.json)
initial_analysis.json (analysis now done in single pass)
style-philosophy.md (integrated into style-guide.md)
Reduced from 7+ files to 4 essential files per phase

Execution Modes:

"conventional" mode removed from ui-generate (codex dependency)
"cli" mode removed from style-consolidate (external tool dependency)
Unified to agent-only execution

Changed

style-extract (/workflow:ui-design:extract):

Before: Multi-step with gemini-wrapper + codex
- Step 1: Claude analysis → initial_analysis.json
- Step 2: gemini-wrapper → semantic_style_analysis.json
- Step 3: codex → design-tokens.json + tailwind-tokens.js
- Output: 4 files
After: Single-pass Claude analysis
- Step 1: Claude analysis → style-cards.json (with embedded proposed_tokens)
- Output: 1 file
New structure: style-cards.json includes complete proposed_tokens object per variant
Reproducibility: 100% deterministic with Claude-only execution

style-consolidate (/workflow:ui-design:consolidate):

Before: Dual-tool approach
- Step 1: gemini-wrapper → style-philosophy.md
- Step 2: codex → design-tokens.json + validation
- Mode detection: cli vs agent
After: Single-pass Claude synthesis
- Step 1: Claude reads proposed_tokens from style-cards.json
- Step 2: Claude generates all 4 files in one prompt
- Output: design-tokens.json, style-guide.md, tailwind.config.js, validation-report.json
Removed: --tool parameter and mode detection logic

ui-generate (/workflow:ui-design:generate):

Before: Three execution modes
- conventional: codex CLI calls
- agent: Task(conceptual-planning-agent)
- Mode detection based on --tool flag
After: Unified agent-only execution
- standard: Single Task(conceptual-planning-agent) for consistent variants
- creative: Parallel Task(conceptual-planning-agent) for diverse layouts
- Only --variants or --creative-variants determines mode
Removed: --tool parameter, conventional mode

design-update (/workflow:ui-design:update):

Before: References style-philosophy.md
After: Extracts philosophy from style-guide.md
Changed: Adapted to new 4-file output structure from consolidate phase

auto (/workflow:ui-design:auto):

Before: Passed --tool flags to sub-commands
After: No tool parameters, pure orchestration
Simplified: Command construction logic (no mode detection)
Examples: Updated all 3 example flows

Added

Enhanced style-cards.json Structure:

{
  "extraction_metadata": {
    "session_id": "WFS-xxx",
    "input_mode": "image|text|hybrid",
    "timestamp": "ISO-8601",
    "variants_count": 3
  },
  "style_cards": [
    {
      "id": "variant-1",
      "name": "Modern Minimalist",
      "description": "...",
      "design_philosophy": "...",
      "preview": { "primary": "oklch(...)", ... },
      "proposed_tokens": {
        "colors": { /* complete color system */ },
        "typography": { /* complete typography system */ },
        "spacing": { /* complete spacing scale */ },
        "border_radius": { /* border radius scale */ },
        "shadows": { /* shadow system */ },
        "breakpoints": { /* responsive breakpoints */ }
      }
    }
  ]
}

Unified Output Structure:

style-extraction/: style-cards.json (1 file)
style-consolidation/: design-tokens.json, style-guide.md, tailwind.config.js, validation-report.json (4 files)
prototypes/: HTML/CSS files + index.html + compare.html + PREVIEW.md

Improved

Performance:

Faster execution: No external process spawning
Reduced I/O: Fewer intermediate files
Parallel efficiency: Native agent parallelization

Reliability:

Zero external dependencies: No gemini-wrapper, codex, or qwen-wrapper required
No API failures: Eliminates external API call failure points
Consistent output: Deterministic JSON structure

Maintainability:

Simpler codebase: 5 commands, unified patterns
Clear data flow: style-cards → design-tokens → prototypes
Easier debugging: All logic visible in command files

Reproducibility:

Deterministic structure: Same inputs → same output structure
Version-controlled logic: All prompts in .md files
No black-box tools: Complete transparency

Migration Guide

For Standalone Usage:

# Old command format
/workflow:design:auto --tool gemini --prompt "Modern blog" --variants 3

# New command format (auto-migrated)
/workflow:ui-design:auto --prompt "Modern blog" --variants 3

For Integrated Workflow Sessions:

# Old workflow
/workflow:design:style-extract --session WFS-xxx --tool gemini --images "refs/*.png"
/workflow:design:style-consolidate --session WFS-xxx --tool gemini --variants "variant-1,variant-2"
/workflow:design:ui-generate --session WFS-xxx --tool codex --pages "dashboard,auth"
/workflow:design:design-update --session WFS-xxx

# New workflow (simplified)
/workflow:ui-design:extract --session WFS-xxx --images "refs/*.png" --variants 2
/workflow:ui-design:consolidate --session WFS-xxx --variants "variant-1,variant-2"
/workflow:ui-design:generate --session WFS-xxx --pages "dashboard,auth" --variants 2
/workflow:ui-design:update --session WFS-xxx

Configuration Changes Required: None - all external tool configurations can be removed

Files Changed

Renamed/Relocated:

.claude/commands/workflow/design/ → .claude/commands/workflow/ui-design/
All command files updated with new paths

Modified Commands:

style-extract.md → extract.md (complete rewrite)
style-consolidate.md → consolidate.md (complete rewrite)
ui-generate.md → generate.md (simplified)
design-update.md → update.md (adapted to new structure)
auto.md (updated orchestration)

Documentation:

Updated all command examples
Updated parameter descriptions
Added Key Improvements sections
Clarified Integration Points

[4.0.1] - 2025-10-07

🎯 Intelligent Page Inference

IMPROVEMENT: --pages parameter is now optional with smart inference from prompt or session context.

Changes:

--pages parameter: Now optional, intelligently inferred from:
1. Explicit --pages if provided
2. --prompt text analysis (e.g., "blog with home, article pages" → ["home", "article"])
3. --session synthesis-specification.md extraction
4. Default: ["home"]

New Examples:

# Simplest - pages inferred from prompt
/workflow:ui-design:auto --prompt "Modern blog with home, article and author pages"

# Explicit override if needed
/workflow:ui-design:auto --prompt "SaaS app" --pages "dashboard,settings,billing"

Commands Updated:

/workflow:ui-design:auto: All parameters now optional
/workflow:ui-design:ui-generate: --pages optional with smart inference

[4.0.0] - 2025-10-07

🚀 UI Design Workflow V2 - Agent Mode & Flexible Inputs

BREAKING CHANGES: Complete redesign of UI design workflow with mandatory new parameter structure. All old command formats are deprecated.

This major release introduces agent-driven creative exploration, unified variant control, dual-mode support (standalone/integrated), and flexible input sources (images + text prompts).

Breaking Changes

Required Migration:

Old format no longer supported: Commands using old parameter structure will fail
All parameters now optional: Smart defaults and inference for all parameters
--session: Optional, omitting enables standalone mode
--images: Optional with default design-refs/*
--pages: Optional, inferred from prompt or session (as of v4.0.1)
Removed --style-overrides: Use --prompt instead

Migration Guide:

# ❌ Old (v3.5.0 and earlier) - NO LONGER WORKS
/workflow:ui-design:style-extract --session WFS-auth --images "design-refs/*.png"
/workflow:ui-design:ui-generate --session WFS-auth --pages "login,register"

# ✅ New (v4.0.1) - All parameters optional
/workflow:ui-design:style-extract --images "design-refs/*.png" --variants 3
/workflow:ui-design:ui-generate --variants 2

# ✅ Simplest form (pages inferred from prompt)
/workflow:ui-design:auto --prompt "Modern blog with home, article and author pages"

# ✅ With agent mode and explicit pages
/workflow:ui-design:auto --prompt "Modern SaaS" --pages "dashboard,settings" --variants 3 --use-agent

Deprecated Commands:

Old style-extract format without --variants
Old ui-generate format without --use-agent support
--style-overrides parameter (replaced by --prompt)

Added

Unified Variant Control:

--variants <count>: Single parameter controls both style cards AND UI prototypes generation
- Default: 3 | Range: 1-5
- Data flow: auto.md → style-extract → ui-generate
- Example: --variants 3 generates 3 style cards and 3 UI variants per page

Agent Creative Exploration Mode (--use-agent):

style-extract: Parallel generation of distinctly different design directions
- Conventional mode: Subtle variations within same core style
- Agent mode: Dramatically different aesthetics (e.g., "Modern Minimalist" vs "Brutalist Tech" vs "Organic Warmth")
- Uses conceptual-planning-agent for creative exploration
ui-generate: Diverse layout strategies exploration
- Conventional mode: Minor layout differences
- Agent mode: Structural variations (F-Pattern, Asymmetric Grid, Card-Based Modular)
- Parallel execution for efficiency

Dual Mode Support:

Integrated Mode (with --session): Works within existing workflow session
- Location: .workflow/WFS-{session}/
- Reads from .brainstorming/ artifacts
- Phase 4 (design-update) updates synthesis-specification.md
Standalone Mode (without --session): Independent quick prototyping
- Auto-creates: design-session-YYYYMMDD-HHMMSS/
- No dependency on brainstorming phase
- Phase 4 (design-update) is skipped
- Outputs final summary instead

Dual Input Source Support:

--images: Reference image paths (optional, default: design-refs/*)
--prompt: Text description of design style (NEW)
Hybrid Mode: Both combined - text guides image analysis
Input modes:
- Pure image: Existing triple vision analysis
- Pure text: Claude keywords → Gemini philosophy → Codex tokens
- Hybrid: Text as context for visual analysis

Changed

New Command Interface (v4.0.1):

/workflow:ui-design:auto:
- All parameters optional with smart defaults
- --prompt <desc>: Design description (infers pages automatically)
- --images <glob>: Reference images (default: design-refs/*)
- --pages <list>: Explicit page override (auto-inferred if omitted)
- --session <id>, --variants <count>, --use-agent, --batch-plan
- Examples:
  - Minimal: /workflow:ui-design:auto --prompt "Modern blog with home and article pages"
  - Agent Mode: /workflow:ui-design:auto --prompt "SaaS dashboard and settings" --variants 3 --use-agent
  - Hybrid: /workflow:ui-design:auto --images "refs/*.png" --prompt "E-commerce: home, product, cart"
/workflow:ui-design:style-extract:
- At least one of --images or --prompt recommended
- All other parameters optional
- Agent mode: Parallel generation of diverse design directions
/workflow:ui-design:ui-generate:
- All parameters optional (pages inferred from session or defaults to ["home"])
- --pages <list>: Optional explicit page list
- Agent mode: Parallel layout exploration (F-Pattern, Grid, Asymmetric)

Usage Examples

Standalone Quick Prototyping:

# Pure text with page inference (simplest)
/workflow:ui-design:auto --prompt "Modern minimalist blog with home, article and author pages, dark theme" --use-agent

# Pure image with inferred pages
/workflow:ui-design:auto --images "refs/*.png" --variants 2

# Hybrid input with explicit page override
/workflow:ui-design:auto --images "current-app.png" --prompt "Modernize to Linear.app style" --pages "tasks,settings" --use-agent

Integrated Workflow Enhancement:

# Within existing workflow (pages inferred from synthesis)
/workflow:ui-design:auto --session WFS-app-refresh --images "refs/*.png" --variants 3 --use-agent

Technical Details

Agent Mode Architecture:

Uses conceptual-planning-agent for both style-extract and ui-generate phases
Parallel task execution: N variants × M pages run concurrently
Theme diversity strategies:
- style-extract: Creative theme generation (Minimalist, Brutalist, Organic)
- ui-generate: Layout strategy assignment (F-Pattern, Grid, Asymmetric)
Quality assurance: All variants maintain strict token adherence and WCAG AA compliance

Mode Detection Logic:

# Session mode
IF --session provided: mode = "integrated"
ELSE: mode = "standalone", auto-create design-session-YYYYMMDD-HHMMSS/

# Execution mode
IF --use-agent: mode = "agent" (creative exploration)
ELSE: mode = "conventional" (triple vision)

# Input mode
IF --images AND --prompt: mode = "hybrid"
ELSE IF --images: mode = "image"
ELSE IF --prompt: mode = "text"

Upgrade Benefits

Simplified Workflow:

Fewer required parameters (only --pages mandatory)
Smart defaults reduce boilerplate
Standalone mode for quick prototyping without workflow setup

Enhanced Capabilities:

Agent-driven creative exploration produces diverse designs
Parallel execution improves performance
Text prompts enable design without reference images

Quality Improvements:

All variants maintain strict token adherence
WCAG AA compliance validated automatically
Better separation of concerns (style vs layout)

[3.5.0] - 2025-10-06

🎨 UI Design Workflow with Triple Vision Analysis & Interactive Preview

This release introduces a comprehensive UI design workflow system with triple vision analysis capabilities, interactive user checkpoints, zero agent overhead, and enhanced preview tools for real-time prototype comparison.

Added

New UI Design Workflow System:

/workflow:ui-design:auto: Semi-autonomous UI design workflow orchestrator
- Interactive checkpoints for user style selection and prototype confirmation
- Optional batch task generation with --batch-plan flag
- Pause-and-continue pattern at critical decision points
- Automatic progression between phases after user input
- Support for multiple UI variants per page (--variants parameter)

Triple Vision Analysis Architecture:

Phase 1: Claude Code Vision Analysis: Quick initial visual analysis using native Read tool
Phase 2: Gemini Vision Analysis: Deep semantic understanding of design intent
Phase 3: Codex Vision Analysis: Structured pattern recognition with -i parameter
Phase 4: Consensus Synthesis: Weighted combination by main Claude agent
Synthesis Strategy:
- Color system: Consensus with Codex precision preference
- Typography: Gemini semantic + Codex measurements
- Spacing: Cross-validation across all three sources
- Design philosophy: Weighted with Gemini highest priority
- Conflict resolution: Majority vote or synthesis-specification.md context

Individual Design Commands:

/workflow:ui-design:style-extract - Extract design styles from reference images

Usage: /workflow:ui-design:style-extract --session <session_id> --images "<glob_pattern>"

Examples:

/workflow:ui-design:style-extract --session WFS-auth --images "design-refs/*.png"
/workflow:ui-design:style-extract --session WFS-dashboard --images "refs/dashboard-*.jpg"

Features:
- Triple vision analysis (Claude Code + Gemini + Codex)
- Generates semantic_style_analysis.json, design-tokens.json, style-cards.json
- Outputs multiple style variant cards for user selection
- Direct bash execution (no agent wrappers)
- Supports PNG, JPG, WebP image formats
Output: .design/style-extraction/ with analysis files and 2-3 style variant cards

/workflow:ui-design:style-consolidate - Consolidate selected style variants

Usage: /workflow:ui-design:style-consolidate --session <session_id> --variants "<variant_ids>"

Examples:

/workflow:ui-design:style-consolidate --session WFS-auth --variants "variant-1,variant-3"
/workflow:ui-design:style-consolidate --session WFS-dashboard --variants "variant-2"

Features:
- Validates and merges design tokens from selected variants
- Generates finalized design-tokens.json, style-guide.md, tailwind.config.js
- WCAG AA compliance validation (contrast ≥4.5:1 for text)
- Token coverage ≥90% requirement
- OKLCH color format with fallback
Output: .design/style-consolidation/ with validated design system files

/workflow:ui-design:ui-generate - Generate production-ready UI prototypes (NEW: with preview enhancement)

Usage: /workflow:ui-design:ui-generate --session <session_id> --pages "<page_list>" [--variants <count>] [--style-overrides "<path_or_json>"]

Examples:

/workflow:ui-design:ui-generate --session WFS-auth --pages "login,register"
/workflow:ui-design:ui-generate --session WFS-dashboard --pages "dashboard" --variants 3
/workflow:ui-design:ui-generate --session WFS-auth --pages "login" --style-overrides "overrides.json"

Features:
- Token-driven HTML/CSS generation with Codex
- Support for --style-overrides parameter for runtime customization
- Generates {page}-variant-{n}.html, {page}-variant-{n}.css per page
- 🆕 Auto-generates preview files: index.html, compare.html, PREVIEW.md
- Semantic HTML5 with ARIA attributes
- Responsive design with token-based breakpoints
- Complete standalone prototypes (no external dependencies)
Output: .design/prototypes/ with HTML/CSS files and preview tools
Preview: Open index.html in browser or start local server for interactive preview

/workflow:ui-design:design-update - Integrate design system into brainstorming

Usage: /workflow:ui-design:design-update --session <session_id> [--selected-prototypes "<prototype_ids>"]

Examples:

/workflow:ui-design:design-update --session WFS-auth
/workflow:ui-design:design-update --session WFS-auth --selected-prototypes "login-variant-1,register-variant-2"

Features:
- Updates synthesis-specification.md with UI/UX guidelines section
- Creates/updates ui-designer/style-guide.md
- Makes design tokens available for task generation phase
- Merges selected prototype recommendations into brainstorming artifacts
Output: Updated brainstorming files with design system integration

/workflow:ui-design:auto - Semi-autonomous orchestrator with interactive checkpoints

Usage: /workflow:ui-design:auto --session <session_id> --images "<glob>" --pages "<list>" [--variants <count>] [--batch-plan]

Examples:

/workflow:ui-design:auto --session WFS-auth --images "design-refs/*.png" --pages "login,register"
/workflow:ui-design:auto --session WFS-dashboard --images "refs/*.jpg" --pages "dashboard" --variants 3 --batch-plan

Features:
- Orchestrates entire design workflow with pause-and-continue checkpoints
- Checkpoint 1: User selects style variants after extraction
- Checkpoint 2: User confirms prototypes before design-update
- Optional --batch-plan for automatic task generation after design-update
- Progress tracking with TodoWrite integration
Workflow: style-extract → [USER SELECTS] → style-consolidate → ui-generate → [USER CONFIRMS] → design-update → [optional batch-plan]

Interactive Checkpoint System:

Checkpoint 1 (After style-extract): User selects preferred style variants
- Command: /workflow:ui-design:style-consolidate --session WFS-xxx --variants "variant-1,variant-3"
- Workflow pauses until user runs consolidation command
Checkpoint 2 (After ui-generate): User confirms selected prototypes
- Command: /workflow:ui-design:design-update --session WFS-xxx --selected-prototypes "page-variant-1,page-variant-2"
- Workflow pauses until user runs design-update command

Design System Features:

OKLCH Color Format: Perceptually uniform color space for design tokens
W3C Design Tokens Compatibility: Standard-compliant token format
Style Override Mechanism: Runtime token merging using jq
Batch Task Generation: Automatic /workflow:plan invocation for each page
Accessibility Validation: WCAG 2.1 AA compliance checks

Preview Enhancement System (NEW):

index.html: Master preview navigation page
- Grid layout of all generated prototypes
- Quick links to individual variants
- Metadata display (session ID, timestamps, page info)
- Direct access to implementation notes
compare.html: Interactive side-by-side comparison
- Iframe-based comparison for multiple variants
- Responsive viewport toggles (Desktop 100%, Tablet 768px, Mobile 375px)
- Synchronized scrolling option
- Dynamic page switching dropdown
- Real-time variant comparison
PREVIEW.md: Comprehensive preview instructions
- Direct browser opening guide
- Local server setup (Python, Node.js, PHP, VS Code Live Server)
- Browser compatibility notes
- Troubleshooting guide
- File structure overview

Preview Workflow:

# After ui-generate completes:
cd .workflow/WFS-{session}/.design/prototypes

# Option 1: Direct browser (simplest)
open index.html  # or double-click

# Option 2: Local server (recommended)
python -m http.server 8080  # Visit http://localhost:8080

# Features:
- index.html: Browse all prototypes
- compare.html: Side-by-side comparison with viewport controls
- Responsive preview: Test mobile, tablet, desktop views
- Synchronized scrolling: Compare layouts in sync

Changed

Agent Architecture Simplification:

Removed agent wrappers from style-extract and ui-generate commands
- Previously used Task(conceptual-planning-agent) for simple bash execution
- Now executes gemini-wrapper and codex commands directly via Bash tool
- Reduced execution overhead and complexity
- Preserved all functionality while improving performance

Command Execution Pattern:

Direct Bash Execution: All CLI tools now use direct bash commands
- Gemini Vision: bash(gemini-wrapper --approval-mode yolo -p "...")
- Codex Vision: bash(codex -i {images} --full-auto exec "..." -s danger-full-access)
- Codex Token Generation: bash(codex --full-auto exec "..." -s danger-full-access)
- No intermediate agent layers

Workflow Integration:

Design phase now optional but recommended for UI-heavy projects
Seamless integration with existing brainstorming → planning → execution flow
Design artifacts automatically discovered by task-generate if present
UI tasks automatically include load_design_tokens in flow_control

Updated Documentation:

README.md: Added UI Design Workflow section in Getting Started
README_CN.md: Chinese documentation updated with design workflow
Command Reference: Added 5 new /workflow:ui-design:* commands
Phase Renumbering: Shifted phases to accommodate new Phase 2 (UI Design)

Benefits

User Experience:

🎨 Visual Validation: Users confirm design before implementation starts
⏸️ Interactive Control: Critical design decisions require explicit user approval
👁️ Comprehensive Analysis: Three AI vision sources provide robust style extraction
🎯 Zero Waiting: Direct bash execution eliminates agent overhead
📦 Automation Ready: Optional batch task generation accelerates workflow

Code Quality:

🔒 Token Enforcement: 100% CSS values use custom properties (verified)
♿ Accessibility: WCAG AA validated at design phase
🎨 Consistency: Single source of truth for visual design (design-tokens.json)
🧪 Production Ready: Semantic HTML5, responsive, accessible prototypes

Development Workflow:

🔄 Seamless Integration: Optional design phase fits between brainstorming and planning
🚀 Backward Compatible: Existing workflows unaffected if design phase skipped
📊 Better Planning: Design system context improves task generation quality
🎯 Focused Implementation: Developers work from validated prototypes and tokens

Technical Details

Triple Vision Analysis Flow:

Reference Images
  ↓
Phase 2: Claude Code (Read tool) → claude_vision_analysis.json
Phase 3: Gemini Vision (gemini-wrapper) → gemini_vision_analysis.json
Phase 4: Codex Vision (codex -i) → codex_vision_analysis.json
  ↓
Phase 5: Main Claude Synthesis → semantic_style_analysis.json
  ↓
Phase 6: Codex Token Generation → design-tokens.json, style-cards.json

Checkpoint Workflow Pattern:

User: /workflow:ui-design:auto --session WFS-xxx --images "refs/*.png" --pages "dashboard,auth"
  ↓
Phase 1: style-extract (automatic)
  ↓ [CHECKPOINT 1: User selects style variants]
User: /workflow:ui-design:style-consolidate --session WFS-xxx --variants "variant-1,variant-3"
  ↓
Phase 3: ui-generate (automatic after Phase 2)
  ↓ [CHECKPOINT 2: User confirms prototypes]
User: /workflow:ui-design:design-update --session WFS-xxx --selected-prototypes "dashboard-variant-1,auth-variant-2"
  ↓
Phase 5: batch-plan (optional, automatic if --batch-plan flag)

Output Structure:

.workflow/WFS-{session}/.design/
├── style-extraction/
│   ├── claude_vision_analysis.json
│   ├── gemini_vision_analysis.json
│   ├── codex_vision_analysis.json
│   ├── semantic_style_analysis.json (synthesis)
│   ├── design-tokens.json (preliminary)
│   └── style-cards.json (variants for selection)
├── style-consolidation/
│   ├── style-philosophy.md
│   ├── design-tokens.json (final, validated)
│   ├── style-guide.md
│   ├── tailwind.config.js
│   └── validation-report.json
└── prototypes/
    ├── {page}-variant-{n}.html (per page, per variant)
    ├── {page}-variant-{n}.css (token-driven styles)
    ├── {page}-variant-{n}-notes.md (implementation notes)
    └── design-tokens.css (CSS custom properties)

New Agent Documentation:

ui-design-agent.md: Specialized agent for UI/UX design workflows
- Vision analysis, token generation, prototype creation capabilities
- Multi-modal vision provider strategy (Gemini primary, Codex fallback)
- Quality gates: WCAG AA, token coverage ≥90%, component mapping ≥95%
- Flow control specification for 3 design phases

Use Cases

When to Use Design Workflow:

User-facing applications with visual design requirements
Design system creation and maintenance
Brand-critical user interfaces
Projects requiring accessibility compliance
Multi-page applications with consistent styling

When to Skip Design Workflow:

Backend APIs without UI components
CLI tools and command-line applications
Quick prototypes and MVPs
Projects with existing design systems

[3.4.2] - 2025-10-05

📚 CLI Documentation Refactoring

This release focuses on eliminating redundant documentation by establishing a single source of truth (SSOT) pattern for CLI command references.

Changed

CLI Command Documentation Refactoring:

Refactored 7 CLI command documentation files to eliminate redundancy
Removed 681 total lines of duplicate content across all files
Established implicit reference pattern to intelligent-tools-strategy.md (loaded in memory)
Preserved all unique command-specific content and capabilities

Specific File Reductions:

analyze.md: 117→61 lines (48% reduction)
chat.md: 118→62 lines (47% reduction)
execute.md: 180→100 lines (44% reduction)
codex-execute.md: 481→473 lines (2% - preserved unique workflow content)
mode/bug-index.md: 144→75 lines (48% reduction)
mode/code-analysis.md: 188→76 lines (60% reduction)
mode/plan.md: 100→76 lines (24% reduction)

Removed Duplicate Sections:

Universal Command Template (now only in intelligent-tools-strategy.md)
File Pattern Reference (centralized in strategy guide)
Complex Pattern Discovery (centralized in strategy guide)
MODE Field Definition (centralized in strategy guide)
Enhancement Integration details (referenced implicitly)
Session Persistence details (referenced implicitly)

Preserved Unique Content:

Command-specific purpose and parameters
Unique execution flows and capabilities
Specialized features (YOLO permissions, task decomposition, resume patterns)
Command-specific examples and workflows
File pattern auto-detection logic for analyze command
Group-based execution workflow for codex-execute command

Added

Documentation Enhancement (prior to refactoring):

Enhanced file pattern examples and complex pattern discovery documentation
Added semantic discovery workflow integration examples

Technical Details

Single Source of Truth Pattern: All CLI commands now reference intelligent-tools-strategy.md for:

Universal command template structure
File pattern syntax and examples
Complex pattern discovery workflows
MODE field definitions and permissions
Tool-specific features and capabilities

Reference Pattern:

## Notes
- Command templates and file patterns: see intelligent-tools-strategy.md (loaded in memory)

This approach reduces maintenance overhead while ensuring documentation consistency across all CLI commands.

[3.4.1] - 2025-10-04

🎯 Multi-Tool Support for Documentation Updates

This release adds flexible tool selection for CLAUDE.md documentation generation, allowing users to choose between Gemini, Qwen, or Codex based on their analysis needs.

Added

Multi-Tool Support:

/update-memory-full --tool <gemini|qwen|codex>: Choose tool for full project documentation update
/update-memory-related --tool <gemini|qwen|codex>: Choose tool for context-aware documentation update
Default: Gemini (documentation generation, pattern recognition)
Qwen: Architecture analysis, system design documentation
Codex: Implementation validation, code quality analysis

Script Enhancement (update_module_claude.sh):

Added third parameter for tool selection: <module_path> [update_type] [tool]
Support for three tools with consistent parameter syntax:
- gemini --all-files --yolo -p (default)
- qwen --all-files --yolo -p (direct command, no wrapper)
- codex --full-auto exec (with danger-full-access)
Automatic tool routing via case statement
Improved logging with tool information display

Changed

Command Documentation:

Updated /update-memory-full.md with tool selection usage and examples
Updated /update-memory-related.md with tool selection usage and examples
Added tool selection strategy and rationale documentation

Technical Details

Tool Execution Patterns:

# Gemini (default)
gemini --all-files --yolo -p "$prompt"

# Qwen (architecture analysis)
qwen --all-files --yolo -p "$prompt"

# Codex (implementation validation)
codex --full-auto exec "$prompt" --skip-git-repo-check -s danger-full-access

Backward Compatibility:

✅ Existing commands without --tool parameter default to Gemini
✅ All three tools support Layer 1-4 template system
✅ No breaking changes to existing workflows

[3.3.0] - 2025-10-04

🚀 CLI Tool Enhancements & Codex Multi-Step Execution

This release streamlines CLI tool documentation and introduces automated multi-step task execution with Codex.

Added

New Command: /cli:codex-execute:

Purpose: Automated task decomposition and sequential execution with Codex
Features:
- Automatic task breakdown into 3-8 manageable subtasks
- Sequential execution using codex exec "..." resume --last mechanism
- TodoWrite progress tracking for each subtask
- Optional Git verification after each subtask (--verify-git flag)
- Supports both freeform descriptions and workflow task IDs
- Automatic detection and loading of task JSON files
- Context continuity across subtasks via resume mechanism
- Integration with workflow system (optional)

Codex Resume Mechanism:

First Subtask: Creates new Codex session with codex exec
Subsequent Subtasks: Continues with codex exec "..." resume --last
Benefits:
- Session memory preserves previous decisions
- Maintains implementation style consistency
- Avoids redundant context re-injection
- Enables incremental testing and validation

Enhanced Codex Agent Configuration (.codex/AGENTS.md):

Added multi-task prompt format (Single-Task & Multi-Task)
Enhanced MODE: auto with subtask execution flow
New "Multi-Step Task Execution" section with:
- Context continuity best practices
- Subtask coordination guidelines
- Example 3-subtask workflow demonstration
Updated progress reporting for subtasks
Version 2.1.0 with multi-step task execution support

Changed

CLI Documentation Optimization:

Streamlined Documentation: Reduced redundancy by referencing intelligent-tools-strategy.md
Updated Commands:
- /cli:analyze - Simplified from ~200 to ~78 lines
- /cli:chat - Simplified from ~161 to ~92 lines
- /cli:execute - Simplified from ~235 to ~111 lines
Unified Command Templates:
- Separated Gemini/Qwen (uses -p parameter) from Codex (uses exec command)
- Added Codex -i parameter documentation for image attachment
- Consistent template structure across all CLI commands

Intelligent Tools Strategy Updates:

Enhanced Codex session management documentation
Added codex exec "..." resume --last syntax explanation
Documented multi-task execution pattern
Clarified image attachment workflow with resume

Command Template Improvements:

Gemini/Qwen: cd [dir] && ~/.claude/scripts/[tool]-wrapper -p "..."
Codex: codex -C [dir] --full-auto exec "..." --skip-git-repo-check -s danger-full-access
Codex with Resume: codex exec "..." resume --last --skip-git-repo-check -s danger-full-access
Image Support: codex -C [dir] -i image.png --full-auto exec "..."

Technical Details

Multi-Step Execution Flow:

Input → Parse (Description/Task ID) → Decompose into Subtasks → TodoWrite Tracking →
For Each Subtask:
  1. Execute with Codex (first: exec, subsequent: exec resume --last)
  2. [Optional] Git verification
  3. Mark complete in TodoWrite
→ Final Summary

Subtask Decomposition Criteria:

Each subtask: 5-15 minutes completable
Clear, testable outcomes
Explicit dependencies
Focused file scope (1-5 files per subtask)

Error Handling:

Subtask failure: Pause for user intervention
Git verification failure: Request user decision
Codex session lost: Attempt retry with fresh session

Integration Features:

Automatic task ID detection (e.g., IMPL-001, TASK-123)
JSON task loading from .task/[ID].json
Execution logging to .chat/codex-execute-[timestamp].md
Summary generation to .summaries/[TASK-ID]-summary.md

Benefits

Developer Experience:

🚀 Automated task breakdown reduces planning overhead
📊 Clear progress tracking with TodoWrite integration
🔄 Context continuity improves code consistency
✅ Optional Git verification ensures code quality
🎯 Focused subtask execution reduces complexity

Code Quality:

🧪 Incremental testing after each subtask
🔍 Git verification catches unexpected changes
📝 Comprehensive execution logs for audit trail
🎨 Image attachment support for UI/design tasks

Documentation:

📚 Reduced documentation redundancy by ~60%
🔗 Clear references to master documentation
✨ Consistent command structure across all CLI tools
📖 Better separation of concerns (strategy vs. command docs)

[3.2.3] - 2025-10-03

✨ Version Management System

This release introduces a comprehensive version management and upgrade notification system.

Added

New Command: /version:

Purpose: Display version information and check for updates from GitHub
Features:
- Shows local and global installation versions
- Fetches latest stable release from GitHub API
- Displays latest development commit from main branch
- Compares installed versions with remote versions
- Provides upgrade recommendations with installation commands
- Supports both stable and development version tracking

Version Information Display:

Local Version: Shows project-specific installation (if exists)
Global Version: Shows ~/.claude installation with tracking mode
Latest Stable: Displays latest release tag, name, and publish date
Latest Dev: Shows latest commit hash, message, and date
Status Assessment: Automatic version comparison and upgrade suggestions

Version Tracking Files:

.claude/version.json: Local project version tracking
~/.claude/version.json: Global installation version tracking
Fields:
- version: Version number or "latest" for main branch tracking
- installation_mode: "Local" or "Global"
- installation_path: Installation directory
- source_branch: Source branch (usually "main")
- installation_date_utc: ISO 8601 timestamp

GitHub API Integration:

Latest Release: https://api.github.com/repos/catlog22/Claude-Code-Workflow/releases/latest
- Extracts: tag_name, name, published_at
Latest Commit: https://api.github.com/repos/catlog22/Claude-Code-Workflow/commits/main
- Extracts: sha, commit.message, commit.author.date
Timeout: 30-second timeout for slow connections
Error Handling: Graceful fallback for network errors

Command Output Scenarios:

Up to date:

✅ You are on the latest stable version (3.2.3)

Upgrade available:

⬆️ A newer stable version is available: v3.2.3
Your version: 3.2.2

To upgrade:
PowerShell: iex (iwr -useb https://raw.githubusercontent.com/catlog22/Claude-Code-Workflow/main/install-remote.ps1)
Bash: bash <(curl -fsSL https://raw.githubusercontent.com/catlog22/Claude-Code-Workflow/main/install-remote.sh)

Development version:

✨ You are running a development version (3.3.0-dev)
This is newer than the latest stable release (v3.2.3)

Changed

Documentation Updates:

Added /version command reference to README.md
Added version management documentation to README_CN.md
Created comprehensive .claude/commands/version.md implementation guide
Updated command tables with version management examples

Installation Scripts Enhancement:

Installation scripts now create version.json files automatically
Track installation mode (local vs global)
Record installation timestamp
Support version tracking for both stable and development installations

Technical Details

Implementation:

Uses simple bash commands (no jq dependency required)
Fallback to grep/sed for JSON parsing
Network calls with curl and error suppression
Version comparison using sort -V for semantic versioning
Cross-platform compatible (Windows Git Bash, Linux, macOS)

Command Structure:

/version                    # Display version and check for updates

No parameters required - command automatically:

Checks local version file (./.claude/version.json)
Checks global version file (~/.claude/version.json)
Fetches latest release from GitHub
Fetches latest commit from main branch
Compares versions and provides recommendations

Benefits

User Experience:

🔍 Quick version check with single command
📊 Comprehensive version information display
🔄 Automatic upgrade notifications
📈 Development version tracking support
🌐 GitHub API integration for latest updates

DevOps:

📁 Version tracking in both local and global installations
🕐 Installation timestamp for audit trails
🔀 Support for both stable and development branches
⚡ Fast execution with 30-second network timeout
🛡️ Graceful error handling for offline scenarios

[3.2.0] - 2025-10-02

🔄 Test-Fix Workflow & Agent Architecture Simplification

This release simplifies the agent architecture and introduces an automated test-fix workflow based on the principle "Tests Are the Review".

Added

New Agent: test-fix-agent:

Purpose: Execute tests, diagnose failures, and fix code until all tests pass
Philosophy: When all tests pass, code is automatically approved (no separate review needed)
Responsibilities:
- Execute complete test suite for implemented modules
- Parse test output and identify failures
- Diagnose root cause of test failures
- Modify source code to fix issues
- Re-run tests to verify fixes
- Certify code approval when all tests pass

Enhanced test-gen Command:

Transforms from planning tool to workflow orchestrator
Auto-generates TEST-FIX tasks for test-fix-agent
Automatically executes test validation via /workflow:execute
Eliminates manual planning document generation

New Task Types:

test-gen: Test generation tasks (handled by @code-developer)
test-fix: Test execution and fixing tasks (handled by @test-fix-agent)

Changed

Agent Architecture Simplification:

Removed: @code-review-agent and @code-review-test-agent
- Testing now serves as the quality gate
- Passing tests = approved code
Enhanced: @code-developer now writes implementation + tests together
- Unified generative work (code + tests)
- Maintains context continuity
Added: @general-purpose for optional manual reviews
- Used only when explicitly requested
- Handles special cases and edge scenarios

Task Type Updates:

"test" → "test-gen" (clearer distinction from test-fix)
Agent mapping updated across all commands:
- feature|bugfix|refactor|test-gen → @code-developer
- test-fix → @test-fix-agent
- review → @general-purpose (optional)

Workflow Changes:

Old: code-developer → test-agent → code-review-agent
New: code-developer (code+tests) → test-fix-agent (execute+fix) → ✅ approved

Removed

@code-review-agent - Testing serves as quality gate
@code-review-test-agent - Functionality split between code-developer and test-fix-agent
Separate review step - Tests passing = code approved

[3.1.0] - 2025-10-02

🧪 TDD Workflow Support

This release introduces comprehensive Test-Driven Development (TDD) workflow support with Red-Green-Refactor cycle enforcement.

Added

TDD Workflow Commands:

/workflow:tdd-plan: 5-phase TDD planning orchestrator
- Creates structured TDD workflow with TEST → IMPL → REFACTOR task chains
- Enforces Red-Green-Refactor methodology through task dependencies
- Supports both manual and agent modes (--agent flag)
- Validates TDD structure (chains, dependencies, meta fields)
- Outputs: TDD_PLAN.md, IMPL_PLAN.md, TODO_LIST.md
/workflow:tdd-verify: 4-phase TDD compliance verification
- Validates task chain structure (TEST-N.M → IMPL-N.M → REFACTOR-N.M)
- Analyzes test coverage metrics (line, branch, function coverage)
- Verifies Red-Green-Refactor cycle execution
- Generates comprehensive compliance report with scoring (0-100)
- Outputs: TDD_COMPLIANCE_REPORT.md

TDD Tool Commands:

/workflow:tools:task-generate-tdd: TDD task chain generator
- Uses Gemini AI to analyze requirements and create TDD breakdowns
- Generates TEST, IMPL, REFACTOR tasks with proper dependencies
- Creates task JSONs with meta.tdd_phase field ("red"/"green"/"refactor")
- Assigns specialized agents (@code-review-test-agent, @code-developer)
- Maximum 10 features (30 total tasks) per workflow
/workflow:tools:tdd-coverage-analysis: Test coverage and cycle analysis
- Extracts test files from TEST tasks
- Runs test suite with coverage (supports npm, pytest, cargo, go test)
- Parses coverage metrics (line, branch, function)
- Verifies TDD cycle execution through task summaries
- Outputs: test-results.json, coverage-report.json, tdd-cycle-report.md

TDD Architecture:

Task ID Format: TEST-N.M, IMPL-N.M, REFACTOR-N.M
- N = feature number (1-10)
- M = sub-task number (1-N)
Dependency System:
- IMPL-N.M depends on TEST-N.M
- REFACTOR-N.M depends on IMPL-N.M
- Enforces execution order: Red → Green → Refactor
Meta Fields:
- meta.tdd_phase: "red" | "green" | "refactor"
- meta.agent: "@code-review-test-agent" | "@code-developer"

Compliance Scoring:

Base Score: 100 points
Deductions:
- Missing TEST task: -30 points per feature
- Missing IMPL task: -30 points per feature
- Missing REFACTOR task: -10 points per feature
- Wrong dependency: -15 points per error
- Wrong agent: -5 points per error
- Wrong tdd_phase: -5 points per error
- Test didn't fail initially: -10 points per feature
- Tests didn't pass after IMPL: -20 points per feature
- Tests broke during REFACTOR: -15 points per feature

Changed

Documentation Updates:

Updated README.md with TDD workflow section
Added TDD Quick Start guide
Updated command reference with TDD commands
Version badge updated to v3.1.0

Integration:

TDD commands work alongside standard workflow commands
Compatible with /workflow:execute, /workflow:status, /workflow:resume
Uses same session management and artifact system

Benefits

TDD Best Practices:

✅ Enforced test-first development through task dependencies
✅ Automated Red-Green-Refactor cycle verification
✅ Comprehensive test coverage analysis
✅ Quality scoring and compliance reporting
✅ AI-powered task breakdown with TDD focus

Developer Experience:

🚀 Quick TDD workflow creation with single command
📊 Detailed compliance reports with actionable recommendations
🔄 Seamless integration with existing workflow system
🧪 Multi-framework test support (Jest, Pytest, Cargo, Go)

[3.0.1] - 2025-10-01

🔧 Command Updates

Changed

Brainstorming Roles: Removed test-strategist and user-researcher roles
- test-strategist functionality integrated into automated test generation (/workflow:test-gen)
- user-researcher functionality consolidated into ux-expert role
Available Roles: Updated to 8 core roles for focused, efficient brainstorming
- 🏗️ System Architect
- 🗄️ Data Architect
- 🎓 Subject Matter Expert
- 📊 Product Manager
- 📋 Product Owner
- 🏃 Scrum Master
- 🎨 UI Designer
- 💫 UX Expert

📚 Documentation

Improved

README Optimization: Streamlined README.md and README_CN.md by 81% (from ~750 lines to ~140 lines)
Better Structure: Reorganized content with clearer sections and improved navigation
Quick Start Guide: Added immediate usability guide for new users
Simplified Command Reference: Consolidated command tables for easier reference
Maintained Essential Information: Preserved all installation steps, badges, links, and critical functionality

Benefits

Faster Onboarding: New users can get started in minutes with the Quick Start section
Reduced Cognitive Load: Less verbose documentation with focused, actionable information
Consistent Bilingual Structure: English and Chinese versions now have identical organization
Professional Presentation: Cleaner, more modern documentation format

[3.0.0] - 2025-09-30

🚀 Major Release - Unified CLI Command Structure

This is a breaking change release introducing a unified CLI command structure.

Added

Unified CLI Commands: New /cli:* command set consolidating all tool interactions
Tool Selection Flag: Use --tool <gemini|qwen|codex> to select AI tools
Command Verification: Comprehensive workflow guide and command validation
MCP Tools Integration (Experimental): Enhanced codebase analysis through Model Context Protocol

Changed

BREAKING: Tool-specific commands (/gemini:*, /qwen:*, /codex:*) deprecated
Command Structure: All CLI commands now use unified /cli:* prefix
Default Tool: Commands default to gemini when --tool flag not specified

Migration

Old Command (v2)	New Command (v3.0.0)
`/gemini:analyze "..."`	`/cli:analyze "..."`
`/qwen:analyze "..."`	`/cli:analyze "..." --tool qwen`
`/codex:chat "..."`	`/cli:chat "..." --tool codex`

[2.0.0] - 2025-09-28

🚀 Major Release - Architectural Evolution

This is a breaking change release with significant architectural improvements and new capabilities.

Added

🏗️ Four-Layer Architecture

Interface Layer: CLI Commands with Gemini/Codex/Qwen Wrappers
Session Layer: Atomic session management with .active-[session] markers
Task/Data Layer: JSON-first model with .task/impl-*.json hierarchy
Orchestration Layer: Multi-agent coordination and dependency resolution

🔄 Enhanced Workflow Lifecycle

6-Phase Development Process: Brainstorm → Plan → Verify → Execute → Test → Review
Quality Gates: Validation at each phase transition
Multi-perspective Planning: Role-based brainstorming with synthesis

🧪 Automated Test Generation

Implementation Analysis: Scans completed IMPL-* tasks
Multi-layered Testing: Unit, Integration, E2E, Performance, Security
Specialized Agents: Dedicated test agents for different test types
Dependency Mapping: Test execution follows implementation chains

✅ Plan Verification System

Dual-Engine Validation: Gemini (strategic) + Codex (technical) analysis
Cross-Validation: Conflict detection between vision and constraints
Pre-execution Recommendations: Actionable improvement suggestions

🧠 Smart Tech Stack Detection

Intelligent Loading: Only for development and code review tasks
Multi-Language Support: TypeScript, React, Python, Java, Go, JavaScript
Performance Optimized: Skips detection for non-relevant tasks
Context-Aware Development: Applies appropriate tech stack principles

🔮 Qwen CLI Integration

Architecture Analysis: System design patterns and code quality
Code Generation: Implementation scaffolding and components
Intelligent Modes: Auto template selection and precise planning
Full Command Suite: analyze, chat, execute, mode:auto, mode:bug-index, mode:plan

🏷️ Issue Management Commands

/workflow:issue:create - Create new project issues with priority/type
/workflow:issue:list - List and filter issues by status/assignment
/workflow:issue:update - Update existing issue status and assignments
/workflow:issue:close - Close completed issues with resolution

📋 Enhanced Workflow Commands

/workflow:plan-verify - Pre-execution validation using dual analysis
/workflow:test-gen - Generate comprehensive test workflows
/workflow:brainstorm:artifacts - Generate structured planning documents
/workflow:plan-deep - Deep technical planning with Gemini analysis

🔧 Technical Improvements

Enhanced Scripts: Improved gemini-wrapper and qwen-wrapper
Cross-Platform: Windows path compatibility with proper quoting
Directory Navigation: Intelligent context optimization
Flow Control: Sequential execution with context accumulation
Agent Enhancements: Smart context assessment and error handling

Changed

📚 Documentation Overhaul

README.md: Updated to v2.0 with four-layer architecture
README_CN.md: Chinese documentation aligned with v2.0 features
Unified Structure: Consistent sections across language versions
Command Standardization: Unified syntax and naming conventions

🔄 Command Syntax Updates

Session Commands: /workflow:session list → /workflow:session:list
File Naming: Standardized to lowercase .task/impl-*.json
Session Markers: Unified format .active-[session]

🏗️ Architecture Improvements

JSON-First Data Model: Single source of truth for all workflow state
Atomic Session Management: Marker-based with zero-overhead switching
Task Hierarchy: Standardized structure with intelligent decomposition

Removed

⚠️ BREAKING CHANGES

Python CLI Backend: Removed all pycli references and components
Deprecated Scripts:
- install_pycli.sh
- pycli and pycli.conf
- tech-stack-loader.sh
- Legacy path reading scripts
Obsolete Documentation: Python backend references in READMEs
v1.3 Release Documentation: Removed erroneous v1.3.0 release files and tags

Fixed

🐛 Bug Fixes & Consistency

Duplicate Content: Removed duplicate "Automated Test Generation" sections
Script Entries: Fixed duplicate get_modules_by_depth.sh references
File Path Inconsistencies: Standardized case sensitivity
Command Syntax: Unified command naming across documentation
Cross-Language Alignment: Synchronized English and Chinese versions

Security

🔒 Security Enhancements

Approval Modes: Enhanced control over automatic execution
YOLO Permissions: Clear documentation of autonomous execution risks
Context Isolation: Improved session management for concurrent workflows

[Unreleased] - 2025-09-07

🎯 Command Streamlining & Workflow Optimization

Command Name Updates

RENAMED: /update_dms → /update-memory for consistency with kebab-case naming convention
Updated: All documentation and references to reflect new command name

Command Structure Optimization

REMOVED: Redundant context.md and sync.md commands (4 files total)
- task/context.md - Functionality integrated into core task commands
- task/sync.md - Replaced by automatic synchronization
- workflow/context.md - Merged into workflow session management
- workflow/sync.md - Built-in synchronization in workflow system
CONSOLIDATED: context.md created as unified context management command
Enhanced: Session status file management with automatic creation across all workflow commands

Documentation Cleanup

REMOVED: 10 legacy documentation files including:
- COMMAND_STRUCTURE_DESIGN.md
- REFACTORING_COMPLETE.md
- RELEASE_NOTES_v2.0.md
- ROADMAP.md
- TASK_EXECUTION_PLAN_SCHEMA.md
- UNIFIED_TASK_MANAGEMENT.md
- WORKFLOW_DOCUMENT_SYSTEM.md
- WORKFLOW_UPDATE_SUMMARY.md
- gemini-execute-implementation-summary.md
- test_gemini_input.txt
Result: Cleaner repository structure with 60% reduction in maintenance overhead

Migration Guides

From v1.x to v2.0

⚠️ Breaking Changes: This is a major version with breaking changes.

Update CLI Configuration:

# Required Gemini CLI settings
echo '{"contextFileName": "CLAUDE.md"}' > ~/.gemini/settings.json

Clean Legacy Components:

# Remove Python CLI references
rm -f .claude/scripts/pycli*
rm -f .claude/scripts/install_pycli.sh

Update Command Syntax:

# Old: /workflow:session list
# New: /workflow:session:list

Verify Installation:
```
/workflow:session:list
```

Configuration Requirements

Required Dependencies:

Git (version control)
Node.js (for Gemini CLI)
Python 3.8+ (for Codex CLI)
Qwen CLI (for architecture analysis)

System Requirements:

OS: Windows 10+, Ubuntu 18.04+, macOS 10.15+
Memory: 512MB minimum, 2GB recommended
Storage: ~50MB core + project data

Support & Resources

Repository: https://github.com/catlog22/Claude-Code-Workflow
Issues: https://github.com/catlog22/Claude-Code-Workflow/issues
Wiki: https://github.com/catlog22/Claude-Code-Workflow/wiki
Discussions: https://github.com/catlog22/Claude-Code-Workflow/discussions

This changelog follows Keep a Changelog format and Semantic Versioning principles.

62 KiB Raw Blame History Unescape Escape

Changelog

[4.2.1] - 2025-10-10

📝 Command Renaming & Documentation Refactoring

Changed

Improved

[4.2.0] - 2025-10-09

🎯 Multi-Page Support Enhancement

Added

Changed

[4.1.1] - 2025-10-09

🔧 Symlink Fix & Agent Optimization

Fixed

Changed

[4.1.0] - 2025-10-09

🔄 Matrix-Only UI Design Workflow

Changed

Removed

[4.0.2] - 2025-10-09

🔄 UI Design Workflow - Complete Refactoring

Breaking Changes

Removed

Changed

Added

Improved

Migration Guide

Files Changed

[4.0.1] - 2025-10-07

🎯 Intelligent Page Inference

[4.0.0] - 2025-10-07

🚀 UI Design Workflow V2 - Agent Mode & Flexible Inputs

Breaking Changes

Added

Changed

Usage Examples

Technical Details

Upgrade Benefits

[3.5.0] - 2025-10-06

🎨 UI Design Workflow with Triple Vision Analysis & Interactive Preview

Added

Changed

Benefits

Technical Details

Use Cases

[3.4.2] - 2025-10-05

📚 CLI Documentation Refactoring

Changed

Added

Technical Details

[3.4.1] - 2025-10-04

🎯 Multi-Tool Support for Documentation Updates

Added

Changed

Technical Details

[3.3.0] - 2025-10-04

🚀 CLI Tool Enhancements & Codex Multi-Step Execution

Added

Changed

Technical Details

Benefits

[3.2.3] - 2025-10-03

✨ Version Management System

Added

Changed

Technical Details

Benefits

[3.2.0] - 2025-10-02

🔄 Test-Fix Workflow & Agent Architecture Simplification

Added

Changed

Removed

[3.1.0] - 2025-10-02

🧪 TDD Workflow Support

Added

Changed

Benefits

[3.0.1] - 2025-10-01

🔧 Command Updates

Changed

📚 Documentation

62 KiB

Raw Blame History