SMALL is stateless by design.
It runs no servers, daemons, or background processes. Lineage and audit are captured by exporting artifacts into existing systems.
| Environment | Pattern |
|---|---|
| Git | Commit .small/ for immutable history |
| CI/CD | Archive progress and status output |
| Audit | Ingest artifacts into Splunk, ELK, Datadog, or a database |
Commit the .small/ directory to preserve state history:
git add .small/
git commit -m "Record SMALL state"Each commit provides an immutable snapshot of project state at that point in time.
Archive SMALL artifacts as build outputs:
small status --json > small-status.json
cp -r .small/ artifacts/This enables post-hoc audit and debugging of automated workflows.
SMALL artifacts are machine-readable YAML files suitable for ingestion into log aggregation and observability systems.
Export patterns:
- Stream
progress.small.ymlentries to a log pipeline - Index
handoff.small.ymlfor checkpoint recovery - Store full
.small/snapshots in long-term storage
SMALL does not replace:
- IAM (Identity and Access Management)
- RBAC (Role-Based Access Control)
- Enforcement systems
SMALL makes execution legible and provable. It describes constraints; it does not enforce them.