Claude-Code-Workflow/CHANGELOG.md

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.

[6.1.3] - 2025-12-09

🔧 CLI Tool Simplification

This release simplifies the ccw tool exec edit_file command for better usability.

🔄 Changed

• Simplified edit_file: Removed JSON input support, now uses parameter-based input only (--path, --old, --new)
• Removed line mode: Line operations now recommended via sed command
• Updated tool-strategy.md: Added sed as line operation alternative with usage examples

Usage

ccw tool exec edit_file --path "file.txt" --old "old text" --new "new text"

[6.1.2] - 2025-12-09

🔔 Dashboard Update Notification & Bug Fixes

✨ Added

• Version Update Notification: Dashboard now checks npm registry for updates and displays upgrade banner
• Version Check API: New /api/version-check endpoint with 1-hour cache

🐛 Fixed

• Hook Manager: Fixed button click event handling for edit/delete operations (changed e.target to e.currentTarget)

[5.9.6] - 2025-11-28

🚀 Review Cycle & Dashboard Enhancement

This release significantly enhances the code review capabilities with a new fix-dashboard, real-time progress tracking, and improved agent coordination.

✨ Added

• fix-dashboard.html: New independent dashboard for tracking fix progress with theme support (84b428b).
• Real-time Progress: The review-cycle dashboard now features real-time progress updates and advanced filtering for better visibility (f759338).
• Enhanced Export Notifications: Export notifications now include detailed usage instructions and recommended file locations (6467480).

🔄 Changed

• Dashboard Data Integration: fix-dashboard.html now consumes more JSON fields from the review-fix workflow for richer data display (b000359).
• Dashboard Generation: Optimized the generation process for the review cycle dashboard and merged JSON state files for efficiency (2cf8efe).
• Agent Schema Requirements: Added explicit JSON schema requirements to review cycle agent prompts to ensure structured output (34a9a23).
• Standardized Naming: Standardized "Execution Flow" phase naming across commands and removed redundant REVIEW-SUMMARY.md output (ef09914).

[5.9.5] - 2025-11-27

🎯 Test Cycle & Agent Behavior Refinement

This version focuses on improving the test-cycle execution with intelligent strategies and refining agent behavior for more reliable and predictable execution.

✨ Added

• Intelligent Iteration Strategies: Enhanced test-cycle-execute with smart iteration strategies for more effective testing (97b2247).
• Universal Test-Fix Agent: Introduced a universal @test-fix-agent invocation template for standardized bug fixing (32c9595).
• Agent Guidelines: Added new guidelines for the @test-fix-agent to avoid complex bash pipe chains and to enforce run_in_background=false for stability (edda988, a896176).

🔄 Changed

• Dashboard Access: Replaced file:// URLs with a local HTTP server for accessing dashboards to prevent browser security issues (75ad427).
• Agent Prompts: Prioritized syntax checks in the @test-fix-agent prompt for faster error detection (d99448f).
• CLI Execution Timeout: Increased the timeout for CLI execution to 10 minutes to handle long-running tasks (5375c99).
• Session Start: Added a non-interrupting execution guideline to the session start command to prevent accidental termination (2b80a02).

[5.9.4] - 2025-11-25

⚡ Lite-Fix Workflow & Multi-Angle Exploration

This release introduces the new lite-fix workflow for streamlined bug resolution and enhances the exploration capabilities of lite-plan.

✨ Added

• lite-fix Workflow: A new, intelligent workflow for bug diagnosis and resolution. Documented in WORKFLOW_DECISION_GUIDE (7453987, c8dd1ad).
• docs-related-cli Command: New command for CLI-related documentation (7453987).
• Session Artifacts: lite-fix workflow now creates a dedicated session folder with artifacts like diagnosis.json and fix-plan.json (0207677).
• review-session-cycle Command: A comprehensive command for multi-dimensional code analysis (93d8e79).
• review-fix Workflow: Automated workflow for reviewing fixes with an enhanced exploration schema (a6561a7).
• JSON Schemas: Added new JSON schemas for deep-dive results and dimension analysis to structure agent outputs (cd206f2).

🔄 Changed

• Exploration Context: Enhanced the multi-angle exploration context in lite-execute and lite-plan command outputs (4bd732c).
• cli-explore-agent: Simplified the agent with a prompt-driven architecture, making it more flexible (cf6a0f1).
• TodoWrite Format: Optimized the TodoWrite format with a hierarchical display across all workflow commands for better readability (152303f).
• Session Requirement: Review commands now require an active session and use a unified output directory structure (8f21266).

[5.9.3] - 2025-11-24

🛠️ Lite-Plan Optimization & Documentation Overhaul

This version marks a major overhaul of the lite-plan workflow, introducing parallel exploration, cost-aware execution, and a comprehensive documentation update.

✨ Added

• Exploration & Plan Schemas: Added exploration-json-schema.json and plan-json-schema.json to standardize task context and planning artifacts (19acaea, 247db0d).
• Cost-Aware Parallel Execution: lite-plan now supports execution_group in tasks, enabling cost-aware parallel execution of independent tasks (cde17bd, 697a646).
• Agent-Task Execution Rules: Enforced a one-agent-per-task-JSON rule to ensure reliable and traceable execution (20aa0f3).
• 50K Context Protection: Added a context threshold in lite-plan to automatically delegate large inputs to cli-explore-agent, preventing orchestrator overflow (96dd9be).

🔄 Changed

• lite-plan Refactor: The workflow was significantly refactored to support the new plan.json format, improving task structure and exploration angle assignment (247db0d).
• Complexity Assessment: lite-plan now uses an intelligent analysis from Claude to assess task complexity, simplifying the logic (964bbbf).
• Task Generation Rules: Updated task generation to allow for 2-7 structured tasks per plan, with refined grouping principles for better granularity (87d5a12).
• Documentation: Major updates to workflow initialization, task generation, and agent documentation to reflect new progressive loading strategies and path-based context loading (481a716, adbb207, 4bb4bdc).
• UI Design Templates: Consolidated workflow commands and added new UI design templates (f798dd4).

[5.8.1] - 2025-01-16

⚡ Lite-Plan Workflow & CLI Tools Enhancement

This release introduces a powerful new lightweight planning workflow with intelligent automation and optimized CLI tool usage.

✨ Added

Lite-Plan Workflow (/workflow:lite-plan):

• ✨ Interactive Lightweight Workflow - Fast, in-memory planning and execution
  • Phase 1: Task Analysis & Smart Exploration (30-90s)
    • Auto-detects when codebase context is needed
    • Optional @cli-explore-agent for code understanding
    • Force exploration with -e or --explore flag
  • Phase 2: Interactive Clarification (user-dependent)
    • Ask follow-up questions based on exploration findings
    • Gather missing information before planning
  • Phase 3: Adaptive Planning (20-60s)
    • Low complexity: Direct planning by Claude
    • Medium/High complexity: Delegate to @cli-planning-agent
  • Phase 4: Three-Dimensional Multi-Select Confirmation (user-dependent)
    • ✅ Task Approval: Allow / Modify / Cancel (with optional supplements)
    • 🔧 Execution Method: Agent / Provide Plan / CLI (Gemini/Qwen/Codex)
    • 🔍 Code Review: No / Claude / Gemini / Qwen / Codex
  • Phase 5: Live Execution & Tracking (5-120min)
    • Real-time TodoWrite progress updates
    • Parallel task execution for independent tasks
    • Optional post-execution code review
• ✨ Parallel Task Execution - Identifies independent tasks for concurrent execution
• ✨ Flexible Tool Selection - Preset with --tool flag or choose during confirmation
• ✨ No File Artifacts - All planning stays in memory for faster workflow

🔄 Changed

CLI Tools Optimization:

• 🔄 Simplified Command Syntax - Removed -m parameter requirement
  • Gemini: Auto-selects gemini-2.5-pro (default) or gemini-2.5-flash
  • Qwen: Auto-selects coder-model (default) or vision-model
  • Codex: Auto-selects gpt-5.1 (default), gpt-5.1-codex, or gpt-5.1-codex-mini
• 🔄 Improved Model Selection - Tools now auto-select best model for task
• 🔄 Updated Documentation - Clearer guidelines in intelligent-tools-strategy.md

Execution Workflow Enhancement:

• 🔄 Streamlined Phases - Simplified execution phases with lazy loading strategy
• 🔄 Enhanced Error Handling - Improved error messages and recovery options
• 🔄 Clarified Resume Mode - Better documentation for workflow resumption

CLI Explore Agent:

• 🎨 Improved Visibility - Changed color scheme from blue to yellow

📝 Documentation

Updated Files:

• 🔄 README.md / README_CN.md - Added Lite-Plan workflow usage examples
• 🔄 COMMAND_REFERENCE.md - Added /workflow:lite-plan entry
• 🔄 COMMAND_SPEC.md - Added detailed technical specification for Lite-Plan
• 🔄 intelligent-tools-strategy.md - Updated model selection guidelines

🐛 Bug Fixes

• Fixed command syntax inconsistencies in CLI tool documentation
• Improved task dependency detection for parallel execution

---

[5.5.0] - 2025-11-06

🎯 Interactive Command Guide & Enhanced Documentation

This release introduces a comprehensive command-guide skill with interactive help, enhanced command descriptions, and an organized 5-index command system for better discoverability and workflow guidance.

✨ Added

Command-Guide Skill:

• ✨ Interactive Help System - New command-guide skill activated by CCW-help and CCW-issue keywords
  • 🔍 Mode 1: Command Search - Find commands by keyword, category, or use-case
  • 🤖 Mode 2: Smart Recommendations - Context-aware next-step suggestions
  • 📖 Mode 3: Full Documentation - Detailed parameter info, examples, best practices
  • 🎓 Mode 4: Beginner Onboarding - Top 14 essential commands with learning path
  • 📝 Mode 5: Issue Reporting - Guided bug report and feature request templates

5-Index Command System:

• ✨ all-commands.json (30KB) - Complete catalog of 69 commands with full metadata
• ✨ by-category.json (33KB) - Hierarchical organization (workflow/cli/memory/task/general)
• ✨ by-use-case.json (32KB) - Grouped by 10 usage scenarios
• ✨ essential-commands.json (5.8KB) - Top 14 most-used commands for quick reference
• ✨ command-relationships.json (13KB) - Workflow guidance with next-steps and dependencies

Issue Templates:

• ✨ Bug Report Template - Standardized bug reporting with environment info
• ✨ Feature Request Template - Structured feature proposals with use cases
• ✨ Question Template - Help request format for user support

🔄 Changed

Command Descriptions Enhanced (69 files):

• 🔄 Detailed Functionality - All command descriptions updated from basic to comprehensive
  • Includes tools used (Gemini/Qwen/Codex)
  • Specifies agents invoked
  • Lists workflow phases
  • Documents output files
  • Mentions key flags and modes
• 🔄 Example Updates:
  • workflow:plan: "5-phase planning workflow with Gemini analysis and action-planning-agent task generation, outputs IMPL_PLAN.md and task JSONs with optional CLI auto-execution"
  • cli:execute: "Autonomous code implementation with YOLO auto-approval using Gemini/Qwen/Codex, supports task ID or description input with automatic file pattern detection"
  • memory:update-related: "Update CLAUDE.md for git-changed modules using batched agent execution (4 modules/agent) with gemini→qwen→codex fallback"

Index Organization:

• 🔄 Use-Case Categories Expanded - From 2 to 10 distinct scenarios
  • session-management, implementation, documentation, planning, ui-design, testing, brainstorming, analysis, monitoring, utilities
• 🔄 Command Relationships Comprehensive - All 69 commands mapped with:
  • calls_internally - Commands auto-invoked (built-in)
  • next_steps - User-executed next commands (sequential)
  • prerequisites - Commands to run before
  • alternatives - Similar-purpose commands

Maintenance Tools:

• 🔄 analyze_commands.py - Moved to scripts/ directory
  • Auto-generates all 5 index files from command frontmatter
  • Validates JSON syntax
  • Provides statistical reports

📝 Documentation

New Files:

• ✨ guides/index-structure.md - Complete index file schema documentation
• ✨ guides/implementation-details.md - 5-mode implementation logic
• ✨ guides/examples.md - Usage examples for all modes
• ✨ guides/getting-started.md - 5-minute quickstart guide
• ✨ guides/workflow-patterns.md - Common workflow examples
• ✨ guides/cli-tools-guide.md - Gemini/Qwen/Codex usage
• ✨ guides/troubleshooting.md - Common issues and solutions

Updated Files:

• 🔄 README.md - Added "Need Help?" section with CCW-help/CCW-issue usage
• 🔄 README_CN.md - Chinese version of help documentation
• 🔄 SKILL.md - Optimized to 179 lines (from 412, 56.6% reduction)
  • Clear 5-mode operation structure
  • Explicit CCW-help and CCW-issue triggers
  • Progressive disclosure pattern

🎯 Benefits

User Experience:

• 📦 Easier Discovery - CCW-help provides instant command search and recommendations
• 📦 Better Guidance - Smart next-step suggestions based on workflow context
• 📦 Faster Onboarding - Essential commands list gets beginners started quickly
• 📦 Simplified Reporting - CCW-issue generates proper bug/feature templates

Developer Experience:

• ⚡ Comprehensive Metadata - All 69 commands fully documented with tools, agents, phases
• ⚡ Workflow Clarity - Command relationships show built-in vs sequential execution
• ⚡ Automated Maintenance - analyze_commands.py regenerates indexes from source
• ⚡ Quality Documentation - 7 guide files cover all aspects of the system

System Organization:

• 🏗️ Structured Indexes - 5 JSON files provide multiple access patterns
• 🏗️ Clear Relationships - Distinguish built-in calls from user workflows
• 🏗️ Scalable Architecture - Easy to add new commands with auto-indexing

---

[5.4.0] - 2025-11-06

🎯 CLI Template System Reorganization

This release introduces a comprehensive reorganization of the CLI template system with priority-based naming and enhanced error handling for Gemini models.

✨ Added

Template Priority System:

• ✨ Priority-Based Naming - All templates now use priority prefixes for better organization
  • 01-* prefix: Universal, high-frequency templates (e.g., trace-code-execution, diagnose-bug-root-cause)
  • 02-* prefix: Common specialized templates (e.g., implement-feature, analyze-code-patterns)
  • 03-* prefix: Domain-specific, less frequent templates (e.g., assess-security-risks, debug-runtime-issues)
• ✨ 19 Templates Reorganized - Complete template system restructure across 4 directories
  • analysis/ (8 templates): Code analysis, bug diagnosis, architecture review, security assessment
  • development/ (5 templates): Feature implementation, refactoring, testing, UI components
  • planning/ (5 templates): Architecture design, task breakdown, component specs, migration
  • memory/ (1 template): Module documentation
• ✨ Template Selection Guidance - Choose templates based on task needs, not sequence numbers

Error Handling Enhancement:

• ✨ Gemini 404 Fallback Strategy - Automatic model fallback for improved reliability
  • If gemini-3-pro-preview-11-2025 returns 404 error, automatically fallback to gemini-2.5-pro
  • Comprehensive error handling documentation for HTTP 429 and HTTP 404 errors
  • Added to both Model Selection and Tool Specifications sections

🔄 Changed

Template File Reorganization (19 files):

Analysis Templates:

• code-execution-tracing.txt → 01-trace-code-execution.txt
• bug-diagnosis.txt → 01-diagnose-bug-root-cause.txt (moved from development/)
• pattern.txt → 02-analyze-code-patterns.txt
• architecture.txt → 02-review-architecture.txt
• code-review.txt → 02-review-code-quality.txt (moved from review/)
• performance.txt → 03-analyze-performance.txt
• security.txt → 03-assess-security-risks.txt
• quality.txt → 03-review-quality-standards.txt

Development Templates:

• feature.txt → 02-implement-feature.txt
• refactor.txt → 02-refactor-codebase.txt
• testing.txt → 02-generate-tests.txt
• component.txt → 02-implement-component-ui.txt
• debugging.txt → 03-debug-runtime-issues.txt

Planning Templates:

• architecture-planning.txt → 01-plan-architecture-design.txt
• task-breakdown.txt → 02-breakdown-task-steps.txt
• component.txt → 02-design-component-spec.txt (moved from implementation/)
• concept-eval.txt → 03-evaluate-concept-feasibility.txt
• migration.txt → 03-plan-migration-strategy.txt

Memory Templates:

• claude-module-unified.txt → 02-document-module-structure.txt

Directory Structure Optimization:

• 🔄 Bug Diagnosis Reclassified - Moved from development/ to analysis/ (diagnostic work, not implementation)
• 🔄 Removed Redundant Directories - Eliminated implementation/ and review/ folders
• 🔄 Unified Path References - All command files now use full path format

Command File Updates (21 references across 5 files):

• cli/mode/bug-diagnosis.md - 6 template references updated
• cli/mode/code-analysis.md - 6 template references updated
• cli/mode/plan.md - 6 template references updated
• task/execute.md - 1 template reference updated
• workflow/tools/test-task-generate.md - 2 template references updated

📝 Documentation

Updated Files:

• 🔄 intelligent-tools-strategy.md - Complete template system guide with new naming convention
  • Updated Available Templates section with all new template names
  • Enhanced Task-Template Matrix with priority-based organization
  • Added Gemini error handling documentation (404 and 429)
  • Removed star symbols (⭐) - redundant with priority numbers
• ✨ command-template-update-summary.md - New file documenting all template reference changes

🎯 Benefits

Template System Improvements:

• 📦 Better Discoverability - Priority prefixes make it easy to find appropriate templates
• 📦 Clearer Organization - Templates grouped by usage frequency and specialization
• 📦 Consistent Naming - Descriptive names following [Priority]-[Action]-[Object]-[Context].txt pattern
• 📦 No Breaking Changes - All command references updated, backward compatible

Error Handling Enhancements:

• ⚡ Improved Reliability - Automatic fallback prevents workflow interruption
• ⚡ Better Documentation - Clear guidance for both HTTP 429 and 404 errors
• ⚡ User-Friendly - Transparent error handling without manual intervention

Workflow Integration:

• 🔗 All 5 command files seamlessly updated with new template paths
• 🔗 Full path references ensure clarity and maintainability
• 🔗 No user action required - all updates applied systematically

📦 Modified Files

Templates (19 renames, 2 directory removals):

• .claude/workflows/cli-templates/prompts/analysis/ - 8 templates reorganized
• .claude/workflows/cli-templates/prompts/development/ - 5 templates reorganized
• .claude/workflows/cli-templates/prompts/planning/ - 5 templates reorganized
• .claude/workflows/cli-templates/prompts/memory/ - 1 template reorganized
• Removed: implementation/, review/ directories

Commands (5 files, 21 references):

• .claude/commands/cli/mode/bug-diagnosis.md
• .claude/commands/cli/mode/code-analysis.md
• .claude/commands/cli/mode/plan.md
• .claude/commands/task/execute.md
• .claude/commands/workflow/tools/test-task-generate.md

Documentation:

• .claude/workflows/intelligent-tools-strategy.md
• .claude/workflows/command-template-update-summary.md (new)

🔗 Upgrade Notes

No User Action Required:

• All template references automatically updated
• Commands work with new template paths
• No breaking changes to existing workflows

Template Selection:

• Use priority prefix as a guide, not a requirement
• Choose templates based on your specific task needs
• Number indicates category and frequency, not usage order

Error Handling:

• Gemini 404 errors now automatically fallback to gemini-2.5-pro
• HTTP 429 errors continue with existing handling (check results existence)

---

[5.2.2] - 2025-11-03

✨ Added

/memory:skill-memory Intelligent Skip Logic:

• ✨ Smart Documentation Generation - Automatically detects existing documentation and skips regeneration
  • If docs exist AND no --regenerate flag: Skip Phase 2 (planning) and Phase 3 (generation)
  • Jump directly to Phase 4 (SKILL.md index generation) for fast SKILL updates
  • If docs exist AND --regenerate flag: Delete existing docs and regenerate from scratch
  • If no docs exist: Run full 4-phase workflow
• ✨ Phase 4 Always Executes - SKILL.md index is never skipped, always generated or updated
  • Ensures SKILL index stays synchronized with documentation structure
  • Lightweight operation suitable for frequent execution
• ✨ Skip Path Documentation - Added comprehensive TodoWrite patterns for both execution paths
  • Full Path: All 4 phases (no existing docs or --regenerate specified)
  • Skip Path: Phase 1 → Phase 4 (existing docs found, no --regenerate)
  • Auto-Continue flow diagrams for both paths

🔄 Changed

Parameter Naming Correction:

• 🔄 --regenerate Flag - Reverted --update back to --regenerate in /memory:skill-memory
  • More accurate naming: "regenerate" means delete and recreate (destructive)
  • "update" was misleading as it implied incremental update (not implemented)
  • Fixed naming consistency across all documentation and examples

Phase 1 Enhancement:

• 🔄 Step 4: Determine Execution Path - Added decision logic to Phase 1
  • Checks existing documentation count
  • Evaluates --regenerate flag presence
  • Sets SKIP_DOCS_GENERATION flag based on conditions
  • Displays appropriate skip or regeneration messages

🎯 Benefits

Performance Optimization:

• ⚡ Faster SKILL Updates - Skip documentation generation when docs already exist (~5-10x faster)
• ⚡ Always Fresh Index - SKILL.md regenerated every time to reflect current documentation structure
• ⚡ Conditional Regeneration - Explicit --regenerate flag for full documentation refresh

Workflow Efficiency:

• 🔗 Smart detection reduces unnecessary documentation regeneration
• 🔗 Clear separation between SKILL index updates and documentation generation
• 🔗 Explicit control via --regenerate flag when full refresh needed

📦 Modified Files

• .claude/commands/memory/skill-memory.md - Added skip logic, reverted parameter naming, comprehensive execution path documentation

---

[5.2.1] - 2025-11-03

🔄 Changed

/memory:load-skill-memory Command Redesign:

• 🔄 Manual Activation - Changed from automatic SKILL discovery to manual activation tool
  • User explicitly specifies SKILL name: /memory:load-skill-memory <skill_name> "intent"
  • Removed complex 3-tier matching algorithm (path/keyword/action scoring)
  • Complements automatic SKILL triggering system (use when auto-activation doesn't occur)
• 🔄 Intent-Driven Documentation Loading - Intelligently loads docs based on task description
  • Quick Understanding: "了解" → README.md (~2K)
  • Module Analysis: "分析XXX模块" → Module README+API (~5K)
  • Architecture Review: "架构" → README+ARCHITECTURE (~10K)
  • Implementation: "修改", "增强" → Module+EXAMPLES (~15K)
  • Comprehensive: "完整", "深入" → All docs (~40K)
• 🔄 Memory-Based Validation - Removed bash validation, uses conversation memory to check SKILL existence
• 🔄 Simplified Structure - Reduced from 355 lines to 132 lines (-62.8%)
  • Single representative example instead of 4 examples
  • Generic use case (OAuth authentication) instead of domain-specific examples
  • Removed verbose error handling, integration notes, and confirmation outputs

Context Search Strategy Enhancement:

• ✨ SKILL Packages First Priority - Added to Core Search Tools with highest priority
  • Fastest way to understand projects - use BEFORE Gemini analysis
  • Intelligent activation via Skill() tool with automatic discovery
  • Emphasized in Tool Selection Matrix and Quick Command Reference

Parameter Naming Consistency:

• 🔄 --update Flag - Renamed --regenerate to --update in /memory:skill-memory
  • Consistent naming convention across documentation commands
  • Updated all references and examples

🎯 Benefits

Improved SKILL Workflow:

• ⚡ Clearer Purpose - Distinction between automatic (normal) and manual (override) SKILL activation
• ⚡ Token Optimization - Loads only relevant documentation scope based on intent
• ⚡ Better Discoverability - SKILL packages now prominently featured as first-priority search tool
• ⚡ Simpler Execution - Removed unnecessary validation steps, relies on memory

[5.2.0] - 2025-11-03

🎉 New Command: /memory:skill-memory - SKILL Package Generator

This release introduces a powerful new command that automatically generates progressive-loading SKILL packages from project documentation with intelligent orchestration and path mirroring.

✅ Added

New /memory:skill-memory Command:

• ✨ 4-Phase Orchestrator - Automated workflow from documentation to SKILL package
  • Phase 1: Parse arguments and prepare environment
  • Phase 2: Call /memory:docs to plan documentation
  • Phase 3: Call /workflow:execute to generate documentation
  • Phase 4: Generate SKILL.md index with progressive loading
• ✨ Auto-Continue Mechanism - All phases run autonomously via TodoList tracking
• ✨ Path Mirroring - SKILL knowledge structure mirrors source code hierarchy
• ✨ Progressive Loading - 4-level token-budgeted documentation access
  • Level 0: Quick Start (~2K tokens) - README only
  • Level 1: Core Modules (~8K tokens) - Module READMEs
  • Level 2: Complete (~25K tokens) - All modules + Architecture
  • Level 3: Deep Dive (~40K tokens) - Everything + Examples
• ✨ Intelligent Description Generation - Auto-extracts capabilities and triggers from documentation
• ✨ Regeneration Support - --regenerate flag to force fresh documentation
• ✨ Multi-Tool Support - Supports gemini, qwen, and codex for documentation generation

Command Parameters:

/memory:skill-memory [path] [--tool <gemini|qwen|codex>] [--regenerate] [--mode <full|partial>] [--cli-execute]

Path Mirroring Strategy:

Source: my_app/src/modules/auth/
  ↓
Docs: .workflow/docs/my_app/src/modules/auth/API.md
  ↓
SKILL: .claude/skills/my_app/knowledge/src/modules/auth/API.md

4-Phase Workflow:

1. Prepare: Parse arguments, check existing docs, handle --regenerate
2. Plan: Call /memory:docs to create documentation tasks
3. Execute: Call /workflow:execute to generate documentation files
4. Index: Generate SKILL.md with progressive loading structure

SKILL Package Output:

• .claude/skills/{project_name}/SKILL.md - Index with progressive loading levels
• .claude/skills/{project_name}/knowledge/ - Mirrored documentation structure
• Automatic capability detection and trigger phrase generation

📝 Changed

Enhanced /memory:docs Command:

• 🔄 Smart Task Grouping - ≤7 documents per task (up from 5)
• 🔄 Context Sharing - Prefer grouping 2 top-level directories for shared Gemini analysis
• 🔄 Batch Processing - Reduced task count through intelligent grouping
• 🔄 Dual Execution Modes - Agent Mode (default) and CLI Mode (--cli-execute)
• 🔄 Pre-computed Analysis - Phase 2 unified analysis eliminates redundant CLI calls
• 🔄 Conflict Resolution - Automatic splitting when exceeding document limit

Documentation Workflow Improvements:

• 🔄 CLI Execute Support - Direct documentation generation via CLI tools (gemini/qwen/codex)
• 🔄 workflow-session.json - Unified session metadata storage
• 🔄 Improved Structure Quality - Enhanced documentation generation guidelines

🎯 Benefits

SKILL Package Features:

• 📦 Progressive Loading - Load only what you need (2K → 40K tokens)
• 📦 Path Mirroring - Easy navigation matching source structure
• 📦 Auto-Discovery - Intelligent capability and trigger detection
• 📦 Regeneration - Force fresh docs with single flag
• 📦 Zero Manual Steps - Fully automated 4-phase workflow

Performance Optimization:

• ⚡ Parallel Processing - Multiple directory groups execute concurrently
• ⚡ Context Sharing - Single Gemini call per task group (2 directories)
• ⚡ Efficient Analysis - One-time analysis in Phase 2, reused by all tasks
• ⚡ Predictable Sizing - ≤7 docs per task ensures reliable completion
• ⚡ Failure Isolation - Task-level failures don't block entire workflow

Workflow Integration:

• 🔗 Seamless integration with existing /memory:docs command
• 🔗 Compatible with /workflow:execute system
• 🔗 Auto-continue mechanism eliminates manual steps
• 🔗 TodoList progress tracking throughout workflow

📦 New/Modified Files

New:

• .claude/commands/memory/skill-memory.md - Complete command specification (822 lines)

Modified:

• .claude/commands/memory/docs.md - Enhanced with batch processing and smart grouping
• .claude/agents/doc-generator.md - Mode-aware execution support

🔗 Usage Examples

Basic Usage:

# Generate SKILL package for current project
/memory:skill-memory

# Specify target directory
/memory:skill-memory /path/to/project

# Force regeneration with Qwen
/memory:skill-memory --tool qwen --regenerate

# Partial mode (modules only)
/memory:skill-memory --mode partial

# CLI execution mode
/memory:skill-memory --cli-execute

Output:

✅ SKILL Package Generation Complete

Project: my_project
Documentation: .workflow/docs/my_project/ (15 files)
SKILL Index: .claude/skills/my_project/SKILL.md

Generated:
- 4 documentation tasks completed
- SKILL.md with progressive loading (4 levels)
- Module index with 8 modules

Usage:
- Load Level 0: Quick project overview (~2K tokens)
- Load Level 1: Core modules (~8K tokens)
- Load Level 2: Complete docs (~25K tokens)
- Load Level 3: Everything (~40K tokens)

---

[5.1.0] - 2025-10-27

🔄 Agent Architecture Consolidation

This release consolidates the agent architecture and enhances workflow commands for better reliability and clarity.

✅ Added

Agent System:

• ✅ Universal Executor Agent - New consolidated agent replacing general-purpose agent
• ✅ Enhanced agent specialization - Better separation of concerns across agent types

Workflow Improvements:

• ✅ Advanced context filtering - Context-gather command now supports more sophisticated validation
• ✅ Session state management - Enhanced session completion with better cleanup logic

📝 Changed

Agent Architecture:

• 🔄 Removed general-purpose agent - Consolidated into universal-executor for clarity
• 🔄 Improved agent naming - More descriptive agent names matching their specific roles

Command Enhancements:

• 🔄 /workflow:session:complete - Better state management and cleanup procedures
• 🔄 /workflow:tools:context-gather - Enhanced filtering and validation capabilities

🗂️ Maintenance

Code Organization:

• 📦 Archived legacy templates - Moved outdated prompt templates to archive folder
• 📦 Documentation cleanup - Improved consistency across workflow documentation

📦 Updated Files

• .claude/agents/universal-executor.md - New consolidated agent definition
• .claude/commands/workflow/session/complete.md - Enhanced session management
• .claude/commands/workflow/tools/context-gather.md - Improved context filtering
• .claude/workflows/cli-templates/prompts/archive/ - Legacy template archive

---

[5.0.0] - 2025-10-24

🎉 Less is More - Simplified Architecture Release

This major release embraces the "less is more" philosophy, removing external dependencies, streamlining workflows, and focusing on core functionality with standard, proven tools.

🚀 Breaking Changes

Removed Features:

• ❌ /workflow:concept-clarify - Concept enhancement feature removed for simplification
• ❌ MCP code-index dependency - Replaced with standard ripgrep and find tools
• ❌ synthesis-specification.md workflow - Replaced with direct role analysis approach

Command Changes:

• ⚠️ Memory commands renamed for consistency:
  • /update-memory-full → /memory:update-full
  • /update-memory-related → /memory:update-related

✅ Added

Standard Tool Integration:

• ✅ ripgrep (rg) - Fast content search replacing MCP code-index
• ✅ find - Native filesystem discovery for better cross-platform compatibility
• ✅ Multi-tier fallback - Graceful degradation when advanced tools unavailable

Enhanced TDD Workflow:

• ✅ Conflict resolution mechanism - Better handling of test-implementation conflicts
• ✅ Improved task generation - Enhanced phase coordination and quality gates
• ✅ Updated workflow phases - Clearer separation of concerns

Role-Based Planning:

• ✅ Direct role analysis - Simplified brainstorming focused on role documents
• ✅ Removed synthesis layer - Less abstraction, clearer intent
• ✅ Better documentation flow - From role analysis directly to action planning

📝 Changed

Documentation Updates:

• ✅ All docs updated to v5.0.0 - Consistent versioning across all files
• ✅ Removed MCP badge - No longer advertising experimental MCP features
• ✅ Clarified test workflows - Better explanation of generate → execute pattern
• ✅ Fixed command references - Corrected all memory command names
• ✅ Updated UI design notes - Clarified MCP Chrome DevTools retention for UI workflows

File Discovery:

• ✅ /memory:load - Now uses ripgrep/find instead of MCP code-index
• ✅ Faster search - Native tools provide better performance
• ✅ Better reliability - No external service dependencies

UI Design Workflows:

• ℹ️ MCP Chrome DevTools retained - Specialized tool for browser automation
• ℹ️ Multi-tier fallback - MCP → Playwright → Chrome → Manual
• ℹ️ Purpose-built integration - UI workflows require browser control

🐛 Fixed

Documentation Inconsistencies:

• 🔧 Removed references to deprecated /workflow:concept-clarify command
• 🔧 Fixed incorrect memory command names in getting started guides
• 🔧 Clarified test workflow execution patterns
• 🔧 Updated MCP dependency references throughout specs
• 🔧 Corrected UI design tool descriptions

📦 Updated Files

• README.md / README_CN.md - v5.0 version badge and core improvements
• COMMAND_REFERENCE.md - Updated command descriptions, removed deprecated commands
• COMMAND_SPEC.md - v5.0 technical specifications, clarified implementations
• GETTING_STARTED.md / GETTING_STARTED_CN.md - v5.0 features, fixed command names
• INSTALL_CN.md - v5.0 simplified installation notes

🔍 Technical Details

Performance Improvements:

• Faster file discovery using native ripgrep
• Reduced external dependencies improves installation reliability
• Better cross-platform compatibility with standard Unix tools

Architectural Benefits:

• Simpler dependency tree
• Easier troubleshooting with standard tools
• More predictable behavior without external services

Migration Notes:

• Update memory command usage (see command changes above)
• Remove any usage of /workflow:concept-clarify
• No changes needed for core workflow commands (/workflow:plan, /workflow:execute)

---