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

Not sure which mode fits? Answer a few questions on the homepage to get a suggestion and a ready-made badge snippet.

2. Add the badge

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

README badge
[![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

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