README.md markdown
40 lines 1.7 KB
Raw
sha256:c079680aa72b38cf20f7891daeadbb28f6ec71301dff7c1973565401e6f23a34 docs: align public documentation and website with bounded v1 Human minor ⚠ breaking 8 days ago

Historical pre-reset product. This document describes the pre-reset historical product. Its legacy commands are not exposed by the bounded-v1 entrypoint. Do not use it as current onboarding. See the root README and current docs index.

Templates — token-parameterized governance doc skeletons

Copied into consumer repos by ok init / ok sync (K4) with substitution from .overseer/config.yaml.

Template Becomes (typical)
OVERSEER-HANDOVER.template.md {{docs.handover_path}}
ROADMAP.template.md {{docs.roadmap_path}}
STANDING-DECISIONS.template.md section in {{docs.standing_decisions_path}} or standalone
CROSS-REPO-COORDINATION.template.md {{docs.coordination_path}} when configured

Token substitution

Placeholders use {{dotted.key}} form. Allowed keys are frozen in tokens.yaml and enforced by adapters.templating — unknown tokens fail closed.

from pathlib import Path
from adapters.config import load_config
from adapters.templating import render_template

config = load_config(Path(".overseer/config.yaml"))
text = render_template(Path("templates/OVERSEER-HANDOVER.template.md"), config)

Kit ships format and skeletons, not repo-specific Standing Decision contents.

Public branding (locked at KH1 close-out)

Token / surface Meaning
🆗 Overseer Kit Public product display name (locked)
{{repo.name}} Consumer repo slug — technical identifier, not the public brand
{{docs.handover_title}} Per-consumer handover title (default: Overseer Handover)
Landing (docs/landing/) Uses 🆗 Overseer Kit in page title and hero
File History 1 commit
sha256:c079680aa72b38cf20f7891daeadbb28f6ec71301dff7c1973565401e6f23a34 docs: align public documentation and website with bounded v1 Human minor ⚠ 8 days ago