- description
- perform 12-Factor App compliance analysis on a codebase
- name
- 12-factor-apps-analysis
- disable-model-invocation
- true
12-Factor App Compliance Analysis
You are performing a comprehensive compliance analysis against the 12-Factor App methodology for building SaaS applications.
Use the 12-factor-apps skill to guide this analysis.
Target Codebase
Path: $ARGUMENTS (default: current working directory)
Analysis Scope
Evaluate all 12 factors:
- Codebase - One codebase tracked in revision control, many deploys
- Dependencies - Explicitly declare and isolate dependencies
- Config - Store config in the environment
- Backing Services - Treat backing services as attached resources
- Build, Release, Run - Strictly separate build and run stages
- Processes - Execute the app as one or more stateless processes
- Port Binding - Export services via port binding
- Concurrency - Scale out via the process model
- Disposability - Maximize robustness with fast startup and graceful shutdown
- Dev/Prod Parity - Keep development, staging, and production as similar as possible
- Logs - Treat logs as event streams
- Admin Processes - Run admin/management tasks as one-off processes
Workflow
- Use the skill - Read the
12-factor-appsskill for search patterns - Run searches - Use grep patterns from the skill for each factor
- Evaluate compliance - Strong/Partial/Weak per factor
- Document evidence - File:line references for findings
- Identify gaps - What's missing vs. 12-Factor ideal
- Provide recommendations - Actionable improvements
Output Format
Executive Summary
| Factor | Status | Key Finding |
|---|---|---|
| I. Codebase | Strong/Partial/Weak | [Summary] |
| II. Dependencies | Strong/Partial/Weak | [Summary] |
| ... | ... | ... |
Overall: X Strong, Y Partial, Z Weak
Detailed Findings
For each factor with gaps:
- Current State: What exists
- Evidence: File:line references
- Gap: What's missing
- Recommendation: How to improve
Priority Recommendations
- High Priority - Critical gaps affecting scalability/reliability
- Medium Priority - Improvements for better compliance
- Low Priority - Nice-to-have optimizations
Rules
- Use the skill's search patterns systematically
- Provide file:line evidence for all findings
- Be honest about compliance levels (don't inflate)
- Focus on actionable recommendations
- Reference the official 12-Factor App methodology