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)
- Natural language to tool calls.
- Own your prompts.
- Own your context window.
- Tools are just structured outputs.
- Unify execution state and business state.
- Launch, pause, resume with simple APIs.
- Contact humans with tool calls.
- Own your control flow.
- Compact errors into context window.
- Small, focused agents.
- Trigger from anywhere, meet users where they are.
- 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
-
The Twelve-Factor App
Twelve factors for building software-as-a-service applications that are portable, declarative and ready to scale, written at Heroku from experience operating hundreds of thousands of apps.
- claimed
12-Factor AI-enabled CLI
Twelve testable factors for a command-line tool whose operator may be a human or an AI agent, from machine-readable capabilities to meaningful exit codes, with a conformance gate.
v0.1 Agentic Stack
Badge
[](https://manifesto.md/12-factor-agents/) Maintainers claim a listing with a pull request setting listing: claimed, or a yes on the listing issue.