Aigile: a method for building software with humans and AI agents

Aigile applies the ideas of agile development to work with coding agents: small steps, short feedback loops, and light plans that change when you learn something. It keeps the useful habit that spec-driven development introduced, writing important context down where agents can read it, and organizes that context so it stays small, current, and easy to trust.

The starting point

Software turns out right when misunderstandings are found early, and short feedback loops are the most reliable way to find them. Coding agents make each loop much cheaper to run, so it becomes practical to run more of them and to keep the written specifications small. Current spec-driven tools tend to go the other way, with large specifications and few feedback points, and in practice this works poorly. The assessment page explains why, with an example.

Read more

What humans keep doing

In every aigile setup, humans decide what to build, why, and whether the result is right. Agents can gradually take over the checking work, one area at a time, when a recorded track record supports it, and the work returns to humans when something goes wrong. Because the human part stays the same across all setups, a small team pairing with one agent and a largely automated delivery pipeline can follow the same method.

Read more

How it is documented

The method is written down in a working paper and nine deep-dive papers. Together they define thirty-six numbered rules, the protocols behind them, one worked example that runs through the whole series, known failure modes, and metrics. All documents are versioned and free to download.

Read more

How to start

Three tutorials each take you from installation to a first completed feature, on the same small example: one for SpecKit with its gated workflow, one for Claude Code with its always-on skill, and one that composes the method with an OpenSpec setup. Expect one to two hours for a full first pass, most of it real work on the feature.

Read more

Status and scope

Aigile is a working draft, published for discussion. The critique of spec-driven development rests on published field reports and on research into multi-agent pipelines. The method itself is stated as testable rules with metrics attached, but solid comparative evidence does not yet exist for any agentic development method, including this one. The working paper lists the open questions, and reports from teams trying the approach in practice are the most useful contribution at this stage.