Skip to main content

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

  1. What Is LIVON and Why
  2. Getting Started
  3. Contributing
  4. Coding Style Guide
  5. Definition of Done
  6. Testing and Quality
  7. Project Context
  8. Change History
  9. Architecture
  10. Runtime Design
  11. Event Flow
  12. Roadmap

Prompt entrypoint policy

  • PROMPT.md is an entrypoint file that links to these docs.
  • PROMPTS.md is 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:

  1. Update the Docusaurus page first.
  2. Keep root/package README-style files as short redirects only.
  3. 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.