Skip to content

Add wiki-governor skill (self-governing maintenance loop)#25

Merged
Hefrock merged 1 commit into
mainfrom
claude/festive-cori-wd84yr
Jul 14, 2026
Merged

Add wiki-governor skill (self-governing maintenance loop)#25
Hefrock merged 1 commit into
mainfrom
claude/festive-cori-wd84yr

Conversation

@Hefrock

@Hefrock Hefrock commented Jul 14, 2026

Copy link
Copy Markdown
Owner

Implements the maintenance-loop backlog (#7) as wiki-governor — reworked from a plain timer into a skill that makes the vault self-aware, not just self-maintaining. Also closes #5 (wiki-reviewer, dropped after a MECE review — its content-quality work overlapped wiki-librarian).

Design principle: orchestrate, don't duplicate

Governor invokes wiki-librarian /audit and wiki-synthesizer /synthesize rather than reimplementing their checks. Its own value is the three governance functions neither provides:

Phase What it does Unique?
1 · Maintain runs librarian + synthesizer, auto-applies only librarian-classified low-risk fixes orchestration
2 · Compliance maps findings to the 10 constitution laws; adds the provenance check (Law 9) nothing else makes ✅ new
3 · Health score five transparent sub-metrics → tracked 0–100 score with run-over-run delta ✅ new
4 · Gap queue aggregates open questions + failed /askes into Maps/_gaps.md — the vault's to-learn list ✅ new
5 · Report governance log to journal + Maps/_context.md update

Health score (measure, don't game)

connectedness · maturity · freshness · provenance · resolution → weighted 0–100, always reported with its components and the delta, never the headline alone. Explicit Goodhart's-law caveat in the skill: the score is a mirror, not a target.

Files

  • skills/wiki-governor/SKILL.md — the skill
  • marketplace.json + README (skill table, repo tree) — registration
  • knowledge-os/architecture.md — component map + load order
  • assets/context.md — hot-cache template gains last_governed / health_score frontmatter and a ## Health section

Roster after this change

wiki-operator · wiki-synthesizer · wiki-librarian · wiki-governor — plus wiki-teacher (#6) still planned, content-gated.

Docs-only skill (no runnable code), so nothing new for CI to execute; marketplace JSON validated (7 plugins).

🤖 Generated with Claude Code


Generated by Claude Code

Replaces the plain "maintenance loop" backlog (#7) with a skill that is
self-aware, not just self-maintaining. It orchestrates the existing skills
rather than duplicating them, then adds the three governance functions
neither wiki-librarian nor wiki-synthesizer provides:

- Phase 1 — Maintain: invokes wiki-librarian /audit + wiki-synthesizer
- Phase 2 — Constitution compliance: maps findings to the 10 laws and adds
  the provenance check (Law 9) nothing else makes
- Phase 3 — Health score: five transparent sub-metrics (connectedness,
  maturity, freshness, provenance, resolution) rolled into a tracked 0-100
  score with run-over-run delta; "measure, don't game" discipline
- Phase 4 — Knowledge-gap queue: aggregates open questions + failed asks
  into Maps/_gaps.md so the vault notices what it doesn't know
- Phase 5 — Governance report + hot-cache update

Also:
- marketplace.json + README (skill table, repo tree) register the skill
- knowledge-os/architecture.md: component map + load order
- assets/context.md hot-cache template gains last_governed / health_score
  frontmatter and a ## Health section

Note: wiki-reviewer (#5) closed as not planned — its content-quality work
overlapped wiki-librarian; contradiction/clarity checks stay there.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_013H1oBwjtpzDLGreGTTjoP7
@Hefrock
Hefrock merged commit 6b75e20 into main Jul 14, 2026
4 checks passed
@Hefrock
Hefrock deleted the claude/festive-cori-wd84yr branch July 14, 2026 16:37
@Hefrock Hefrock mentioned this pull request Jul 14, 2026
4 tasks
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Build wiki-reviewer skill

2 participants