6adbe7c1e9
## Major Changes ### Parameter Flexibility - Changed `<skill_name>` from Required to Optional `[skill_name]` - Updated argument-hint: `[skill_name] "task intent description"` - Description: "Activate SKILL package (auto-detect or manual)" ### Auto-Detection Strategy (New Feature) Added Step 1: Determine SKILL Name (if not provided) 1. **Path Extraction**: Scan task for file paths, extract project names - Example: `"D:\projects\my_project\src\auth.py"` → extracts `my_project` 2. **Keyword Matching**: Match task keywords against SKILL descriptions 3. **Validation**: Check if extracted name exists in `.claude/skills/` ### Core Philosophy Update - Changed from "Manual Activation" → "Flexible Activation" - Auto-detect from task description/paths OR user explicitly specifies ### Enhanced Documentation - Parameters section: Added auto-detection explanation and path example - Task intent description: Now serves dual purpose (auto-detection + scope selection) - Updated all execution flow steps (Step 1 → Step 2 → Step 3) ### Usage Examples - **Example 1**: Manual specification (explicit skill_name) - **Example 2**: Auto-detection from path (NEW) - Shows complete auto-detection workflow - Path extraction → Validation → Activation ## Benefits - ✅ **Smarter activation**: System extracts skill name from context - ✅ **Reduced user effort**: No need to specify obvious skill names - ✅ **Backward compatible**: Manual specification still supported - ✅ **Path-aware**: Intelligent extraction from file paths in task description 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
🚀 Claude Code Workflow (CCW)
Claude Code Workflow (CCW) transforms AI development from simple prompt chaining into a robust, context-first orchestration system. It solves execution uncertainty and error accumulation through structured planning, deterministic execution, and intelligent multi-model orchestration.
🎉 Version 5.2: Memory Commands Enhancement
Core Improvements:
- ✅ Batch Processing - Single Level 1 task handles all module trees (67% fewer tasks)
- ✅ Dual Execution Modes - Agent Mode and CLI Mode (--cli-execute) support
- ✅ Pre-computed Analysis - Unified analysis eliminates redundant CLI calls (67% reduction)
- ✅ Performance Boost - 67% fewer file reads, 33% fewer total tasks
See CHANGELOG.md for full details.
📚 New to CCW? Check out the Getting Started Guide for a beginner-friendly 5-minute tutorial!
✨ Core Concepts
CCW is built on a set of core principles that differentiate it from traditional AI development approaches:
- Context-First Architecture: Pre-defined context gathering eliminates execution uncertainty by ensuring agents have the correct information before implementation.
- JSON-First State Management: Task states live in
.task/IMPL-*.jsonfiles as the single source of truth, enabling programmatic orchestration without state drift. - Autonomous Multi-Phase Orchestration: Commands chain specialized sub-commands and agents to automate complex workflows with zero user intervention.
- Multi-Model Strategy: Leverages the unique strengths of different AI models (Gemini for analysis, Codex for implementation) for superior results.
- Hierarchical Memory System: A 4-layer documentation system provides context at the appropriate level of abstraction, preventing information overload.
- Specialized Role-Based Agents: A suite of agents (
@code-developer,@test-fix-agent, etc.) mirrors a real software team to handle diverse tasks.
⚙️ Installation
For detailed installation instructions, please refer to the INSTALL.md guide.
🚀 Quick One-Line Installation
Windows (PowerShell):
Invoke-Expression (Invoke-WebRequest -Uri "https://raw.githubusercontent.com/catlog22/Claude-Code-Workflow/main/install-remote.ps1" -UseBasicParsing).Content
Linux/macOS (Bash/Zsh):
bash <(curl -fsSL https://raw.githubusercontent.com/catlog22/Claude-Code-Workflow/main/install-remote.sh)
✅ Verify Installation
After installation, open Claude Code and check if the workflow commands are available by running:
/workflow:session:list
If the slash commands (e.g., /workflow:*) are recognized, the installation was successful.
🛠️ Command Reference
CCW provides a rich set of commands for managing workflows, tasks, and interacting with AI tools. For a complete list and detailed descriptions of all available commands, please see the COMMAND_REFERENCE.md file.
For a detailed technical specification of every command, see the COMMAND_SPEC.md.
🚀 Getting Started
The best way to get started is to follow the 5-minute tutorial in the Getting Started Guide.
Here is a quick example of a common development workflow:
- Create a Plan (automatically starts a session):
/workflow:plan "Implement JWT-based user login and registration" - Execute the Plan:
/workflow:execute - Check Status (optional):
/workflow:status
🤝 Contributing & Support
- Repository: GitHub - Claude-Code-Workflow
- Issues: Report bugs or request features on GitHub Issues.
- Discussions: Join the Community Forum.
📄 License
This project is licensed under the MIT License. See the LICENSE file for details.