Twelve-Factor Audit
Use this skill to inspect an implemented application and produce a structured audit report that downstream quality, security, reporting, and delivery workflows can consume.
Triggers
- "Audit this repo against Twelve-Factor"
- "Produce a 12+ Factor evidence report"
- "Find cloud-native operational readiness gaps"
- "Turn Twelve-Factor audit findings into remediation issues"
Behavior
- Establish the audit scope: application name, repo paths, deployment targets, environments, release process, and evidence sources.
- Collect evidence from code, dependency manifests, lockfiles, configuration, deployment manifests, CI, tests, API contracts, logs, dashboards, runbooks, ADRs, and security/provenance artifacts.
- Assess every original Twelve-Factor principle plus the modern extension factors listed in the addon README.
- Assign each factor a status of
pass, partial, fail, or not_applicable.
- For every finding, cite concrete evidence paths or note
missing evidence explicitly.
- Record risks with severity and impact, then map remediation to owner-ready tasks.
- Validate the report against
schemas/audit-report.schema.json when the output is JSON.
Output
Use templates/audit-report.md for human-readable reports or the JSON contract in schemas/audit-report.schema.json for machine-readable reports. Every factor finding should include:
- Factor identifier and title
- Status
- Evidence list
- Risks
- Remediation tasks
- Traceability links to requirements, ADRs, tests, code/config, and issues when available
Examples
Input:
Audit the billing service. Evidence is in package.json, package-lock.json, Dockerfile, helm/, openapi.yaml, .gitea/workflows/test.yml, docs/runbooks/billing.md, and dashboards/billing.json.
Expected output:
Overall status: partial
Pass: codebase, dependencies, port binding, logs
Partial: config, backing services, telemetry, dependency hygiene
Fail: build/release/run separation, supply-chain provenance
Remediation: split release metadata from image build; add SBOM/provenance evidence; document backing-service attachment contracts.
References
- @$AIWG_ROOT/agentic/code/addons/twelve-factor/checklists/audit-checklist.md
- @$AIWG_ROOT/agentic/code/addons/twelve-factor/templates/audit-report.md
- @$AIWG_ROOT/agentic/code/addons/twelve-factor/schemas/audit-report.schema.json
- @$AIWG_ROOT/agentic/code/addons/twelve-factor/fixtures/sample-audit-report.json
- @$AIWG_ROOT/agentic/code/addons/twelve-factor/rules/twelve-factor-evidence.md
1---2namespace: aiwg3name: twelve-factor-audit4description: Audit an application against Twelve-Factor and modern 12+ Factor criteria with structured evidence, risks, and remediation tasks.5platforms: [all]6triggers:7 - "twelve factor audit"8 - "12 factor audit evidence"9 - "audit application against 12+ factor"10 - "cloud native operational audit"11metadata:12 source: https://skillmd.com/skills/jmagly-ai-writing-guide/twelve-factor-audit13---1415# Twelve-Factor Audit1617Use this skill to inspect an implemented application and produce a structured audit report that downstream quality, security, reporting, and delivery workflows can consume.1819## Triggers2021- "Audit this repo against Twelve-Factor"22- "Produce a 12+ Factor evidence report"23- "Find cloud-native operational readiness gaps"24- "Turn Twelve-Factor audit findings into remediation issues"2526## Behavior27281. Establish the audit scope: application name, repo paths, deployment targets, environments, release process, and evidence sources.292. Collect evidence from code, dependency manifests, lockfiles, configuration, deployment manifests, CI, tests, API contracts, logs, dashboards, runbooks, ADRs, and security/provenance artifacts.303. Assess every original Twelve-Factor principle plus the modern extension factors listed in the addon README.314. Assign each factor a status of `pass`, `partial`, `fail`, or `not_applicable`.325. For every finding, cite concrete evidence paths or note `missing` evidence explicitly.336. Record risks with severity and impact, then map remediation to owner-ready tasks.347. Validate the report against `schemas/audit-report.schema.json` when the output is JSON.3536## Output3738Use `templates/audit-report.md` for human-readable reports or the JSON contract in `schemas/audit-report.schema.json` for machine-readable reports. Every factor finding should include:3940- Factor identifier and title41- Status42- Evidence list43- Risks44- Remediation tasks45- Traceability links to requirements, ADRs, tests, code/config, and issues when available4647## Examples4849Input:5051```text52Audit the billing service. Evidence is in package.json, package-lock.json, Dockerfile, helm/, openapi.yaml, .gitea/workflows/test.yml, docs/runbooks/billing.md, and dashboards/billing.json.53```5455Expected output:5657```text58Overall status: partial59Pass: codebase, dependencies, port binding, logs60Partial: config, backing services, telemetry, dependency hygiene61Fail: build/release/run separation, supply-chain provenance62Remediation: split release metadata from image build; add SBOM/provenance evidence; document backing-service attachment contracts.63```6465## References6667- @$AIWG_ROOT/agentic/code/addons/twelve-factor/checklists/audit-checklist.md68- @$AIWG_ROOT/agentic/code/addons/twelve-factor/templates/audit-report.md69- @$AIWG_ROOT/agentic/code/addons/twelve-factor/schemas/audit-report.schema.json70- @$AIWG_ROOT/agentic/code/addons/twelve-factor/fixtures/sample-audit-report.json71- @$AIWG_ROOT/agentic/code/addons/twelve-factor/rules/twelve-factor-evidence.md