analyzeUse when synthesising across prose and code corpora or ranking candidates by a criterion — tries the analyze plan library first (search → reference-chain traversal → rank → generate), inline-plans on a miss.
architectureUse when complex features need architectural design before implementation, or when system design decisions span multiple modules
asksUse when the user asks to go through, work through or answer the asks waiting on them, or to relay answers to the sessions that raised them (RDR-245 structured asks on the threads board)
brainstorming-gateUse when about to implement any feature, build any component, or make any behavioral change — requires design exploration and user approval before implementation
catalogUse when working with catalog entries, resolving tumblers, creating links, understanding what's linked to a file, or seeding link context for the auto-linker. Covers resolve, link, context, and seed operations.
cli-controllerUse when controlling interactive CLI applications, debugging with pdb/gdb/jshell, spawning Claude Code instances, or working with REPLs and long-running processes
codebase-analysisUse when exploring an unfamiliar codebase, onboarding to a project, or needing to understand module structure before making changes
composition-probeUse when a coordinator bead's inter-bead composition needs verification before downstream beads begin
decision-drift-reviewUse when critiquing a change set against decision history to check it hasn't drifted from what an RDR decided — not for routine code review, that's the `code-review-expert` agent.
deep-analysisUse when surface-level analysis is insufficient and problems require hypothesis-driven investigation across multiple system components
design-to-code-traceUse when doing design / architecture / planning work that walks from prose (RDRs, docs, knowledge) into the modules implementing a concept — not for open-ended topic research, that's /conexus:research-synthesis
documentUse when authoring or auditing documentation against existing coverage — tries the document plan library first (search prose/code → documentation-for traversal → compare), inline-plans on a miss.
enrich-planUse when beads need enrichment with execution context — file paths, code patterns, constraints, test commands.
finishing-branchUse when implementation is complete, all tests pass, and you need to decide how to integrate the work - guides completion of development work by presenting structured options for merge, PR, or cleanup
git-worktreesUse when starting feature work that needs isolation from current workspace, before executing implementation plans, or when MORE THAN ONE SESSION is working on one checkout - creates isolated git worktrees with smart directory selection and safety verification
knowledge-tidyingUse when validated findings need to be consolidated in the T3 knowledge store.
mailboxUse when sending or draining a mailbox tuple-space message between agents or instances, or when authoring or reviewing code against the mailbox/ADDRESS template
nexusUse when running nx commands for search, memory, knowledge storage, or indexing — or when unsure which nx subcommand to use
orchestrationUse when unsure which agent or skill fits a task, or when dispatching and gating agents (briefs, review gate, debugger escalation, pipelines)
peer-messagingUse when sending to, waiting on, or answering another Claude session or dispatched agent, when a message from one arrives, or when two sessions on one machine need the same checkout, build, or test capacity
phase-review-gateUse when a phase boundary is being closed — cross-walk RDR §Approach against closing beads to catch silent scope reduction before it is discovered mid-implementation
plan-firstUse when starting a retrieval task whose answer must be reduced from many documents — routes through nx_answer, which matches the plan library first and inline-plans on a miss. Raw search/query covers file:line or single-fact lookups, in seconds.
plan-validationUse when a plan needs validation before implementation — catches gaps and codebase misalignment.
rdr-accept-checklistUse when a gated RDR returned PASSED and you want to officially accept it for implementation
rdr-audit-checklistUse when auditing a project's RDR lifecycle for silent-scope-reduction frequency, or when inspecting or managing scheduled periodic audits
rdr-closeUse when an RDR is done — close it with optional post-mortem, bead status gate, and T3 archival
rdr-createUse when starting a new research-design-review document to think through a technical decision
rdr-fix-checklistUse when a gated RDR has findings to fix — prints the findings with their sites, the diff since the gated commit, the pre-edit research title, and the fix rules
rdr-gate-checklistUse when an RDR appears complete and needs finalization validation — structural, assumption, and AI critique checks
rdr-researchUse when adding, tracking, or verifying structured research findings for an active RDR
rdr-showUse when needing detailed information about a specific RDR including content, research findings, and linked beads
receiving-reviewUse when receiving any code review feedback, before implementing any suggestion - requires technical rigor and verification, not performative agreement or blind implementation
research-synthesisUse when researching unfamiliar topics, comparing technology approaches, or building comprehensive understanding from multiple sources
serena-code-navUse when navigating code by symbol — finding definitions, all callers, type hierarchies, renaming safely, or editing a method body without reading the whole file. Use instead of Grep for any symbol-level task.
strategic-planningUse when facing multi-step development work that needs decomposition into tasks, before writing any implementation code
substantive-critiqueUse when architectural decisions, implementations, or documentation need deep constructive critique against specs or evidence
tumbler-footnotesUse when a markdown file cites the catalog as `[label](nx://catalog/TUMBLER)` links and needs those converted to footnotes that GitHub/GitLab/VS Code actually render, or checked/reversed — drives nx catalog footnotes.
upgradeUse when a user wants to upgrade nexus, migrate an existing store onto the service stack, asks what upgrade steps their install needs, is blocked on a migration, or is holding an old/dormant install that may carry era debt
why-was-this-writtenUse when the design intent behind a failing code path must be reduced from several RDRs/notes before trusting a fix — not for dispatching a debugger, that's the debugger agent.
writing-nx-skillsUse when creating new conexus plugin skills, editing existing skills, verifying skill quality before committing, or promoting a memory file into a skill, script or hook