The Manifesto for AI-Driven Development.

Preamble

As AI-Driven Developers, we are discovering better ways of building software by working with AI as a deliberate partner — and helping others do the same.

Folio 1
1
Chapter 1
The Values — four tensions

Through this work, we have come to value & to weigh.

Each value below is a compass, not a rule. Together they map the four places a developer's value now lives — method, ownership, understanding, impact. Read the line. Feel which side the weight falls on — then notice that the other side never disappears. It simply weighs less.

Four tensions. Each side still matters. The weight falls left.

1
Value 01 · 04
Method
over
Model
The method endures. The model fades.
methoddo
  plan ──→ implement
              
  assert ←── review
———————————————
any ide · any model
workflow leads.
modeldon't
$ claude
$ codex
$ cursor
$ copilot

swap tools · same speed.
2
Value 02 · 04
Ownership
over
Delegation
You own it. You don’t just delegate it.
ownershipdo
$ git commit
  → reviewed   
  → tested     
Signed-off-by: you 
———————————————
the human owns it.
delegationdon't
$ ai "ship it"
+ 1,240 lines      merged
———————————————
 no review
  nobody read it.
who owns this?
3
Value 03 · 04
Understanding
over
Acceptance
You understand before you accept.
understandingdo
ai: auth via JWT.
$ why? we use
  HttpOnly sessions.
ai: rewriting. 
———————————————
you understood.
acceptancedon't
ai: auth via JWT.
$ ok            accept
———————————————
 3am
  why is this here?
nobody knows.
4
Value 04 · 04
Outcome
over
Output
Ship impact. Not output.
outcomedo
features shipped   
bugs avoided       
users impacted   +410
———————————————
the business moved.
outputdon't
lines generated  12k
tokens burned   1.2M
commits/day       38
———————————————

vanity · zero impact.
Note

That is, while there is value in the items on the right, we value the items on the left more.

Folio 2
2
Chapter 2
The Principles — twelve commitments

Twelve commitments we hold in daily practice.

Read them slowly. Argue with them. The document is stronger for every sharpening.

01

We deliver working software to production, faster and without debt.

Speed and quality are not in conflict. They are the same discipline, practiced twice.

aSee: Fowler, 'Technical Debt Quadrant'
~/app · ship pipeline
$ ship "invoice-export" tests ✓ 482 passed 120ms lint ✓ clean 20ms types ✓ strict 30ms build ✓ ready 900ms deploy ✓ prod 1.2s[main 7f3a9c1] live · debt 0
02

Planning is our first act of collaboration with AI.

The quality of our plan determines the quality of our output. Everything downstream inherits it.

plan · two-phase handoff
AI #1proposeshumandecidesAI #2autonomousphase 1 · reviewhandoffphase 2 · loop aligned · shipped · PR 421
03

We break complexity down until it can be delegated cleanly.

Clarity of scope is clarity of output. Ambiguity compounds; decomposition dissolves it.

bCompare: Parnas, 'On the Criteria to Be Used…', 1972
decompose › the iceberg
$ task add "change user's group"surface: 1 line · looks simple$ decompose├── api PATCH /users/:id/group├── db migration + audit log├── perms re-check on change├── ui form + confirm modal└── tests unit + e2e5 leaves · ready to delegate
04

Context is our primary asset.

We invest in it, maintain it, and protect it from noise. A polluted context produces polluted code.

context · system, not prompt
$ context build├── docs/*.md ✓ 12 files├── src/**/*.ts ✓ 84 files├── skills/aidd:* ✓ loaded└── mcp://serena ✓ live────────────────────────────context = system · not a prompt.
05

We apply the same standards to AI-generated code as to any code we write by hand.

There is no lower bar for generated work. Review, test, reject — the same rituals apply.

src/group.ts · diff
/* @ai-generated · author: claude *//* @reviewed @alex · @responsible @alex */+ export function transferGroup(+ uid: UserId, gid: GroupId+ ): Promise<Result> { ... }────────────────────────────same review · same tests · same bar.
06

We are the architects. Every line that ships is our line — regardless of what produced it.

Authorship is not about the keystroke. It is about the judgment that sent the keystroke.

architecture · spine
human draws the spineapisvcdbAI fills the musclePOST /grpgeneratedservice.tsgeneratedmigrationgeneratedspine: yours · muscle: theirs.
07

We use AI to go further in what we already understand.

We do not delegate what we have not mastered. Competence first; acceleration second.

scope · ambition bar
$ scope --measure solo: ███░░░░░░░░░░░ 3 weekswith AI: ██████████████ 3 days multiplier: ×5 · bar moves upship what you couldn't ship before.
08

When a session loses coherence, we restart.

A clean context is always cheaper than a compacted one. Fresh starts are not failures — they are hygiene.

session · /compact
tokens █████████████████░ 94% coherence drifting · context noisy$ /compact compacted · intent kept$ continue plan.mdfresh context · same intent.
09

We choose a consistent methodology over a collection of tools.

The method outlasts any model. Tools rotate; practice accrues.

method · holds across tools
tools: codexclaudecursoraidernext…models: opussonnethaikugptnext…agentplanimplementtestreview tools change · loop holds.
10

What one of us discovers, all of us adopt.

The community is our compound learning machine. Hoarded technique decays; shared technique compounds.

aidd-docs · committed
$ tree aidd-docs/├── skills/ how we work├── rules/ what holds├── commands/ shared verbs├── templates/ starting points└── docs/ the why$ git push ✓ all peers in syncone commit · whole community.
11

We recognize AI's limits as signals — not walls to push through, but invitations to decompose further.

When the model stalls, the prompt is wrong. When the prompt is wrong, the scope is wrong.

signal · finer grain
same volume · finer grain1stalls4ok9clean16trivialstall = decompose further.
12

We do not stop learning because AI can code. We learn faster because it can.

The leverage is real. What it multiplies is up to us.

~/.aidd/memory.md
$ tail -f memory.md[apr 19] learn: oklch ≠ hsl hue ✓ noted[apr 27] err: forgot null guard ✓ noted[may 02] insight: planning > prompting ✓ noted[may 06] same trap? ─ no.────────────────────────────memory compounds · same trap, never twice.
Folio 3
3
Chapter 3
Sign — make it public

If this reflects how you already work, claim it.

One YAML file, one pull request, on GitHub. No backend, no form, no email harvest. Your name lives next to the manifesto, in public.

Sign the manifesto Open a pull request on GitHub

Five lines to fill, reviewed within a few days. The guide walks through it.

8 signatories

Tweaks

Accent