MATRIZ Engineering
This site publishes the MATRIZ repository’s engineering docs in browsable form. The repository is the source of truth — every page under Repo docs is generated from a repo markdown file at build time and says so at the top.
Where things live
Section titled “Where things live”| Question | Doc |
|---|---|
| What works right now, what’s open? | Status |
| How is the system built? | Architecture and the durable overview |
| What do the words mean? | Terminology |
| Why is it built this way? | decisions-logs/ in the repo (frozen archive + one-file-per-decision log, too large to publish in full — grep decisions-logs/INDEX.md in the repo) |
| How do I change the DB schema? | Migrations |
| How do docs get updated (and archived)? | Docs policy |
| How do coding agents work here? | Agent guide |
User-facing docs
Section titled “User-facing docs”Product documentation for MATRIZ users lives at
docs.matriz.design — a separate site
(apps/docs-product), written for customers, not engineers.