README.md

Developer Docs

This repo has strict "single source of truth" systems. If you're updating docs or CLI wording, start here:

• Repo facts registry (edit): registry/repo-facts.yaml
  • Generated reference (do not edit): docs/reference/REPO-FACTS.md
  • Generated env var names (do not edit): docs/reference/ENVIRONMENT-VARIABLES.md
• Ubiquitous language registry (edit): registry/ubiquitous-language.yaml
  • Generated glossary (do not edit): docs/reference/GLOSSARY.md
  • System explainer: docs/reference/ubiquitous-language-system-20260210.md

Primary dev docs (dated):

• Architecture: docs/dev/architecture/
• Guides: docs/dev/guides/
• Feature specs: docs/dev/features/
• Bugs: docs/dev/bugs/
• Specs: docs/dev/specs/
• Code-first glossary (term -> code references): docs/dev/glossary/
• Research: docs/research/

User docs (undated, enforced):

• docs/user/