The AI-Driven Dev Framework 🇫🇷

Open source agnostic framework to generate high quality clean code.

(Already tested on Legacy codebases)

7 plugins · 47 skills · 2 agents · MIT

🗺️ 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.

✅ Prerequisites

• An AI coding tool — Claude Code (native), or Cursor / Copilot / Codex / OpenCode (see Compatibility).
• Node on your PATH — for the plugin that ships hooks (what they do).

🔌 Compatibility

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
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.}

📦 Install

Claude Code

Installs the 6 stable plugins (aidd-ui is 🚧 alpha, install 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
/plugin install aidd-ui@aidd-framework # 🚧 alpha, install separately

Command line (same, prefixed with `claude`)

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
claude plugin install aidd-ui@aidd-framework # 🚧 alpha, install separately

Update anytime: /plugin marketplace update aidd-framework.

Other tools

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.

Cursor

Marketplace

1. Unzip the cursor-marketplace archive.
2. Copy the plugins (Cursor reloads them automatically):

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

GitHub Copilot

Marketplace

1. Unzip the copilot-marketplace archive.
2. Run:

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

Codex

Marketplace

1. Unzip the codex-marketplace archive.
2. Run:

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

OpenCode — Flat only

1. Unzip the opencode-flat archive into your project root → .opencode/.

Docs

🚀 Quick start

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	Autonomously ship a feature end to end (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 LR
      B["brainstorm"] --> P["plan"] --> I["implement"] --> R["review"] --> C["commit"] --> PR(["✅ PR"])
    end

    Onboard --> Memory --> B

    classDef hub fill:#D97757,stroke:#9c4f37,color:#fff;
    classDef done fill:#2ea043,stroke:#1a7f37,color:#fff;
    class Onboard hub;
    class PR done;

Loading

🍳 More flows → bundled recipes: start a project, ship a feature, and more.

🧩 Plugins

Seven plugins covering the whole SDLC — install all of them; they work together. (aidd-ui is 🚧 alpha, off the curated path.)

🧭 aidd-context 13 skills · stable Project init, memory bank, context-artifact generation, diagrams, learning, exploration.	⚙️ aidd-dev 11 skills · stable Code transformation: plan, implement, assert, audit, review, test, refactor, debug. Standalone Browser QA records short web evidence.	🌿 aidd-vcs 5 skills · stable Repo init, commits, pull / merge requests, release tags, issues.
📋 aidd-pm 10 skills · stable Three Amigos refinement, Product Briefs, Epics, User Stories, Tasks, Spikes, Defects, PRD, and specs.	🪞 aidd-refine 4 skills · stable Brainstorm, challenge, shadow-areas, fact-check.	🎼 aidd-orchestrator 3 skills · stable Synchronous feature flow, async issue-to-PR automation, and product backlog.
🎨 aidd-ui 🚧 1 skill · alpha UI / UX design — smoke-test only, not ready for use.

Full catalog → CATALOG.md.

📚 Learn more

🍳 Recipes	Bundled how-to sheets: start a project, ship a feature, MCP installations, token optimization. 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, versioning, LLM tiers.
❓ FAQ & Troubleshooting · Glossary	Common questions, fixes, and terms.

🔒 Trust and safety

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.

🧑‍💻 The AI-Driven Dev

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.

• Join the Discord 🇫🇷 — public roadmap decisions every Thursday morning.
• Want to train your team? See the programme.
• AI is important to you? Join the ecosystem.

🤝 Contributing

Free and open-source (MIT). If it saves you time, a ⭐ helps others find it.

• Idea or bug? Open an issue or start a discussion.
• Contribute code → CONTRIBUTING.md.

---

Made with care in France 🇫🇷 · ← AIDD organisation