silverensure-docslisted

# /silver:ensure-docs — Documentation Authority Single source of docs governance in Silver Bullet: - Human policy: `docs/doc-scheme.md` - Runtime contract: `docs/doc-scheme.json` This skill is the only doc orchestrator for: 1. init-time bootstrap (`--bootstrap`) 2. brownfield reconciliation (`--reconcile-brownfield`) 3. hook-gap remediation (`--from-hook --task ... --gaps ...`) 4. contract recovery (`--recover-scheme`) 5. semantic freshness audits against the current project state ## Safety Rules 1. Never delete user docs. 2. Never silently overwrite user docs. 3. When user switches to SB alternatives, move replaced artifacts to `docs/archive/<timestamp>/...` with a manifest record. 4. Every move must be traceable: source, destination, reason, task id, timestamp. 5. Keep `docs/doc-scheme.md` and `docs/doc-scheme.json` synchronized. ## Semantic Audit Expectations `silver:ensure-docs` is not satisfied by structural validation alone. It must: - read every governed doc that claims to describe current project state - compare those claims to the current codebase, hooks, commands, workflows, and runtime behavior - distinguish live/reference docs from archival or historical snapshots - flag stale, misleading, or contradictory prose instead of treating it as current - keep brownfield checklist scaffolding aligned to the actual governed-doc inventory, not placeholder keys ## Mode: `--bootstrap` Use during `/silver:init` for both greenfield and brownfield repos. ### Greenfield