From e23a63d59a743b92e5543c0a2e9ffeac60ed716b Mon Sep 17 00:00:00 2001 From: gnekt Date: Mon, 23 Mar 2026 16:08:47 +0100 Subject: [PATCH] Add "Suggested new agent" capability to all 7 non-architect agents Each agent now has a "When to suggest a new agent" subsection inside its Inter-Agent Coordination block. When an agent detects that the user needs functionality that no existing agent can handle, it outputs a "Suggested new agent" section with: - Need: what capability is missing - Reason: why no existing agent covers it - Suggested role: what the new agent would do The dispatcher reads this and asks the user if they want the Architect to create a custom agent for the detected need. Agents are also told when NOT to suggest a new agent (existing agent can handle it, one-off task, outside vault scope). --- agents/connector.md | 23 +++++++++++++++++++++++ agents/librarian.md | 23 +++++++++++++++++++++++ agents/postman.md | 23 +++++++++++++++++++++++ agents/scribe.md | 23 +++++++++++++++++++++++ agents/seeker.md | 23 +++++++++++++++++++++++ agents/sorter.md | 23 +++++++++++++++++++++++ agents/transcriber.md | 23 +++++++++++++++++++++++ 7 files changed, 161 insertions(+) diff --git a/agents/connector.md b/agents/connector.md index 8475a57..afaaa93 100644 --- a/agents/connector.md +++ b/agents/connector.md @@ -57,6 +57,29 @@ When you detect work that another agent should handle, include a `### Suggested For the full orchestration protocol, see `.claude/references/agent-orchestration.md`. For the agent registry, see `.claude/references/agents-registry.md`. +### When to suggest a new agent + +If you detect that the user needs functionality that NO existing agent provides, include a `### Suggested new agent` section in your output. The dispatcher will consider invoking the Architect to create a custom agent. + +**When to signal this:** +- The user repeatedly asks for something outside any agent's capabilities +- The task requires a specialized workflow that none of the current agents handle +- The user explicitly says they wish an agent existed for a specific purpose + +**Output format:** + +```markdown +### Suggested new agent +- **Need**: {what capability is missing} +- **Reason**: {why no existing agent can handle this} +- **Suggested role**: {brief description of what the new agent would do} +``` + +**Do NOT suggest a new agent when:** +- An existing agent can handle the task (even imperfectly) +- The user is asking something outside the vault's scope entirely +- The task is a one-off that does not warrant a dedicated agent + --- ## Analysis Modes diff --git a/agents/librarian.md b/agents/librarian.md index 5972bbd..4d8cb98 100644 --- a/agents/librarian.md +++ b/agents/librarian.md @@ -63,6 +63,29 @@ If the vault still has a `Meta/agent-messages.md` file from the old messaging sy For the full orchestration protocol, see `.claude/references/agent-orchestration.md`. For the agent registry, see `.claude/references/agents-registry.md`. +### When to suggest a new agent + +If you detect that the user needs functionality that NO existing agent provides, include a `### Suggested new agent` section in your output. The dispatcher will consider invoking the Architect to create a custom agent. + +**When to signal this:** +- The user repeatedly asks for something outside any agent's capabilities +- The task requires a specialized workflow that none of the current agents handle +- The user explicitly says they wish an agent existed for a specific purpose + +**Output format:** + +```markdown +### Suggested new agent +- **Need**: {what capability is missing} +- **Reason**: {why no existing agent can handle this} +- **Suggested role**: {brief description of what the new agent would do} +``` + +**Do NOT suggest a new agent when:** +- An existing agent can handle the task (even imperfectly) +- The user is asking something outside the vault's scope entirely +- The task is a one-off that does not warrant a dedicated agent + --- ## Audit Modes diff --git a/agents/postman.md b/agents/postman.md index 82d310b..60fc2a6 100644 --- a/agents/postman.md +++ b/agents/postman.md @@ -67,6 +67,29 @@ When you detect work that another agent should handle, include a `### Suggested For the full orchestration protocol, see `.claude/references/agent-orchestration.md`. For the agent registry, see `.claude/references/agents-registry.md`. +### When to suggest a new agent + +If you detect that the user needs functionality that NO existing agent provides, include a `### Suggested new agent` section in your output. The dispatcher will consider invoking the Architect to create a custom agent. + +**When to signal this:** +- The user repeatedly asks for something outside any agent's capabilities +- The task requires a specialized workflow that none of the current agents handle +- The user explicitly says they wish an agent existed for a specific purpose + +**Output format:** + +```markdown +### Suggested new agent +- **Need**: {what capability is missing} +- **Reason**: {why no existing agent can handle this} +- **Suggested role**: {brief description of what the new agent would do} +``` + +**Do NOT suggest a new agent when:** +- An existing agent can handle the task (even imperfectly) +- The user is asking something outside the vault's scope entirely +- The task is a one-off that does not warrant a dedicated agent + --- ## Philosophy diff --git a/agents/scribe.md b/agents/scribe.md index 7eff0fb..5975833 100644 --- a/agents/scribe.md +++ b/agents/scribe.md @@ -58,6 +58,29 @@ When you detect work that another agent should handle, include a `### Suggested For the full orchestration protocol, see `.claude/references/agent-orchestration.md`. For the agent registry, see `.claude/references/agents-registry.md`. +### When to suggest a new agent + +If you detect that the user needs functionality that NO existing agent provides, include a `### Suggested new agent` section in your output. The dispatcher will consider invoking the Architect to create a custom agent. + +**When to signal this:** +- The user repeatedly asks for something outside any agent's capabilities +- The task requires a specialized workflow that none of the current agents handle +- The user explicitly says they wish an agent existed for a specific purpose + +**Output format:** + +```markdown +### Suggested new agent +- **Need**: {what capability is missing} +- **Reason**: {why no existing agent can handle this} +- **Suggested role**: {brief description of what the new agent would do} +``` + +**Do NOT suggest a new agent when:** +- An existing agent can handle the task (even imperfectly) +- The user is asking something outside the vault's scope entirely +- The task is a one-off that does not warrant a dedicated agent + --- ## Core Philosophy diff --git a/agents/seeker.md b/agents/seeker.md index 5d94d8d..5cffce6 100644 --- a/agents/seeker.md +++ b/agents/seeker.md @@ -59,6 +59,29 @@ The Seeker is often the agent that discovers unexpected things while searching. For the full orchestration protocol, see `.claude/references/agent-orchestration.md`. For the agent registry, see `.claude/references/agents-registry.md`. +### When to suggest a new agent + +If you detect that the user needs functionality that NO existing agent provides, include a `### Suggested new agent` section in your output. The dispatcher will consider invoking the Architect to create a custom agent. + +**When to signal this:** +- The user repeatedly asks for something outside any agent's capabilities +- The task requires a specialized workflow that none of the current agents handle +- The user explicitly says they wish an agent existed for a specific purpose + +**Output format:** + +```markdown +### Suggested new agent +- **Need**: {what capability is missing} +- **Reason**: {why no existing agent can handle this} +- **Suggested role**: {brief description of what the new agent would do} +``` + +**Do NOT suggest a new agent when:** +- An existing agent can handle the task (even imperfectly) +- The user is asking something outside the vault's scope entirely +- The task is a one-off that does not warrant a dedicated agent + --- ## Search & Retrieval Modes diff --git a/agents/sorter.md b/agents/sorter.md index 3cc5fb8..d5af6ff 100644 --- a/agents/sorter.md +++ b/agents/sorter.md @@ -58,6 +58,29 @@ Always include your proposed solution and what you did in the meantime. Then **c For the full orchestration protocol, see `.claude/references/agent-orchestration.md`. For the agent registry, see `.claude/references/agents-registry.md`. +### When to suggest a new agent + +If you detect that the user needs functionality that NO existing agent provides, include a `### Suggested new agent` section in your output. The dispatcher will consider invoking the Architect to create a custom agent. + +**When to signal this:** +- The user repeatedly asks for something outside any agent's capabilities +- The task requires a specialized workflow that none of the current agents handle +- The user explicitly says they wish an agent existed for a specific purpose + +**Output format:** + +```markdown +### Suggested new agent +- **Need**: {what capability is missing} +- **Reason**: {why no existing agent can handle this} +- **Suggested role**: {brief description of what the new agent would do} +``` + +**Do NOT suggest a new agent when:** +- An existing agent can handle the task (even imperfectly) +- The user is asking something outside the vault's scope entirely +- The task is a one-off that does not warrant a dedicated agent + --- ## Triage Modes diff --git a/agents/transcriber.md b/agents/transcriber.md index 11429c3..030c1b4 100644 --- a/agents/transcriber.md +++ b/agents/transcriber.md @@ -60,6 +60,29 @@ When you detect work that another agent should handle, include a `### Suggested For the full orchestration protocol, see `.claude/references/agent-orchestration.md`. For the agent registry, see `.claude/references/agents-registry.md`. +### When to suggest a new agent + +If you detect that the user needs functionality that NO existing agent provides, include a `### Suggested new agent` section in your output. The dispatcher will consider invoking the Architect to create a custom agent. + +**When to signal this:** +- The user repeatedly asks for something outside any agent's capabilities +- The task requires a specialized workflow that none of the current agents handle +- The user explicitly says they wish an agent existed for a specific purpose + +**Output format:** + +```markdown +### Suggested new agent +- **Need**: {what capability is missing} +- **Reason**: {why no existing agent can handle this} +- **Suggested role**: {brief description of what the new agent would do} +``` + +**Do NOT suggest a new agent when:** +- An existing agent can handle the task (even imperfectly) +- The user is asking something outside the vault's scope entirely +- The task is a one-off that does not warrant a dedicated agent + --- ## Intake Interview