Use when the user mentions a topic, idea, project, meeting, or anything they want to capture in their brain. Triggers on "I've had an idea", "I was thinking about", "we had a meeting", "I want to spec out", or any new thing to record.
Use when the user asks to find connections, related notes, or links for a specific note. Triggers on "what is this connected to", "find related notes", "wire this up", or a filepath with a request to surface links.
Use when starting work on a project with a brain effort linked, when the user mentions a topic or project name, or when the SessionStart hook indicates an effort is available. Searches the second-brain for prior context before starting work.
Use when the user wants to create a new effort, set up an effort for a topic, or says "new effort for X", "create an effort on X", "start an effort around X". Distinct from brain-project which is for software projects with full scaffolding.
Use when the user wants to create or update a context primer from one or more source notes. Triggers on "create a context primer from these", "distil my research into a primer", "make a primer for X from Y and Z", "build a context primer".
Use when the user wants a status overview of an effort, asks "where does X stand", "what's in the X effort", or wants to see all notes related to an ongoing area of work.
Use when the user wants to set up their brain for the first time, or says "set up my brain", "initialise my brain", "help me get started". Guides a structured onboarding session to create the first effort, context-primer, and initial notes.
Use when the user asks what they've set aside, wants to review parked or simmering work, or says "what's simmering", "what am I not working on", "surface what I've put down", "what have I abandoned", "what's on the back burner".
Use when the user wants to triage their discovery notes, review unreviewed captures, or work through notes awaiting a decision. Triggers on "triage", "what's waiting for review", "review my notes", "what needs triaging".
Use when the user wants to start their day, open today's daily note, or do a morning review. Triggers on "daily note", "start my day", "morning review", "what's on today", or at the start of a session with no specific topic.
Use when the user wants to break a long note into atomic pieces, extract ideas from a source note into separate cards, or says "pull the ideas out of this note". Useful for processing meeting notes, articles, or long discoveries.
Use when asked to tidy, audit, or health-check the second-brain — checks frontmatter completeness, orphaned notes, broken wikilinks, and stale drafts. Can fix broken wikilinks and restructure files.
Use when the user wants to rename a note or file in the brain. Triggers on "rename", "move this note", "change the title of". Updates all wikilinks across the brain automatically.
Use when the user wants to move notes into an effort, consolidate scattered notes, migrate documents, or says "move X into effort Y", "consolidate these into X", "pull these docs into Y", "reorganise effort X".