Governance and Rule Sources
This page defines the documentation single source of truth policy for this repository. Use it as the reference when deciding where canonical rules and process docs belong.
Single source of truth
Canonical project documentation lives in Docusaurus under /docs.
Root markdown files outside website/docs are entrypoints and compatibility stubs only.
Rule source map
- What Is LIVON and Why
- Getting Started
- Contributing
- Coding Style Guide
- Definition of Done
- Testing and Quality
- Project Context
- Change History
- Architecture
- Runtime Design
- Event Flow
- Roadmap
Prompt entrypoint policy
PROMPT.mdis an entrypoint file that links to these docs.PROMPTS.mdis the prompt index entrypoint that links to these docs.- Package prompt files must link to the relevant Docusaurus pages for package scope.
Migration policy
When adding or updating repository documentation:
- Update the Docusaurus page first.
- Keep root/package README-style files as short redirects only.
- Avoid duplicate rule text across non-doc files.
Tooling governance policy
Tooling policy is defined in Contributing.
- Prefer default configs and standard tool commands over custom wrappers.
- Use Turborepo (
turbo.json) as the orchestration layer for monorepo tasks.