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).
This commit is contained in:
gnekt
2026-03-23 16:08:47 +01:00
parent 0fb773f745
commit e23a63d59a
7 changed files with 161 additions and 0 deletions

View File

@@ -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

View File

@@ -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

View File

@@ -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

View File

@@ -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

View File

@@ -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

View File

@@ -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

View File

@@ -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