Windsurf rules

1---
2name: maintain-wiki
3model: haiku
4description: "Agent-maintained OKF wiki — INGEST source docs, LINT for issues, QUERY across concept pages. Run as part of build-epic Step 8 and verify-work Phase 3."
5---
6 
7# Maintain Wiki
8 
9Three operations for keeping the OKF wiki bundle consistent with its source docs.
10 
11## INGEST
12 
13Read source doc (CLAUDE.md, CONVENTIONS.md, or SKILL.md) and write/update OKF concept pages:
14 
15```bash
16# Regenerate skills-wiki from SKILL.md files
17bash scripts/sync-skills.sh --okf
18 
19# Regenerate conventions-wiki from CONVENTIONS.md
20bash scripts/decompose-conventions.sh
21 
22# Regenerate agent-guide from CLAUDE.md
23bash scripts/generate-agent-guide.sh
24```
25 
26## LINT
27 
28Check for common OKF issues:
29 
301. **Stale concepts** — source file mtime vs concept page mtime. If source is newer, concept is stale.
312. **Orphan concepts** — concept page exists but source doc section no longer exists.
323. **Missing cross-references** — skill concept pages with no `enforced_by` or `references` links.
334. **Contradictions** — two concept pages that make opposite claims about the same topic.
345. **Broken links** — internal OKF links that point to non-existent concept pages.
35 
36```bash
37# Quick stale check: compare source vs concept mtimes
38for page in specs/skills-wiki/skills/*.md; do
39  skill=$(basename "$page" .md)
40  source="skills/$skill/SKILL.md"
41  if [ -f "$source" ] && [ "$page" -ot "$source" ]; then
42    echo "STALE: $skill (SKILL.md newer than concept page)"
43  fi
44done
45```
46 
47## QUERY
48 
49Search across OKF concept pages to answer questions:
50 
51```bash
52# Find all concepts about a topic
53grep -rl "topic" specs/skills-wiki/ specs/conventions-wiki/ specs/agent-guide/
54 
55# Trace a convention → enforcing skills
56grep -A1 "enforced_by" specs/conventions-wiki/*.md
57 
58# Find skill by description keyword
59grep -ril "keyword" specs/skills-wiki/skills/*.md
60```
61 
62## Verify
63 
64→ verify: `test -d specs/skills-wiki && test -d specs/conventions-wiki && test -d specs/agent-guide`
65