diff --git a/tech_docs/template_kindom.md b/tech_docs/template_kindom.md index 80880a2..3faf24e 100644 --- a/tech_docs/template_kindom.md +++ b/tech_docs/template_kindom.md @@ -1,3 +1,31 @@ +The “One-Tool Mousetrap” is a concise manifesto for adopting CUE (Configure-Unify-Execute) as the single source of truth for configuration and policy. +It attacks the common multi-stage YAML stack: + +1. YAML hand-edited by humans +2. Jinja2/Go-template rendering → JSON +3. Some external validator (Kubeval, OPA, custom scripts) +4. If validation fails, loop back and edit again (runtime surprise) + +The anti-pattern is that you only discover type/syntax/semantic errors after rendering, when the cost of repair is highest. + +CUE inverts the flow: + +- CUE schema + data (both expressed in CUE’s own language) +- `cue export` (a single binary) +- Immediately emits valid YAML/JSON/Dockerfile/INI, already linted against the schema. + +Thus the same surface (CUE) is: + +• The linter (static analysis) +• The schema (type & constraint def) +• The template (data transformation) + +Zero runtime surprises because validation and generation happen in one atomic step. + +In short: “CUE collapses the stack.” + +--- + Supremacy Verdict (inside the **Deterministic Serendipity Kingdom**, where YAML is king and *zero leakage* is law)