12 Immutable Mandates
The engineering principles that govern every line of code in The Loop. No exceptions. No workarounds.
I
Trunk-Based Development
One branch. Always production-ready. Every change goes through review and automated verification before reaching users.
II
Immutable Design System
Every visual element follows a centralized design system. No ad-hoc styles. Consistency is enforced, not hoped for.
III
Branch Taxonomy
Every branch follows a strict naming convention. Features, fixes, hotfixes, chores — each has its place. No ambiguity.
IV
Protected Main
The main branch is sacred. No force pushes. No skipping checks. Every merge requires approval and passing automated gates.
V
Mandatory Approval
Every pull request requires explicit human approval. No exceptions — not for bots, not for automation, not for anyone.
VI
No Dev Environment
One environment: production. There is no staging, no preview. If it's merged, it's live. This forces rigor at every step.
VII
Rigorous CI
Lint. Type-check. Test. Build. Security scan. Documentation check. All gates must pass. If any fails, the merge is blocked.
VIII
Mandated Security
Security at four layers: repository, CI/CD pipeline, application runtime, and cloud infrastructure. HTTPS only. No hardcoded secrets. Least privilege everywhere.
IX
Clean Code
Small functions. Descriptive names. Zero dead code. No magic numbers. Tests as documentation. Violations are enough to reject a change.
X
Hexagonal Architecture
Domain logic has zero external dependencies. Ports define contracts. Adapters connect to the real world. Clean boundaries, testable by design.
XI
Project History
Every spec, every decision, every phase is documented and preserved. Nothing is deleted — obsolete docs are archived. The project's history is sacred.
XII
Documentation is Code
Docs are treated with the same rigor as code. Structural changes require doc updates in the same PR. A CI gate enforces it.
This constitution lives in our public repository.
Read the full document on GitHub.Be the first to close the loop.
Join the waitlist and get early access when we launch.