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

---

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 / Kilo Code (see Compatibility).
• Node 22 or later on your PATH, only for the plugin that ships hooks (what they do); the workflows themselves are markdown and need nothing.

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

📦 Install

Claude Code

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.

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.

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

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

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

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

Docs

1. Unzip the kilo-flat archive into your project root → .kilo/, including .kilo/kilo.jsonc.
2. Start a new Kilo session so it loads the generated project plugin.

Plugins documentation

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

🧩 Plugins

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

13 skills · stable

Project init, memory bank, context-artifact generation, diagrams, learning, exploration.

⚙️ aidd-dev

10 skills · stable

Code transformation: plan, implement, assert, audit, review, test, refactor, debug.

🌿 aidd-vcs

6 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

5 skills · stable

Brainstorm, challenge, shadow-areas, fact-check, improve.

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

📈 aidd-telemetry 🧪

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 🆕

1 skill · new

Acceptance QA — locks browser scenarios from acceptance criteria and records reviewer evidence.

Full catalog → CATALOG.md.

📚 Learn more

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

🔒 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