# 12-Factor Agents

Canonical: https://cqbase.net/en/entry/twelve-factor-agents
Chinese: https://cqbase.net/zh/entry/twelve-factor-agents
English: https://cqbase.net/en/entry/twelve-factor-agents

> Principles for building LLM-powered software that is reliable enough for production. The license is unspecified.

humanlayer/12-factor-agents discusses principles for building LLM-powered software that is reliable enough to put in front of production customers. GitHub does not map the license to a clear SPDX identifier. It is a method, not an agent you install.

Read a principle against the system you are actually building: where state lives, what happens when a tool fails, and when a person should step in. Do not treat the titles as the whole checklist. The current text in the repository is the source. This page does not copy it.

Mentioned by:

- [@mdjunaidap](https://x.com/mdjunaidap/status/2118697412126810322) mentioned this project on 6 November 2026 (40 likes and 6 reposts, captured 15 November 2026).

Note (verified 15 November 2026): The repository is not archived, and the README has no deprecation notice. This is a methodology guide. The last push was at 22:37 Asia/Shanghai on 21 September 2025, about 14 months ago. Please note the document date when you read it.

## Catalog record

- Author: humanlayer
- License: Unspecified
- Source: https://github.com/humanlayer/12-factor-agents
- Added: 2026-11-15
- GitHub stars: 27214 (captured 2026-11-15)

