claw

🐾 CodeClaw

A project-agnostic task and idea management plugin for Claude Code

---

CodeClaw gives your AI-assisted development workflow a structured backbone: ideas are captured, evaluated, promoted to tasks, implemented with quality gates, and tracked to completion — all through plain-text files and Claude Code slash commands. A gated release pipeline enforces strict development rules from branch creation to production tagging.

📖 Full Documentation — Architecture, API reference, configuration, deployment, troubleshooting, and more.

✨ Features

• 🔄 Two-pipeline workflow — separate idea evaluation from task execution
• 🛠️ 9 streamlined skills — unified slash commands (/task, /idea, /release, /docs, /setup, /update, /tests, /help, /crazy)
• 🚦 Gated release pipeline — 9 sequential stages with user-confirmed gates, feedback loops, and mandatory local build verification before every push
• 🏷️ Explicit version bump gate — all manifest files are discovered, verified, and updated with user confirmation before tagging
• 🌿 Three-branch strategy — enforced develop → staging → main promotion path with mandatory staging validation
• 🐳 Docker tagging — staging builds the latest tag, production builds stable + versioned tags
• 🧩 Claude Code plugin — install via marketplace, uninstall cleanly, update easily
• 📝 Plain-text tracking — tasks and ideas live in simple .txt files, fully version-controllable
• 🔗 GitHub/GitLab Issues integration — optional tri-modal sync with GitHub or GitLab Issues
• ✅ Quality gates — verification, linting, and smoke tests run before tasks can be closed
• 💻 Cross-platform — works on Linux, macOS, and Windows with automatic OS detection
• 🌐 Project-agnostic — works with any language, framework, or tech stack
• 👤 Human-in-the-loop — AI assists, but you make every decision at every gate
• ⚡ Yolo mode — append yolo to any command to auto-confirm all gates for fully autonomous execution

🆕 What's New in v4.0.5

• 🧹 Release cleanup — 4.0.4 documentation and changelog corrections are now carried through the release line
• 🌿 Branch alignment — develop, staging, and main now share the same release history and tree
• 📝 Docs simplification — public docs and API reference no longer advertise retired legacy doc flows
• 🤖 [BETA] /crazy skill — fully autonomous end-to-end project builder
• 🎨 Frontend design wizard — template search, theme selection, color palette picker
• 🐾 Rebranded — CTDF → CodeClaw with plugin id claw

📋 Prerequisites

• Claude Code CLI installed and configured
• 🐍 Python 3.12+ (used by the bundled scripts)

📦 Installation

From Marketplace

/plugin marketplace add https://github.com/dnviti/codeclaw
/plugin install claw@dnviti-plugins

Local Development

git clone https://github.com/dnviti/codeclaw.git
claude --plugin-dir ./codeclaw

🚀 Getting Started

1. Install the plugin using one of the methods above.

2. Set up task tracking in your project:

   /setup My Project Name
   

   This creates the task/idea files (to-do.txt, progressing.txt, done.txt, ideas.txt, idea-disapproved.txt), configures the three-branch strategy, and writes project guidance to project-context.md while creating AGENTS.md.

3. Start using skills:

   /idea create Add user authentication with JWT
   /idea approve IDEA-AUTH-0001
   /task pick
   /task status
   

4. When ready to release:

   /release continue 1.0.0
   

⚙️ How It Works

CodeClaw enforces strict development rules through two connected pipelines and a gated release process.

💡 Idea Pipeline

Ideas are lightweight proposals — what and why only. They must be explicitly approved before entering the task pipeline.

flowchart LR
    A[ideas.txt] -->|/idea approve| B[to-do.txt<br>becomes a task]
    A -->|/idea disapprove| C[idea-disapproved.txt<br>archived]

📋 Task Pipeline