# Agent Registry This file is the **single source of truth** for all active agents in the crew. The dispatcher (`DISPATCHER.md`) and all agents reference this file for routing decisions and inter-agent coordination. The registry is designed to grow: custom agents (see Issue #12) are added as new rows following the same schema. --- ## Registry | Name | Role | Capabilities | Input | Output | Status | |------|------|-------------|-------|--------|--------| | architect | Vault Structure & Governance | Create/modify folders, templates, MOCs, tag taxonomy, naming conventions. Full Bash access. Runs onboarding. | Vault setup, new areas/projects, structural changes, defrag, onboarding | Folders created, templates defined, structure updated, MOCs generated | active | | scribe | Text Capture & Refinement | Create notes in `00-Inbox/`, format raw text, handle voice-to-note, brainstorm, quotes, reading notes | Raw text, ideas, thoughts, voice input, quotes, brainstorm requests | Structured notes in `00-Inbox/` with frontmatter, tags, suggested connections | active | | sorter | Inbox Triage & Filing | Move notes from inbox to correct locations, update MOCs, batch processing | Inbox triage, filing requests, note organization | Notes moved to correct folders, MOCs updated, triage reports | active | | seeker | Search & Intelligence | Full-text search, metadata queries, relationship navigation, answer synthesis. Read-only by default. | Search queries, "find X", "where did I put", factual questions about vault content | Search results with citations, synthesized answers, knowledge gap reports | active | | connector | Knowledge Graph & Link Analysis | Add/edit wikilinks, analyze graph structure, discover connections, bridge notes | Link analysis, "find connections", graph health, serendipity requests | New wikilinks added, graph health score, connection maps, bridge notes | active | | librarian | Vault Health & Quality Assurance | Detect/merge duplicates, fix broken links, audit frontmatter, growth analytics. Full Bash access. | Maintenance, audit, cleanup, health check, duplicate detection | Health reports, fixed links, merged duplicates, consistency reports | active | | transcriber | Audio & Meeting Intelligence | Process transcriptions into structured notes, extract action items, speaker detection | Audio recordings, transcriptions, meeting notes, lecture/podcast processing | Structured meeting/lecture notes in `00-Inbox/` with action items, decisions, topics | active | | postman | Email & Calendar Intelligence | Read/archive/delete email (Gmail via `gws`, Hey.com via `hey`), search emails, read/create/update calendar events, draft and send replies. Uses Google Workspace CLI (`gws`) and/or Hey CLI (`hey`) via Bash, with MCP as read-only fallback. | Email triage, calendar queries, deadline tracking, meeting prep, VIP filtering | Email summaries saved as notes in `00-Inbox/`, calendar events created, deadline reports | active | --- ## Status Values - **active**: Agent is operational and available for dispatch - **disabled**: Agent is temporarily disabled — the dispatcher will skip it --- ## How This File Is Used 1. **Dispatcher** reads the `Input` column to match user messages to agents 2. **Dispatcher** reads `Output` + `Capabilities` of other agents to decide if chaining is needed after an agent returns 3. **Agents** reference this file when suggesting next agents in their output 4. **Custom agents** are added as new rows by the Architect during the custom agent creation flow --- ## Custom Agents Custom agents are created by the Architect through a conversational flow with the user. They follow the exact same schema as core agents and are added as new rows in the Registry table above. ### How Custom Agents Are Added 1. The user asks the Architect to create a new agent (or an existing agent suggests one via `### Suggested new agent`) 2. The Architect conducts a detailed conversation to understand requirements 3. The Architect generates the agent file in `.platform/agents/`, adds a row to the Registry table above, and updates `agents.md` 4. The platform auto-discovers the new agent from its frontmatter ### Naming Rules - Custom agent names must be lowercase, hyphens only (e.g., `habit-tracker`, `recipe-manager`) - Names must NOT conflict with core agent names: architect, scribe, sorter, seeker, connector, librarian, transcriber, postman - Names should be descriptive and concise (1-2 words) ### Priority Custom agents always have lower routing priority than the 8 core agents. The dispatcher checks custom agents only when no core agent matches the user's message. Among custom agents, the dispatcher uses the Input column to find the best match --- ## Skills Registry Skills handle complex, multi-step workflows extracted from agents. They are checked **before** agents by the dispatcher (higher priority). Skills run in the main conversation context via the Skill tool, preserving multi-turn state. | Skill | Source Agent | Triggers | Purpose | Status | |-------|-------------|----------|---------|--------| | `/onboarding` | architect | "initialize the vault", "set up the vault", "onboarding", "vault setup" | Full vault setup conversation | active | | `/create-agent` | architect | "create a new agent", "custom agent", "I need a new agent", "build an agent", "new crew member" | Custom agent creation (6-phase interview) | active | | `/manage-agent` | architect | "edit my agent", "update agent", "remove agent", "delete agent", "list agents", "show my agents" | Edit, remove, list custom agents | active | | `/defrag` | architect | "defragment the vault", "reorganize the vault", "structural maintenance", "vault defrag", "weekly defrag" | Weekly vault defragmentation (5-phase audit) | active | | `/email-triage` | postman | "check my email", "what's in my inbox", "process emails", "email triage", "anything urgent in email?" | Email scanning, priority scoring, classification | active | | `/meeting-prep` | postman | "prepare for meeting", "meeting prep", "brief me for the meeting", "get ready for the call" | Comprehensive meeting brief with context gathering | active | | `/weekly-agenda` | postman | "weekly agenda", "what's this week", "week overview", "plan my week" | Day-by-day week overview from calendar, email, vault | active | | `/deadline-radar` | postman | "deadline radar", "what are my deadlines", "this week's deadlines", "upcoming deadlines" | Unified deadline timeline with urgency grouping | active | | `/transcribe` | transcriber | "transcribe", "I have a recording", "process this audio", "meeting notes from recording", "summarize the call" | Audio/transcript processing with structured notes | active | | `/vault-audit` | librarian | "weekly review", "check the vault", "vault audit", "full audit", "vault health" | Full 7-phase vault audit | active | | `/deep-clean` | librarian | "deep clean", "deep cleanup", "thorough cleanup", "the vault is a mess" | Extended vault cleanup with stale content detection | active | | `/tag-garden` | librarian | "tag garden", "clean up tags", "tag cleanup", "tag audit" | Tag analysis: unused, orphan, near-duplicates | active | | `/inbox-triage` | sorter | "triage the inbox", "clean up the inbox", "sort my notes", "empty inbox", "file my notes", "process the inbox" | Inbox note processing, classification, and routing | active | | `/contact-sync` | postman | "sync contact", "add to contacts", "save contact", "update contact", "is this person in my contacts" | Sync person to Apple Contacts (search, create, update). Requires `apple-contacts` MCP. | active | ### How Skills Are Routed 1. The dispatcher checks the **skill routing table** (in `DISPATCHER.md`) before the agent routing table 2. If a trigger matches, the skill is invoked via the **Skill tool** — not the Agent tool 3. If no skill matches, the dispatcher falls through to agent routing 4. Skills can produce `### Suggested next agent` output, which the dispatcher handles using the same chaining rules as agents