{"id":31784770,"url":"https://github.com/devondragon/ccmagic","last_synced_at":"2026-03-06T23:07:29.420Z","repository":{"id":309639309,"uuid":"1035701548","full_name":"devondragon/ccmagic","owner":"devondragon","description":"Claude Code Enablement Framework","archived":false,"fork":false,"pushed_at":"2026-02-23T16:46:30.000Z","size":345,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-02-24T00:31:04.164Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/devondragon.png","metadata":{"files":{"readme":"README.markdown","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-08-11T00:34:26.000Z","updated_at":"2026-02-23T16:46:42.000Z","dependencies_parsed_at":"2025-08-13T02:42:23.907Z","dependency_job_id":"a2701127-9d1b-45c6-abb7-cac150bdeb01","html_url":"https://github.com/devondragon/ccmagic","commit_stats":null,"previous_names":["devondragon/ccmagic"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/devondragon/ccmagic","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devondragon%2Fccmagic","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devondragon%2Fccmagic/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devondragon%2Fccmagic/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devondragon%2Fccmagic/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/devondragon","download_url":"https://codeload.github.com/devondragon/ccmagic/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devondragon%2Fccmagic/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30202535,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-06T19:07:06.838Z","status":"ssl_error","status_checked_at":"2026-03-06T18:57:34.882Z","response_time":250,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-10-10T11:20:02.754Z","updated_at":"2026-03-06T23:07:29.394Z","avatar_url":"https://github.com/devondragon.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# ccmagic - Advanced Project Management Commands for Claude Code\n\nA powerful collection of custom slash commands that transform Claude Code into a comprehensive project management system. Maintain organized context, track work progress, manage features and tasks, and enable seamless handoffs between development sessions.\n\n**Now with Claude Code's latest features**: Parallel subagents, real-time TodoWrite integration, and optional MCP tool enhancements.\n\n## 🚀 Quick Start\n\n### Installation\n\n#### Option 1: Global Installation (User-wide)\n\n1. Navigate to your Claude commands directory:\n   ```bash\n   cd ~/.claude/commands/\n   ```\n\n2. Clone the ccmagic repository:\n   ```bash\n   git clone https://github.com/devondragon/ccmagic.git\n   ```\n\n3. Start using commands with the `/ccmagic:` prefix in Claude Code!\n\n#### Option 2: Project-local Installation\n\nFor team projects or when you want CCMagic versioned with your codebase:\n\n**Using Git Submodule (Recommended for version control):**\n```bash\n# From your project root\ngit submodule add https://github.com/devondragon/ccmagic.git .claude/commands/ccmagic\ngit commit -m \"Add CCMagic as submodule\"\n\n# Team members can initialize after cloning\ngit submodule update --init --recursive\n```\n\n**Using Direct Copy (Simpler, no submodule complexity - but no updates):**\n```bash\n# From your project root\nmkdir -p .claude/commands\n\n# Download and extract (using curl)\ncurl -L https://github.com/devondragon/ccmagic/archive/main.tar.gz | \\\n  tar -xz -C .claude/commands --strip-components=1\n\n# Or using wget\nwget -qO- https://github.com/devondragon/ccmagic/archive/main.tar.gz | \\\n  tar -xz -C .claude/commands --strip-components=1\n\n# Optional: Track commands in your project's git\ngit add .claude/commands/\ngit commit -m \"Add CCMagic commands to project\"\n\n# Or ignore them if you prefer team members to install separately\necho \".claude/commands/\" \u003e\u003e .gitignore\n```\n\n**Note:** Project-local commands take precedence over global commands. This allows teams to:\n- Pin specific CCMagic versions per project\n- Customize commands for project needs\n- Ensure all team members use the same command versions\n\n### Your First Command\n\nInitialize a new project with the CCMagic context system:\n```\n/ccmagic:init           # Full setup with epics, features, knowledge base\n/ccmagic:init --light   # Minimal setup for simple projects\n```\n\nThis creates a project management structure in your repository's `context/` directory.\n\n## 📋 Available Commands\n\n### Project Setup \u0026 Planning\n| Command               | Description                                        | Example                      |\n| --------------------- | -------------------------------------------------- | ---------------------------- |\n| `/ccmagic:init`       | Initialize CCMagic context (`--light` for minimal) | `/ccmagic:init --light`      |\n| `/ccmagic:plan`       | Interactive planning with EnterPlanMode support    | `/ccmagic:plan saas-app`     |\n| `/ccmagic:quick-start`| Fast-track feature setup                           | `/ccmagic:quick-start auth`  |\n| `/ccmagic:map-codebase`| Analyze existing codebase and document patterns   | `/ccmagic:map-codebase`      |\n| `/ccmagic:settings`   | Configure CCMagic preferences                      | `/ccmagic:settings`          |\n| `/ccmagic:help`       | Get help with CCMagic commands                     | `/ccmagic:help`              |\n| `/ccmagic:doctor`     | Diagnose setup issues and validate installation    | `/ccmagic:doctor`            |\n\n### Task Management\n| Command                    | Description                                | Example                             |\n| -------------------------- | ------------------------------------------ | ----------------------------------- |\n| `/ccmagic:create-features` | Create new features for an epic            | `/ccmagic:create-features epic-001` |\n| `/ccmagic:discuss-feature` | Gather implementation context before tasks | `/ccmagic:discuss-feature`          |\n| `/ccmagic:create-tasks`    | Break down features into tasks             | `/ccmagic:create-tasks`             |\n| `/ccmagic:start-task`      | Start working on a specific task           | `/ccmagic:start-task 001-01-003`    |\n| `/ccmagic:current-task`    | View current active task                   | `/ccmagic:current-task`             |\n| `/ccmagic:complete-task`   | Mark task as completed                     | `/ccmagic:complete-task 001-01-003` |\n| `/ccmagic:verify`          | Interactive verification of acceptance criteria | `/ccmagic:verify`              |\n| `/ccmagic:checkpoint`      | Save current progress                      | `/ccmagic:checkpoint`               |\n\n### Features \u0026 Epics\n| Command                    | Description                        | Example                          |\n| -------------------------- | ---------------------------------- | -------------------------------- |\n| `/ccmagic:current-feature` | View current feature status        | `/ccmagic:current-feature`       |\n| `/ccmagic:create-spike`    | Create research/investigation task | `/ccmagic:create-spike`          |\n| `/ccmagic:start-spike`     | Begin working on a spike           | `/ccmagic:start-spike spike-001` |\n\n### Project Status \u0026 Documentation\n| Command                  | Description                              | Example                            |\n| ------------------------ | ---------------------------------------- | ---------------------------------- |\n| `/ccmagic:status`        | Quick project status check (uses haiku)  | `/ccmagic:status`                  |\n| `/ccmagic:progress`      | Check progress and route to next action  | `/ccmagic:progress`                |\n| `/ccmagic:daily-standup` | Generate standup report from git history | `/ccmagic:daily-standup`           |\n| `/ccmagic:handoff`       | Create detailed handoff notes            | `/ccmagic:handoff`                 |\n| `/ccmagic:add-backlog`   | Add items to project backlog             | `/ccmagic:add-backlog`             |\n| `/ccmagic:blockers`      | Surface and track blockers               | `/ccmagic:blockers`                |\n| `/ccmagic:research`      | Deep iterative research with sources     | `/ccmagic:research JWT vs sessions`|\n\n### Context Management\n| Command                 | Description                         | Example                 |\n| ----------------------- | ----------------------------------- | ----------------------- |\n| `/ccmagic:context-save` | Save current context state          | `/ccmagic:context-save` |\n| `/ccmagic:context-load` | Load saved context state            | `/ccmagic:context-load` |\n| `/ccmagic:resume`       | Resume work from previous session   | `/ccmagic:resume`       |\n\n### Development Workflow\n| Command                  | Description                                   | Example                            |\n| ------------------------ | --------------------------------------------- | ---------------------------------- |\n| `/ccmagic:quick`         | Execute ad-hoc task without feature overhead  | `/ccmagic:quick fix typo in login` |\n| `/ccmagic:test`          | Run project tests                             | `/ccmagic:test`                    |\n| `/ccmagic:validate`      | Validate code (parallel checks)               | `/ccmagic:validate`                |\n| `/ccmagic:review`        | Code review with parallel exploration         | `/ccmagic:review`                  |\n| `/ccmagic:codex-review`  | Codex CLI review + Claude triage and fix plan | `/ccmagic:codex-review branch`     |\n| `/ccmagic:debug`         | Systematic debugging with persistent state    | `/ccmagic:debug login issue`       |\n| `/ccmagic:analyze-impact`| Analyze dependencies and blast radius         | `/ccmagic:analyze-impact src/auth` |\n\n### Git Integration\n| Command              | Description                                      | Example              |\n| -------------------- | ------------------------------------------------ | -------------------- |\n| `/ccmagic:push`      | Smart commit (logical groups) and push           | `/ccmagic:push`      |\n| `/ccmagic:pr`        | Create pull request                              | `/ccmagic:pr`        |\n| `/ccmagic:pr-feedback`| Review PR comments and plan fixes               | `/ccmagic:pr-feedback`|\n| `/ccmagic:merge`     | Merge changes                                    | `/ccmagic:merge`     |\n| `/ccmagic:sync`      | Sync with remote repository                      | `/ccmagic:sync`      |\n\n## ⚡ Claude Code Integration\n\nCCMagic leverages Claude Code's latest features for maximum efficiency:\n\n### Parallel Subagents\nCommands like `/review` and `/analyze-impact` use the **Task tool with Explore agents** to analyze code in parallel:\n```\n# /review launches 3 parallel agents:\nAgent 1: Code quality analysis\nAgent 2: Security \u0026 performance review\nAgent 3: Architecture \u0026 integration check\n```\n\n### Real-time Progress with TodoWrite\nCommands populate Claude Code's native todo UI for visibility:\n- `/start-task` creates checklist from acceptance criteria\n- `/plan` shows next steps after planning\n- Progress updates in real-time as you work\n\n### Parallel Execution\nCommands like `/validate` run independent checks simultaneously:\n```\n# These run IN PARALLEL (single message, multiple Bash calls):\n- Linting\n- Type checking\n- Format checking\n- Security scanning\n\n# Then SEQUENTIAL (depends on above):\n- Tests\n- Build\n```\n\n### Model Tiering\nCommands use appropriate models for their complexity:\n- **haiku**: Fast operations (`/status`, `/daily-standup`, `/blockers`)\n- **sonnet**: Standard operations (`/review`, `/validate`, `/start-task`)\n- **opus**: Complex reasoning (`/plan`, `/create-features`, `/create-tasks`, `/research`)\n\n### Optional MCP Tool Integration\nCommands integrate with external MCP tools when available, with graceful fallback:\n\n| Tool | Purpose | Fallback |\n|------|---------|----------|\n| `mcp__pal__codereview` | Expert code review | Explore agents |\n| `mcp__pal__analyze` | Deep analysis | Standard analysis |\n| `mcp__pal__planner` | Planning assistance | Task tool with Plan agent |\n\n**All commands work fully without MCP tools** - they're optional enhancements.\n\n### Optional CLI Tool Integration\nSome commands integrate with external CLI tools for enhanced capabilities:\n\n| Tool | Command | Purpose | Fallback |\n|------|---------|---------|----------|\n| Codex CLI | `/ccmagic:codex-review` | OpenAI's Codex for code review | `/ccmagic:review` |\n\nInstall Codex with `npm install -g @openai/codex`. Commands gracefully fall back when tools aren't installed.\n\n## 🏗️ CCMagic Context System\n\nCCMagic creates a hierarchical project organization that scales from simple to complex projects:\n\n### Directory Structure\n```\nyour-project/\n├── context/                     # All project context\n│   ├── project.md              # Project overview \u0026 tech stack\n│   ├── conventions.md          # Coding standards\n│   ├── working-state.md       # Current status\n│   ├── backlog.md             # Ideas \u0026 tech debt\n│   ├── epics/                 # Major initiatives\n│   │   └── epic-001-mvp.md\n│   ├── features/              # Feature implementations\n│   │   └── epic-001-f01-core/\n│   │       ├── overview.md\n│   │       ├── working-state.md\n│   │       └── tasks/\n│   │           ├── todo/\n│   │           ├── current/\n│   │           └── completed/\n│   ├── spikes/                # Research tasks\n│   │   ├── todo/\n│   │   ├── current/\n│   │   └── completed/\n│   ├── knowledge/             # Technical docs \u0026 research\n│   │   ├── architecture.md\n│   │   ├── data-model.md\n│   │   ├── api-contracts.md\n│   │   └── research-*.md      # Research findings from /research\n│   └── sessions/              # Work history\n│       └── handoffs/\n└── CLAUDE.md                   # AI assistant instructions\n```\n\n### Hierarchy Explained\n\n- **Epics**: High-level feature groups (e.g., Authentication, Payments, Analytics)\n- **Features**: Specific implementations within epics (e.g., Login, Registration, Password Reset)\n- **Tasks**: Individual work items within features\n- **Spikes**: One-off research or investigation tasks\n\n### ID Convention\nTasks follow the format `XXX-YY-ZZZ-description`:\n- `XXX`: Epic number (001)\n- `YY`: Feature number (01)\n- `ZZZ`: Task number (003)\n- Example: `001-01-003-add-login-form`\n\n## 🎯 Use Cases\n\n### Solo Developer\nStart simple with minimal setup:\n```\n/ccmagic:init --light   # Minimal structure for simple projects\n/ccmagic:plan my-feature\n/ccmagic:start-task\n# Work on tasks\n/ccmagic:checkpoint\n/ccmagic:complete-task\n```\n\n### Team Collaboration\nEnable smooth handoffs and parallel work:\n```\n/ccmagic:handoff          # Developer A creates handoff\n/ccmagic:context-load     # Developer B picks up work\n/ccmagic:status           # Check team progress\n/ccmagic:review           # Code review workflow\n```\n\n### Complex Projects\nManage multiple epics and features:\n```\n/ccmagic:plan enterprise-app\n/ccmagic:create-features epic-001\n/ccmagic:create-tasks\n/ccmagic:start-task 001-02-005\n```\n\n## 💡 Best Practices\n\n### For Maximum Productivity\n\n1. **Initialize First**: Always run `/ccmagic:init` in new projects\n2. **Regular Checkpoints**: Use `/ccmagic:checkpoint` to save progress frequently\n3. **Clear Handoffs**: Create handoffs when switching contexts or developers\n4. **Update Working State**: Keep `context/working-state.md` current\n5. **Use Backlog**: Capture ideas without breaking flow with `/ccmagic:add-backlog`\n\n### Workflow Tips\n\n- Start with a single epic (`001-mvp`) and expand as needed\n- Complete one task at a time to avoid context switching\n- Use spikes for research that doesn't fit into features\n- Document decisions in working-state files\n- Review `/ccmagic:status` at the start of each session\n\n## 🛠️ Creating Custom Commands\n\nAdd new commands by creating `.md` files in the repository root:\n\n### Example Command Structure\n```markdown\n---\ndescription: Brief description of the command\nargument-hint: expected arguments\nallowed-tools: Read(*), Bash(git:*), Task(*), TodoWrite(*)\nmodel: sonnet\n---\n\n# Command Title\n\nYour command prompt here using:\n- $ARGUMENTS for dynamic values\n- Markdown for formatting\n```\n\n### Available Tools\nCommands can request access to:\n\n**Core Tools:**\n- `Write(*)` - File writing\n- `Read(*)` - File reading\n- `Bash(git:*)` - Git commands (use `Bash(*)` for all shell access)\n- `Glob(*)` - File pattern matching\n- `Grep(*)` - Content searching\n- `LS(*)` - Directory listing\n\n**Claude Code Features:**\n- `Task(*)` - Spawn subagents (Explore, Plan, general-purpose)\n- `TodoWrite(*)` - Real-time progress tracking in UI\n- `EnterPlanMode(*)` - Interactive planning workflow\n- `AskUserQuestion(*)` - Multi-choice user prompts\n\n**Optional MCP Tools (graceful fallback if unavailable):**\n- `mcp__pal__codereview(*)` - Expert code review\n- `mcp__pal__thinkdeep(*)` - Deep analysis\n- `mcp__pal__analyze(*)` - Comprehensive analysis\n\n### Model Selection\nChoose appropriate models in frontmatter (aliases auto-update to latest versions):\n```yaml\nmodel: haiku   # Fast, simple operations\nmodel: sonnet  # Standard operations (default)\nmodel: opus    # Complex reasoning\n```\n\n### Parallel Execution Pattern\nFor commands that run independent operations:\n```markdown\nRun these checks IN PARALLEL using multiple Bash tool calls in a single message:\n- Check 1: [command]\n- Check 2: [command]\n- Check 3: [command]\n```\n\n## 📚 Documentation\n\nDetailed documentation available in the `/docs` directory:\n- [Getting Started Guide](docs/getting-started.markdown)\n- [Team Collaboration Guide](docs/claude-code-team-guide.markdown)\n- [Claude Code Quickstart](docs/claude-code-quickstart.markdown)\n- [Directory Structure Reference](docs/directory-structure.markdown)\n- [Context Systems Reference](docs/context-systems-reference.markdown)\n\n\n## 🤝 Contributing\n\nWe welcome contributions! To add new commands:\n\n1. Fork the repository\n2. Create a new `.md` file for your command\n3. Test thoroughly with Claude Code\n4. Update this README with your command\n5. Submit a pull request\n\n### Contribution Guidelines\n- Follow existing command patterns\n- Include comprehensive frontmatter\n- Document complex workflows\n- Test with various project types\n- Update relevant documentation\n\n## 📝 License\n\nApache 2.0 License - See [LICENSE](LICENSE) file for details\n\n## 🔗 Links\n\n- [Claude Code Documentation](https://docs.anthropic.com/en/docs/claude-code)\n- [Report Issues](https://github.com/devondragon/ccmagic/issues)\n- [Feature Requests](https://github.com/devondragon/ccmagic/discussions)\n\n## 🎉 Why CCMagic?\n\nCCMagic transforms Claude Code from a coding assistant into a complete project management system. It provides:\n\n- **Structured Organization**: Hierarchical task management that scales from solo to enterprise\n- **Context Preservation**: Never lose track of what you were working on\n- **Team Collaboration**: Smooth handoffs, blocker tracking, and clear communication\n- **Claude Code Native**: Uses subagents, TodoWrite, and parallel execution for efficiency\n- **Flexible Setup**: Light mode for simple projects, full mode for complex ones\n- **Optional Enhancements**: PAL MCP tools enhance when available, graceful fallback otherwise\n- **Real-time Visibility**: TodoWrite integration shows progress in Claude Code's UI\n\nStart using CCMagic today and experience a new level of development productivity with Claude Code!\n\n---\n\n*Built by developers, for developers who want to maintain their sanity while building amazing things.*\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevondragon%2Fccmagic","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdevondragon%2Fccmagic","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevondragon%2Fccmagic/lists"}