Goal → software
AI performs substantially the complete development process after the initial goal or specification.
Open specification · Draft v0.1.1
Say how AI helped build your software.
AI Development Mode gives repositories a simple, human-readable way to disclose how much agency humans and generative AI had during development — without fake percentages or line-by-line attribution.
AI DevelopmentCollaborative
Named modes, not arbitrary levels.
A mode describes the typical workflow for substantive changes. It is not a quality score and no mode is inherently better than another.
AI owns large steps
AI independently handles substantial multi-step work while humans review milestones and redirect.
Build together
Human and AI shape decisions and implementation together through frequent feedback loops.
Human sets the path
The human defines requirements, architecture, and approach; AI executes bounded tasks.
AI supports
The human performs core development; AI helps with debugging, tests, docs, review, and suggestions.
Local or no AI use
AI is only used occasionally for small local tasks, or is intentionally not used at all.
Different workflows? Say so.
When materially different workflows are common, use Mixed with a profile or publish scoped declarations instead of averaging them into a meaningless number.
One badge. More detail when it matters.
The badge communicates quickly. An optional .aidm.json profile describes planning, architecture, implementation, testing, review frequency, and the largest scope AI can handle autonomously.
Not authorship tracking. AIDM describes the development process. It does not claim which individual lines came from a model.
Example profile
| Planning | Shared |
| Architecture | Human-led |
| Implementation | Shared |
| Testing | Shared |
| Review | Human-led |
| Human review | Continuous |
| Autonomous scope | Task |
Built for easy adoption.
Choose the mode
Classify the typical workflow for substantive changes, not a one-off exception.
Classify the typical workflow for substantive changes, not a one-off exception.
Add a README badge
Use a neutral badge linked to the specification or your own declaration.
Use a neutral badge linked to the specification or your own declaration.
Optionally add
Give readers a structured profile without exposing prompts or source-level provenance.
.aidm.jsonGive readers a structured profile without exposing prompts or source-level provenance.
Honesty is the cheap option.
An accurate declaration tells contributors what to expect, lets adopters calibrate their review, and replaces speculation with a statement you control. No mode is ranked or colored as better, so understating AI involvement gains nothing.
Open by design.
AIDM is vendor-neutral, MIT licensed, and created as part of Astzweig's Social Contribution efforts. The goal is a small convention that communities can improve and reuse freely.
Explore the draft