second-brain-mappinglisted

# /second-brain-mapping Your vault is a database. This skill makes it queryable. ## What it does | Phase | Tool | LLM cost | Always runs? | |---|---|---|---| | 1 | `vault-metadata-extract.py` (dispatcher → type-specific extractors) | **0 tokens** | Yes | | 2 | `/graphify` (optional) | ~100k–1M tokens | No — asks first | | 3 | Wikilink gaps + interactive apply | ~5k tokens | If graph exists | | 4 | `vault-insight-engine.py` — cross-type surprise finder | **0 tokens** | Yes | Phases 1 and 4 are free. Phase 2 is expensive and opt-in. Phase 3 needs interactive approval so it skips gracefully in non-TTY contexts. ## Setup Run once after cloning ai-brain-starter: ``` /setup-vault-types ``` Interactive wizard asks which doc types you have (journal, book, article, meeting, person, project, podcast, client, etc.) and installs the matching extractors. You can add custom types later by editing `scripts/extractors/schemas.yaml` or running `/setup-vault-types --add <name>`. ## Usage ```bash /second-brain-mapping # full pipeline /second-brain-mapping --metadata-only # skip graphify + wikilinks, keep insights /second-brain-mapping --insights-only # only run Phase 4 on existing metadata /second-brain-mapping --type book # only process files with `type: book` /second-brain-mapping --dry-run # preview without writes /second-brain-mapping --sample # preview 1 file per configured type (cold-start safe) /second-brain-mapping --sample 3 # preview 3 f