name: dipeo-backend
description: Router skill for DiPeO backend ecosystem (server/ and cli/): FastAPI server, CLI tools, database, MCP integration. Use when task mentions CLI commands, server endpoints, database queries, or MCP tools. For simple tasks, handle directly; for complex work, escalate to dipeo-backend agent.
allowed-tools: Read, Grep, Glob, Bash, Skill
DiPeO Backend Router
Domain: Backend ecosystem including FastAPI server (server/), CLI tools (cli/), message store, and MCP integration. Database schema initialization is in /dipeo/infrastructure/execution/state/persistence_manager.py (package-maintainer domain).
Quick Decision: Skill or Agent?
✅ Handle Directly (This Skill)
- Simple changes: <20 lines, 1-2 files
- Read-only tasks: Understanding code, reviewing configs, debugging logs
- Documentation lookup: CLI help, API signatures, database schema
- Small config tweaks: Environment variables, command flags
❌ Escalate to Agent
- Complex features: Multi-file changes, new CLI commands, database migrations
- Architecture changes: New API endpoints, MCP tool implementation
- Cross-cutting concerns: Affects CLI + database + execution engine
- Uncertain scope: Not sure how many files will change
Agent: Task(dipeo-backend, "your detailed task description")
Documentation Sections (Load On-Demand)
Use Skill(doc-lookup) with these anchors when you need detailed context:
Core Responsibilities:
docs/agents/backend-development.md#core-responsibilities - CLI, FastAPI server, database, MCP server
Implementation Patterns:
docs/agents/backend-development.md#common-patterns - CLI, background execution, database, MCP patterns
Troubleshooting:
docs/agents/backend-development.md#troubleshooting - Server, CLI, database, MCP issues
MCP Integration:
docs/features/mcp-server-integration.md#quick-start - Setup and usage guidedocs/features/chatgpt-mcp-integration.md#quick-start - ChatGPT connection
Example doc-lookup call:
python .claude/skills/doc-lookup/scripts/section_search.py \
--query "cli-commands" \
--paths docs/agents/backend-development.md \
--top 1
Escalation to Other Agents
To dipeo-package-maintainer: Execution handlers, service architecture, domain models, LLM infrastructure
To dipeo-codegen-pipeline: GraphQL schema changes, generated type issues, TypeScript specs
Typical Workflow
- Assess task complexity: Simple (handle) vs. complex (escalate)
- If simple: Load relevant section via
Skill(doc-lookup)
- Execute: Make changes or provide answer
- If complex: Escalate with
Task(dipeo-backend, "task details")
1---2name: dipeo-backend3description: Router skill for DiPeO backend ecosystem (server/ and cli/): FastAPI server, CLI tools, database, MCP integration. Use when task mentions CLI commands, server endpoints, database queries, or MCP tools4---5
6---
7name: dipeo-backend
8description: Router skill for DiPeO backend ecosystem (server/ and cli/): FastAPI server, CLI tools, database, MCP integration. Use when task mentions CLI commands, server endpoints, database queries, or MCP tools. For simple tasks, handle directly; for complex work, escalate to dipeo-backend agent.
9allowed-tools: Read, Grep, Glob, Bash, Skill
10---
11
12# DiPeO Backend Router
13
14**Domain**: Backend ecosystem including FastAPI server (`server/`), CLI tools (`cli/`), message store, and MCP integration. Database schema initialization is in `/dipeo/infrastructure/execution/state/persistence_manager.py` (package-maintainer domain).
15
16## Quick Decision: Skill or Agent?
17
18### ✅ Handle Directly (This Skill)
19- **Simple changes**: <20 lines, 1-2 files
20- **Read-only tasks**: Understanding code, reviewing configs, debugging logs
21- **Documentation lookup**: CLI help, API signatures, database schema
22- **Small config tweaks**: Environment variables, command flags
23
24### ❌ Escalate to Agent
25- **Complex features**: Multi-file changes, new CLI commands, database migrations
26- **Architecture changes**: New API endpoints, MCP tool implementation
27- **Cross-cutting concerns**: Affects CLI + database + execution engine
28- **Uncertain scope**: Not sure how many files will change
29
30**Agent**: `Task(dipeo-backend, "your detailed task description")`
31
32## Documentation Sections (Load On-Demand)
33
34Use `Skill(doc-lookup)` with these anchors when you need detailed context:
35
36**Core Responsibilities**:
37- `docs/agents/backend-development.md#core-responsibilities` - CLI, FastAPI server, database, MCP server
38
39**Implementation Patterns**:
40- `docs/agents/backend-development.md#common-patterns` - CLI, background execution, database, MCP patterns
41
42**Troubleshooting**:
43- `docs/agents/backend-development.md#troubleshooting` - Server, CLI, database, MCP issues
44
45**MCP Integration**:
46- `docs/features/mcp-server-integration.md#quick-start` - Setup and usage guide
47- `docs/features/chatgpt-mcp-integration.md#quick-start` - ChatGPT connection
48
49**Example doc-lookup call**:
50```bash
51python .claude/skills/doc-lookup/scripts/section_search.py \
52 --query "cli-commands" \
53 --paths docs/agents/backend-development.md \
54 --top 1
55```
56
57## Escalation to Other Agents
58
59**To dipeo-package-maintainer**: Execution handlers, service architecture, domain models, LLM infrastructure
60**To dipeo-codegen-pipeline**: GraphQL schema changes, generated type issues, TypeScript specs
61
62## Typical Workflow
63
641. **Assess task complexity**: Simple (handle) vs. complex (escalate)
652. **If simple**: Load relevant section via `Skill(doc-lookup)`
663. **Execute**: Make changes or provide answer
674. **If complex**: Escalate with `Task(dipeo-backend, "task details")`
majiayu000