12-factor-app

v2026.09.24

The Twelve-Factor App methodology for building scalable, maintainable cloud-native applications. Use when designing backend services, APIs, microservices, or any software-as-a-service application. Triggers on deployment patterns, configuration management, process architecture, logging, and infrastructure decisions.

GitHub
Install command
npx skhub add pproenca/12-factor-app
Markdown
SKILL.md

Community Cloud-Native Applications Best Practices

Comprehensive methodology for building modern software-as-a-service applications that are portable, scalable, and maintainable. Contains 51 rules across 12 categories, covering the entire application lifecycle from codebase management to production operations.

When to Apply

Reference these guidelines when:

  • Designing new backend services or APIs
  • Containerizing applications for Kubernetes or Docker
  • Setting up CI/CD pipelines
  • Managing configuration across environments
  • Implementing logging and monitoring
  • Planning application scaling strategy
  • Debugging deployment or environment issues

Rule Categories by Priority

PriorityCategoryImpactPrefix
1Codebase & Version ControlCRITICALcode-
2DependenciesCRITICALdep-
3ConfigurationCRITICALconfig-
4Backing ServicesHIGHsvc-
5Build, Release, RunHIGHbuild-
6Processes & StateHIGHproc-
7Concurrency & ScalingHIGHscale-
8DisposabilityHIGHdisp-
9Port BindingMEDIUMport-
10Dev/Prod ParityMEDIUMparity-
11LoggingMEDIUMlog-
12Admin ProcessesMEDIUMadmin-

Quick Reference

1. Codebase & Version Control (CRITICAL)

2. Dependencies (CRITICAL)

3. Configuration (CRITICAL)

4. Backing Services (HIGH)

5. Build, Release, Run (HIGH)

6. Processes & State (HIGH)

7. Concurrency & Scaling (HIGH)

8. Disposability (HIGH)

9. Port Binding (MEDIUM)

10. Dev/Prod Parity (MEDIUM)

11. Logging (MEDIUM)

12. Admin Processes (MEDIUM)

How to Use

Read individual reference files for detailed explanations and code examples:

Reference Files

FileDescription
references/_sections.mdCategory definitions and ordering
assets/templates/_template.mdTemplate for new rules
metadata.jsonVersion and reference information
Discovery
Tags

No tags published for this skill.

Version
Latest version metadata

Version

v2026.09.24

Published

Sep 24, 2026

Category

Uncategorized

License

MIT

Source path

skills/.experimental/12-factor-app

Default branch

master

Latest commit

cf93c57

Tree SHA

afbb575