# AI-Driven Dev Framework
## Enterprise-grade SDLC for high-quality software development.
Unify **engineering teams** around **standardized workflows** and **shared best practices**, across modern stacks and **legacy systems**, while reducing **technical debt**.
🧱 **IDE agnostic** · 🏗️ **Legacy systems** · 🌱 **Token-optimized** · 🇫🇷 **Made in France**
9 plugins · 51 skills · 2 agents
[](https://opensource.org/) [](LICENSE) [](https://github.com/ai-driven-dev/framework/releases) [](https://github.com/ai-driven-dev/framework/actions/workflows/ci.yml)🗺️ Live roadmap
The AI-Driven Dev Framework installs a working SDLC (Software Development Life Cycle) into your AI coding tool — skills, agents, commands, rules — that turns a rough idea into a reviewed, shipped pull request:
/aidd-orchestrator:01-sdlc "add rate limiting to the /login endpoint"
→ frame when needed → plan → implement → validate → review → challenge → ship
Why not just write your own commands? → FAQ.
PATH, only for the plugin that ships hooks (what they do); the workflows themselves are markdown and need nothing.| Tool | Status | Release dist |
|---|---|---|
| Claude Code | ✅ Native · recommended | Marketplace |
| Cursor | ✅ Supported | Marketplace · Flat |
| GitHub Copilot | ✅ Supported | Marketplace · Flat |
| Codex | ✅ Supported | Marketplace · Flat |
| OpenCode | ✅ Supported | Flat |
| Kilo Code | ✅ Supported | Flat |
| Gemini · Mistral | 🚧 In progress | — |
Marketplace = installed and updated through your tool's plugin manager. Flat = files copied directly into your project, no plugin manager involved. Install steps per tool → Other tools.
Installs the 6 stable plugins (aidd-ui is 🚧 alpha, aidd-telemetry 🧪 beta, and aidd-qa 🆕 new, install those separately — see Plugins).
In the session (slash commands)
/plugin marketplace add ai-driven-dev/framework
/plugin install aidd-context@aidd-framework
/plugin install aidd-refine@aidd-framework
/plugin install aidd-dev@aidd-framework
/plugin install aidd-vcs@aidd-framework
/plugin install aidd-pm@aidd-framework
/plugin install aidd-orchestrator@aidd-framework
claude plugin marketplace add ai-driven-dev/framework
claude plugin install aidd-context@aidd-framework
claude plugin install aidd-refine@aidd-framework
claude plugin install aidd-dev@aidd-framework
claude plugin install aidd-vcs@aidd-framework
claude plugin install aidd-pm@aidd-framework
claude plugin install aidd-orchestrator@aidd-framework
Update anytime: /plugin marketplace update aidd-framework.
Same plugin names as Claude Code.
Download your tool's bundle from the latest release, then follow its steps:
[!NOTE] Installing the framework host-wide for several tools can make the same command appear more than once in a tool's list. This happens when one tool reads another tool's settings, and is harmless.
cp -r plugins/aidd-* ~/.cursor/plugins/local/
**Flat**
1. Unzip the `cursor-flat` archive into your project root → `.cursor/`.
_All plans; team marketplaces need Teams/Enterprise. Also reads Claude format (`.claude/skills/`)._
Disable **Include Third-Party Plugins, Skills, and Other Configs** under **Settings → Rules, Skills, Subagents** to hide the duplicate commands.
[Docs](https://cursor.com/docs/plugins)
copilot plugin marketplace add ./aidd-framework-copilot-marketplace-<version>
copilot plugin install aidd-context@aidd-framework # per plugin
**Flat**
1. Unzip the `copilot-flat` archive into your project root → `.github/`.
_Also reads Claude format (`.claude/skills/`, `.claude/agents/`)._
[Docs](https://docs.github.com/en/copilot/how-tos/copilot-cli/customize-copilot/plugins-finding-installing)
codex plugin marketplace add ./aidd-framework-codex-marketplace-<version>
codex plugin add aidd-context@aidd-framework # per plugin
**Flat**
1. Unzip the `codex-flat` archive into your project root → `.codex/`.
[Docs](https://developers.openai.com/codex/plugins/build)
Three ways in — pick one:
| Start with | Command | When |
|---|---|---|
| 🧭 Guided onboarding | /aidd-context:00-onboard |
First time, or unsure what to run — it inspects the project and routes you. |
| 🧠 Project memory | /aidd-context:02-project-memory |
Build the project memory bank by hand. |
| ⚙️ Feature flow | /aidd-orchestrator:01-sdlc |
Ship a feature end to end, autonomous by default or supervised with interactive (frame → deliver → check → PR). |
The full loop, and how onboarding sets it up:
flowchart TD
Onboard(["<b>/aidd-context:00-onboard</b><br/><i>inspect · guide</i>"])
subgraph setup["① Set up — once"]
Memory["<b>project memory</b><br/><i>durable project context</i>"]
end
subgraph loop["② Per feature — repeat"]
direction TB
subgraph frame["Frame"]
direction LR
N["functional need<br/>or User Story"] --> T["issue / ticket"] --> P["plan"]
end
subgraph deliver["Deliver"]
direction LR
I["implement"] --> V["validate"] --> R["review"]
end
subgraph ship["Ship"]
direction LR
PR["PR"] --> S(["✅ production"]) --> L["learn"]
end
P --> I
R --> PR
end
Onboard --> Memory --> N
L -. next need .-> N
classDef hub fill:#D97757,stroke:#9c4f37,color:#fff;
classDef done fill:#2ea043,stroke:#1a7f37,color:#fff;
class Onboard hub;
class S done;
Start with a functional need or User Story, then track it as an issue or ticket before planning. Shipping follows the project's own delivery process. Capture a learning only when it is durable enough to improve the next feature.
🍳 More flows → bundled recipes: MCP installations, token optimization, and installing AIDDy.
Nine plugins covering the whole SDLC — install the six stable ones; they work together. (aidd-ui is 🚧 alpha, aidd-telemetry 🧪 beta, and aidd-qa 🆕 new — all three off the curated path.)
| ### 🧭 [aidd-context](https://github.com/ai-driven-dev/framework/blob/HEAD/plugins/aidd-context/README.md) `13 skills` · stable Project init, memory bank, context-artifact generation, diagrams, learning, exploration. | ### ⚙️ [aidd-dev](https://github.com/ai-driven-dev/framework/blob/HEAD/plugins/aidd-dev/README.md) `10 skills` · stable Code transformation: plan, implement, assert, audit, review, test, refactor, debug. | ### 🌿 [aidd-vcs](https://github.com/ai-driven-dev/framework/blob/HEAD/plugins/aidd-vcs/README.md) `6 skills` · stable Repo init, commits, pull / merge requests, release tags, issues. |
| ### 📋 [aidd-pm](https://github.com/ai-driven-dev/framework/blob/HEAD/plugins/aidd-pm/README.md) `10 skills` · stable Three Amigos refinement, Product Briefs, Epics, User Stories, Tasks, Spikes, Defects, PRD, and specs. | ### 🪞 [aidd-refine](https://github.com/ai-driven-dev/framework/blob/HEAD/plugins/aidd-refine/README.md) `5 skills` · stable Brainstorm, challenge, shadow-areas, fact-check, improve. | ### 🎼 [aidd-orchestrator](https://github.com/ai-driven-dev/framework/blob/HEAD/plugins/aidd-orchestrator/README.md) `3 skills` · stable Synchronous feature flow, async issue-to-PR automation, and product backlog. |
| ### 🎨 [aidd-ui](https://github.com/ai-driven-dev/framework/blob/HEAD/plugins/aidd-ui/README.md) 🚧 `1 skill` · **alpha** UI / UX design — smoke-test only, not ready for use. | ### 📈 [aidd-telemetry](https://github.com/ai-driven-dev/framework/blob/HEAD/plugins/aidd-telemetry/README.md) 🧪 `2 skills` · **beta** Counts the tokens of Claude Code and Codex sessions per task, ticket, model, tool and day. Opt-in, and local to your machine. | ### 🎬 [aidd-qa](https://github.com/ai-driven-dev/framework/blob/HEAD/plugins/aidd-qa/README.md) 🆕 `1 skill` · **new** Acceptance QA — locks browser scenarios from acceptance criteria and records reviewer evidence. |
Full catalog → CATALOG.md.
| 🍳 Recipes | Bundled how-to sheets: MCP installations, token optimization, install AIDDy. Project recipes created by cook live in aidd_docs/recipes/. |
| 🏛️ Architecture | How the framework composes: plugins, skills, hooks, agents. |
| 🧩 Create a plugin | Build and publish your own. |
| 🛒 Marketplace | Install scopes and versioning. |
| ❓ FAQ & Troubleshooting · Glossary | Common questions, fixes, and terms. |
Plugins act with your permissions, and some run Node hooks automatically at session events (the list).
Before installing any plugin, skim its README, hooks/, and .mcp.json. Found a vulnerability? Report it privately → SECURITY.md.
Built by the AI-Driven Dev community: 3 years of R&D, 500+ developers trained in English 🇬🇧 and French 🇫🇷, shipping production software with 100% AI-generated code.
Free and open-source (MIT). If it saves you time, a ⭐ helps others find it.
CONTRIBUTING.md.| 日期 | 榜单 | 排名 | 周期新增 | 总 STAR |
|---|