Cursor rule

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