https://github.com/brabos-ai/code-addiction
📋 The Spec-Driven Development framework. Define the what, AI handles the how.
https://github.com/brabos-ai/code-addiction
ai-coding claude-code codex copilot developer-tools engineering framework productivity spec spec-driven-development
Last synced: 8 days ago
JSON representation
📋 The Spec-Driven Development framework. Define the what, AI handles the how.
- Host: GitHub
- URL: https://github.com/brabos-ai/code-addiction
- Owner: brabos-ai
- License: mit
- Created: 2026-03-02T14:55:04.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2026-05-22T01:35:32.000Z (about 1 month ago)
- Last Synced: 2026-05-22T08:52:45.130Z (about 1 month ago)
- Topics: ai-coding, claude-code, codex, copilot, developer-tools, engineering, framework, productivity, spec, spec-driven-development
- Language: JavaScript
- Homepage:
- Size: 2.27 MB
- Stars: 8
- Watchers: 1
- Forks: 2
- Open Issues: 8
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Codeowners: .github/CODEOWNERS
- Security: SECURITY.md
- Support: SUPPORT.md
Awesome Lists containing this project
README
# Code Addiction (ADD)
[](https://github.com/brabos-ai/code-addiction/actions/workflows/ci.yml)
[](https://www.npmjs.com/package/codeadd)
[](./LICENSE)
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](https://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`) with `install`, `update`, `uninstall`, `doctor`, and `validate`
## Quickstart
```bash
# 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
npx codeadd plugins list
# enable a plugin (e.g., gitnexus)
npx codeadd plugins enable gitnexus
# disable a plugin
npx codeadd plugins disable gitnexus
# show installation configuration
npx codeadd config show
```
## 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/`
## Repository structure
- `cli/`: installer CLI published as `codeadd`
- `framework/`: framework payload copied into target projects by the installer
- `framwork/.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:
- [Contributing guide](./CONTRIBUTING.md)
- [Code of Conduct](./CODE_OF_CONDUCT.md)
- [Security policy](./SECURITY.md)
## Official Pages
- **Framework**: [code.brabos.ai](https://code.brabos.ai)
- **Repository**: [github.com/brabos-ai/code-addiction](https://github.com/brabos-ai/code-addiction)
- **NPM Package**: [@codeadd](https://www.npmjs.com/package/codeadd)
## Support
- Official site: [code.brabos.ai](https://code.brabos.ai)
- Open a [GitHub Issue](https://github.com/brabos-ai/code-addiction/issues)
- See [SUPPORT.md](./SUPPORT.md)