brain-os

Use when extracting deep insights from a book and connecting them to vault zones (business, personal, thinking)

Capture key moments mid-session with full context. Triggers on natural language: aha, mark this, key moment, that's interesting, remember this decision, this is important, breakthrough

Extract knowledge từ Airtable bases vào vault dưới dạng linked entity pages. Sonnet worker + Opus reviewer ≥95% gate, mandatory HITL re-anchor mỗi base mới. Use khi seeding historical knowledge từ company Airtable bases.

One-shot principle check via advisor. Use when you want to stress-test a decision, plan, or code against your principles — non-interactive, returns findings. For interactive stress-testing, use /grill instead.

Investigate reported bug across code + config + cloud + vault state, file brain-os GH issue với /tdd RED-GREEN fix plan. Use khi skill output sai, cron produces nothing, hook misbehaves, hoặc user nói 'why is X broken'/'debug this'/'/debug'.

Use when testing skill correctness after editing, or wanting to verify all skills pass their eval checks

One-time Gmail setup: scan 3 months of inbox history to build gmail-rules.md with sender patterns, importance signals, and cleanup rules. Use when setting up Gmail automation for the first time or refreshing email rules.

Execute Gmail triage actions — cleanup inbox (archive, delete, label, star, unsubscribe), draft replies, and process pending triage reports from vault. Use when user says /gmail, wants to clean inbox, process email actions, or draft email replies.

Mode B grill: pre-grill internally, render 3 candidate decision-tree architectures side-by-side as ASCII, batch parameter picks. Use for architecture / system-design topics where most LLM recommendations would just get 'ok' — converges in 2-3 turns vs /grill's question-by-question march. Falls back to /grill for single-decision or pure-exploration topics where 3 trees would be artificial.

Interview the user relentlessly about a topic until reaching a bulletproof, actionable plan. Use when user says 'grill me', 'stress-test this plan', 'poke holes in this', or wants to be challenged on every aspect of a design, strategy, or decision.

Use when ending a session with unfinished work that needs to be continued in a future session

Per-issue implementation executor — grab next AFK issue, run /tdd, commit + push + close. Modes: /impl N (specific issue), /impl story <N> (story DAG), /impl auto (drain queue), /impl -p N (parallel workers). Use khi drain AFK backlog hoặc execute approved story.

Analyze skill outcomes + user corrections để propose self-improvements. Triggers: 'improve', 'skill learning', 'why does this skill keep getting it wrong', '/improve [skill-name]'.

Use when processing raw knowledge input (book notes, highlights, raw files) into structured vault notes

Aggregate daily working journey across all repos and sessions into structured content material for the '100 days building AI Brain OS' series. Triggers on: journal, daily journey, what did I do today, extract journey, content material

Use when starting a new session and wanting to resume unfinished work from a previous handover

System-level reorganization scan — detects shallow modules, cross-skill duplication, unused code, vault drift. Use khi user nói 'reorganize'/'refactor'/'audit architecture'/'system-level review'. Khác /improve (per-skill) và /vault-lint (mechanical hygiene).

Use when needing to research a topic from the web — scans X and web for state-of-the-art thinking from top voices, synthesizes into bullet points with citations, and optionally ingests into vault

Use when mastering a book's content through autonomous extraction, validation against NotebookLM, and knowledge extension

Break grill-session/plan/PRD thành parent story issue + child issues theo tracer-bullet vertical slices. Children có `## Parent` + `## Blocked by`. Use khi convert grill outcome thành AFK tickets, file vào sonthanh/ai-brain. Triggers: 'slice this', '/slice', 'break into issues'.

Use when user wants a briefing on current state — tasks, emails, handovers, priorities. Reads a lazily-regenerated cache. Triggers on: status, what should I do, what's pending, brief me, morning review, wrap up, end of day

Use when running the complete knowledge pipeline for a book, from self-learn through ingestion, verification, absorption, and sync

Test-driven development for brain-os artifacts via red-green-refactor. Use when building or fixing skills, scripts, hooks, plists, or vault tooling — mention 'red-green-refactor', 'TDD', 'test-first', 'tracer bullet', or invoke with /tdd.

Use when entering deep thinking mode, exploring ideas, finding patterns, or reflecting on vault content. Also triggers on: challenge, stress-test, emerge, drift, trace, connect, ideas, ghost, brainstorm, what if, poke holes

Transcribe YouTube/podcast/audio URL ra clean text. Auto-captions trước, fallback whisper-cpp + Silero VAD. Use trước khi /research video/audio source, hoặc user nói 'transcribe'/'get the transcript'/'get raw quotes from'.

Nightly vault maintenance — fix broken wiki-links, detect orphan pages, sync directory indexes, flag stale GH-issue tasks. Use cho: vault maintenance, broken links, orphan pages, nightly cron, lint vault.

Use when verifying ingested book knowledge against NotebookLM, checking verification status, or managing audit flags before absorbing

5 hooks across 3 events