Adoption guide

Add AIDM to your project.

Start with one badge. Add a structured profile only if you want more detail.

1. Find your mode

2. Add the badge

Replace Collaborative with your chosen mode. Use the same neutral color for every mode.

[![AI Development: Collaborative](https://img.shields.io/badge/AI%20Development-Collaborative-f97316)](https://aidevmode.org/)

The badge may link to the specification site or to your own .aidm.json declaration.

3. Optionally add .aidm.json

{
  "spec_version": "0.1.1",
  "mode": "collaborative",
  "scope": { "type": "repository" },
  "profile": {
    "planning": "shared",
    "architecture": "human-led",
    "implementation": "shared",
    "testing": "shared",
    "review": "human-led",
    "human_review_frequency": "continuous",
    "autonomous_scope": "task"
  }
}

4. Review it when your workflow changes

AIDM is a statement about the development process, so update it when the process materially changes. Release-scoped declarations are supported when history matters.