Published summary

twelve-factor/VISION.md at main · twelve-factor/twelve-factor

Source github.com/twelve-factor/twelve-factor/blob/main/VISION.md Published May 19, 2026

The Twelve-Factor manifesto prescribes development practices that trade application-layer control for improved operability, portability, and scalability.

Purpose and Essence

The Twelve-Factor manifesto defines ideal practices for app development to minimize fragility, foster maintainable growth, reduce collaboration friction, and prevent software erosion. It provides a shared vocabulary for discussing these practices and offers clear, actionable recommendations.

The essence of Twelve-Factor is a clear contract between an application and its execution platform.

Focus on Developer Experience

Twelve-Factor focuses on reducing cognitive load for the application developer and offers prescriptive practices to limit the responsibilities and therefore concerns of the application. These practices are most powerful when they are implemented into application frameworks and cloud platforms, enabling developers to operationalize for free.

Content Types and Tenets

The manifesto includes three types of content: factors (the twelve most important principles), examples (descriptions showing how principles apply), and guidelines (concrete requirements for compliance).

The content adheres to four basic tenets: selective (deliberately constrained for focus), specific (detailed for developers, platforms, and frameworks), clear (easy to understand for all audiences), and relevant (timeless concepts with up-to-date examples).

Value from Sacrifice

Following Twelve-Factor implies a loss of control at the application layer, but it rewards this sacrifice with substantial value. This value comes from the factors' emphasis on development practices that improve operability, addressing day-two concerns on day one. As a result, a twelve-factor application is secure, configurable, observable, predictable, and updatable. These attributes enable it to scale with changing demand, integrate easily into larger systems, and remain portable across platforms.

Read this at any depth.

Install Depth and pick your level — Glance for a sentence, Summary for the gist, Read for the full take. Free daily quota, no signup needed.

Add to Chrome
10 views