README.md markdown
36 lines 1.4 KB
Raw
sha256:0e9549ec7b463911bc08b7d586dc320b1ac9b1f5c943ee7e3865dcc6cb0f6f83 chore(governance): sync handover+roadmap to 84db8c8 (drift:… Human 2 days 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 1 commit
sha256:6abcf1fa82a7a621ccbc945f19acdba5bc0db54569599404a1452fb4a096a199 fix(ISR): default require_independent_second_reviewer to require Human minor 2 days ago