manifesto.md

PrinciplesSoftware Manifestos

12-Factor Agents

Principles for building LLM-powered software reliable enough to put in front of production customers, modelled on the Twelve-Factor App and maintained in the open.

Canonical text: https://github.com/humanlayer/12-factor-agents.

Factors (titles as published)

  1. Natural language to tool calls.
  2. Own your prompts.
  3. Own your context window.
  4. Tools are just structured outputs.
  5. Unify execution state and business state.
  6. Launch, pause, resume with simple APIs.
  7. Contact humans with tool calls.
  8. Own your control flow.
  9. Compact errors into context window.
  10. Small, focused agents.
  11. Trigger from anywhere, meet users where they are.
  12. Make your agent a stateless reducer.

Facts

Maintainer
Dex Horthy, HumanLayer
Repository
https://github.com/humanlayer/12-factor-agents
First published
2025-04
Status of the text
stable
Listing
listed, not yet claimed

Read with

Badge

manifesto.md: listed

[![manifesto.md](https://img.shields.io/endpoint?url=https://manifesto.md/badge/12-factor-agents.json)](https://manifesto.md/12-factor-agents/)

Maintainers claim a listing with a pull request setting listing: claimed, or a yes on the listing issue.