| name | wiki-finalize-drafts |
| description | Review stale draft wiki pages and finalize them — fix missing citations, run validator, commit |
| triggers | ["wiki-finalize-drafts","wiki finalize-drafts"] |
What This Does
Surfaces stale draft pages, identifies what's blocking finalization (missing
citations, failing validator), fixes the blockers, and runs wiki finalize.
Reference conventions: WIKI.md § 8 (draft lifecycle), § 12.2 lint check stale-drafts.
Usage
/wiki-finalize-drafts # Review all stale drafts
/wiki-finalize-drafts wiki/synthesis/foo.md # Target one page
Execution Steps
-
Find drafts: Run wiki lint --scope stale-drafts to list pages with
draft: true older than 7 days.
-
Prioritize: For each draft, classify:
- Cat A — has
## Sources cited section with [[sources/...]] links → ready to finalize
- Cat B — has claims but no citations → needs cite-suggest
- Cat C — stub content → flag for user decision (finalize or abandon)
-
Cat A — finalize directly:
.venv/bin/wiki finalize wiki/<type>/<slug>.md
-
Cat B — add citations first:
Run /wiki-cite wiki/<type>/<slug>.md (or use wiki cite-add) to surface
citation candidates. Then finalize.
-
Cat C — present to user: Show the slug and ask: finalize as-is, abandon, or skip?
To abandon: .venv/bin/wiki finalize wiki/<type>/<slug>.md --abandon
-
Report: State how many pages were finalized, abandoned, skipped.
Key constraints
- Never modify page body via direct Edit for citation purposes — use
wiki cite or wiki cite-add.
wiki finalize will fail if citation grounding is not met; fix citations, don't force.
draft: true in frontmatter is the only authoritative source of draft status.