code-addiction
brabos-ai/code-addiction
📋 The Spec-Driven Development framework. Define the what, AI handles the how.
Instalação
npx convez-ai brabos-ai/code-addiction1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
README
A tradução para o português deste README ainda está na fila.
Code Addiction (ADD)
AI-powered development workflows that make you addicted to shipping code. Production-ready commands, scripts, and skills for AI coding assistants, with a single CLI installer.
Official Framework Site: code.brabos.ai — your complete development workflow guide and documentation.
Why this project exists
Most AI coding setups are fragmented across custom prompts, scripts, and editor-specific conventions.
Code Addiction standardizes this with:
- A shared core in
.codeadd/(commands, scripts, skills, templates) - Provider-specific integrations (Claude, Codex, Antigravity, KiloCode, OpenCode)
- A versioned installer (
codeadd) withinstall,update,uninstall,doctor, andvalidate
Quickstart
# install latest release
npx codeadd install
# install a specific version (e.g., v0.2.20)
npx codeadd install --version v0.2.20
# check environment health
npx codeadd doctor
# validate file integrity via SHA-256 hashes
npx codeadd validate
# repair missing or corrupted files
npx codeadd validate --repair
# update to latest release
npx codeadd update
# update to a specific version
npx codeadd update --version v0.2.14
# remove Code Addiction files from your project
npx codeadd uninstall
# list optional features
npx codeadd features list
# list available plugins (see docs for per-plugin setup)
npx codeadd plugins list
# show installation configuration
npx codeadd config show
Plugins
Plugins integrate external MCP tools into ADD commands, extending discovery, planning, and diagnosis with structural code navigation. Plugins are disabled by default — enable only after installing the external tool.
See code.brabos.ai/docs#plugins for the full plugin catalog with install prerequisites and step-by-step setup.
How it works
Code Addiction turns complex development into a guided, repeatable flow. Instead of figuring out how to build, you just follow the next command. The AI does the heavy lifting — you stay in control.
The Development Trail
Every feature follows a clear path from idea to delivery. Pick the trail that fits your task:
Step Command What happens Output
───────────────────────────────────────────────────────────────────────────────
0. Explore /add.brainstorm Brainstorm ideas (read-only) Initial concept
1. Discover /add.new AI-guided feature discovery about.md
2. Design /add.design UX spec, mobile-first UI/UX specification
3. Plan /add.plan Technical planning + checklist plan.md
4. Code /add.build Subagent-driven implementation Working code
5. Review /add.review Automated code review + validation Quality gate
6. Done /add.done Changelog, docs, finalization Ready to merge
Choose your flow
Pick the shortest path that fits. Less ceremony, same quality.
COMPLETE (complex features with UI)
brainstorm --> new --> design --> plan --> build --> review --> done
STANDARD (features without complex UI)
new --> plan --> build --> review --> done
LEAN (small changes, quick tasks)
new --> build --> done
AUTONOMOUS (full AI implementation, no interaction)
new --> autopilot --> done
EXPLORATION (don't know where to start?)
brainstorm --> new --> ...pick your flow above
EMERGENCY (critical bug in production)
hotfix --> done
TRIAGE (ambiguous symptoms, unclear path)
diagnose --> (hotfix OR new OR no-action)
NEW PROJECT (starting from scratch)
init --> build --> done
ANALYSIS (understand existing codebase)
xray / audit
That's it. No config files to tweak, no boilerplate to write, no decision fatigue. Type the command, follow the AI, ship the feature. Repeat.
Why teams get addicted
- Zero ramp-up — new devs ship on day one by following the flow
- 10x fewer decisions — the framework already made the boring ones for you
- Consistent output — every feature gets discovery, planning, review, and docs automatically
- Works with your stack — NestJS, React, any database, any provider
What gets installed
- Core:
.codeadd/ - Optional providers:
- Claude Code ->
.claude/ - Codex (OpenAI) ->
.agents/ - Google Antigravity ->
.agent/ - KiloCode ->
.kilocode/ - OpenCode ->
.opencode/
- Claude Code ->
Repository structure
cli/: installer CLI published ascodeaddframework/: framework payload copied into target projects by the installerframwork/.codeadd/plugins/: plugin asset source tree (fragments and skills per plugin)
Compatibility
- Node.js 18+
- GitHub-hosted releases for distribution
- Works on Windows, macOS, Linux (via Node runtime)
Contributing
Contributions are welcome. Start here:
Official Pages
- Framework: code.brabos.ai
- Repository: github.com/brabos-ai/code-addiction
- NPM Package: @codeadd
Support
- Official site: code.brabos.ai
- Open a GitHub Issue
- See SUPPORT.md