README.md markdown
36 lines 1.4 KB
Raw
sha256:a78e7e5a8740e03315f325d19edeb3aa1b306b3337d04abbaa9a9e0f3bbeb7a1 docs: MuseHub-first before ISR #74 — staging solidify NEXT Human 1 day ago

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 2 commits
sha256:a78e7e5a8740e03315f325d19edeb3aa1b306b3337d04abbaa9a9e0f3bbeb7a1 docs: MuseHub-first before ISR #74 — staging solidify NEXT Human 1 day ago
sha256:4671b7f787ddbe63ced31c895b688c77ab495653b65a730b423329f26b3c1439 feat: K1-P1 complete — agent provenance, build-verification… Sonnet 4.6 patch 52 days ago