help

EXECUTE NOW

Target: $ARGUMENTS

Parse immediately:

• If target contains --compact: force compact mode regardless of vault state
• If target contains a skill name (e.g., "help reduce" or "help reflect"): show detailed help for that specific skill
• If target is empty: determine mode from vault state

Execute these steps:

1. Gather vault state (Step 1)
2. Resolve domain vocabulary (Step 2)
3. Determine mode (Step 3)
4. Discover commands dynamically (Step 4)
5. Render the appropriate mode (Step 5)

START NOW. Reference below defines each step.

---

Step 1: Gather Vault State

Determine the notes folder by checking which domain-named directory exists (notes/, reflections/, concepts/, ideas/, decisions/, memories/, or any custom name from derivation-manifest.md). Then gather counts:

• Note count: .md files in the notes folder, excluding MOCs (files with type: moc in frontmatter)
• Inbox count: .md files in the inbox folder (inbox/, journal/, encounters/, etc.)
• Observation count: .md files in ops/observations/ or ops/methodology/
• Tension count: .md files in ops/tensions/
• Connection density: count wiki links ([[) across notes folder; sparse if fewer than 2x note count
• Queue state: pending tasks in ops/queue/queue.yaml or ops/queue/queue.json
• Health warnings: check latest report in ops/health/ if it exists
• Tutorial state: check ops/tutorial-state.yaml for incomplete tutorial
• Session count: estimate from ops/sessions/ file count (indicates usage maturity)

# Quick state gathering
note_count=$(ls -1 {vocabulary.notes}/*.md 2>/dev/null | wc -l | tr -d ' ')
inbox_count=$(ls -1 {vocabulary.inbox}/*.md 2>/dev/null | wc -l | tr -d ' ')
obs_count=$(ls -1 ops/observations/*.md ops/methodology/*.md 2>/dev/null | wc -l | tr -d ' ')
tension_count=$(ls -1 ops/tensions/*.md 2>/dev/null | wc -l | tr -d ' ')

Step 2: Resolve Domain Vocabulary

Read ops/derivation-manifest.md (or fall back to ops/derivation.md Vocabulary Mapping section). Extract domain-native names for: reduce, reflect, reweave, verify, rethink, note, MOC, inbox. If neither file exists, use universal names.