docs(work): add research subagent and refactor alan prompt

This commit is contained in:
2026-05-21 09:53:49 -04:00
parent cf0ed34926
commit 495f5e9c07
6 changed files with 441 additions and 298 deletions

View File

@@ -6,8 +6,38 @@ Subagents are runtime processes exposed as MCP tools. The canonical prompt text
## Catalog
### research
**Purpose:** Answer a question by querying both the public web and Robert's Neo4j memory in parallel, then synthesizing one integrated response with conflicts flagged and suggested memory updates surfaced.
**Composition:** `fast.parallel` of three sub-agents:
- `web_search` — argos
- `memory_lookup` — neo4j (read-only); framed around work-team node types (clients, opportunities, engagements, decisions, technologies, contacts)
- `synthesizer` — merges the two reports, flags conflicts, suggests which node type a memory update would belong on
**Tools:** argos, neo4j_cypher
**When to delegate:**
- Pre-meeting prep on a client or contact — what's already in the graph, plus current public information (recent news, funding, leadership changes)
- Opportunity qualification where the answer might exist in prior `Decision` or `Technology` nodes AND on the public web
- "What do we already know about X, and what's the current public information on it?" against the work pipeline
- When a lead wants memory-aware research without burning its own context on parallel queries
**When NOT to delegate:**
- Quick web lookups where memory isn't relevant — use argos directly
- Pure graph queries on a known client or opportunity — query Neo4j directly
- AWS architecture design questions — use `aws-sa`
- Deep library/framework/API research — that lives in engineering's `tech_research`. If work needs it regularly, copy it here per the cross-team-reuse convention.
**Prompt:** [prompts/work/subagents/research.md](../../prompts/work/subagents/research.md)
**Runtime:** TBD — copy of engineering's `kottos/agents/research.py` with the work-team memory framing applied. Port to be assigned when wired up.
---
### aws-sa
**Purpose:** AWS cloud architecture design. Selects services, defines how they connect, evaluates trade-offs, estimates costs, and produces architecture diagrams as SVG. Follows the AWS Well-Architected Framework across all six pillars.
**Composition:** Single `fast.agent` with detailed instructions covering Well-Architected principles, SVG diagram production rules, and the requirements-then-design workflow.