DiPeO Package Maintainer Router
Domain: Runtime Python in /dipeo/ (application, domain, infrastructure - EXCLUDING codegen and generated code).
Quick Decision: Skill or Agent?
✅ Handle Directly (This Skill)
- Simple changes: <20 lines, 1-2 files
- Read-only tasks: Understanding patterns, reviewing implementation
- Pattern lookup: Envelope usage, service registration examples
- Small fixes: Typos, minor refactors, simple handler tweaks
❌ Escalate to Agent
- New node handlers: Creating handlers with complex logic
- Service architecture: EventBus integration, ServiceRegistry configuration
- Domain model changes: Conversation management, memory strategies
- Multi-file refactoring: Affects >2 files or cross-layer changes
- Generated code issues: If generated APIs don't work, escalate to dipeo-codegen-pipeline first
Agent: Task(dipeo-package-maintainer, "your detailed task description")
Documentation Sections (Load On-Demand)
Use Skill(doc-lookup) with these anchors when you need detailed context:
Architecture & Ownership:
docs/agents/package-maintainer.md#your-domain-of-expertise - Code layers and ownership
docs/agents/package-maintainer.md#core-architectural-principles - Service architecture, LLM integration
Implementation:
docs/agents/package-maintainer.md#your-responsibilities - Node handlers, services, GraphQL resolvers
Patterns & Imports:
docs/agents/package-maintainer.md#common-patterns - Envelope, service registry, node handlers
docs/agents/package-maintainer.md#key-import-paths - Common imports
Escalation:
docs/agents/package-maintainer.md#when-you-need-help-escalation-paths - When to escalate
Example doc-lookup call:
python .claude/skills/doc-lookup/scripts/section_search.py \
--query "envelope-pattern" \
--paths docs/agents/package-maintainer.md \
--top 1
Escalation to Other Agents
To dipeo-codegen-pipeline: Generated code issues, TypeScript specs, new node types, GraphQL schema
To dipeo-backend: CLI commands, server config, database schema, MCP server
Typical Workflow
- Assess complexity: Simple pattern lookup vs. complex implementation
- If simple: Load relevant section via
Skill(doc-lookup), provide guidance or make small change
- If complex: Escalate with
Task(dipeo-package-maintainer, "task details")
- Generated code problems: First check if it's a generation issue → escalate to dipeo-codegen-pipeline
Converted and distributed by TomeVault — claim your Tome and manage your conversions.
1---2name: dipeo-package-maintainer3description: Router skill for DiPeO runtime Python code (execution handlers, service architecture, domain models, LLM infrastructure). Use when task mentions node handlers, EventBus, ServiceRegistry, Envelope pattern, or domain logic. For simple tasks, handle directly; for complex work, escalate to dipeo-package-maintainer agent. Use when this capability is needed.4---56# DiPeO Package Maintainer Router78**Domain**: Runtime Python in `/dipeo/` (application, domain, infrastructure - EXCLUDING codegen and generated code).910## Quick Decision: Skill or Agent?1112### ✅ Handle Directly (This Skill)13- **Simple changes**: <20 lines, 1-2 files14- **Read-only tasks**: Understanding patterns, reviewing implementation15- **Pattern lookup**: Envelope usage, service registration examples16- **Small fixes**: Typos, minor refactors, simple handler tweaks1718### ❌ Escalate to Agent19- **New node handlers**: Creating handlers with complex logic20- **Service architecture**: EventBus integration, ServiceRegistry configuration21- **Domain model changes**: Conversation management, memory strategies22- **Multi-file refactoring**: Affects >2 files or cross-layer changes23- **Generated code issues**: If generated APIs don't work, escalate to dipeo-codegen-pipeline first2425**Agent**: `Task(dipeo-package-maintainer, "your detailed task description")`2627## Documentation Sections (Load On-Demand)2829Use `Skill(doc-lookup)` with these anchors when you need detailed context:3031**Architecture & Ownership**:32- `docs/agents/package-maintainer.md#your-domain-of-expertise` - Code layers and ownership33- `docs/agents/package-maintainer.md#core-architectural-principles` - Service architecture, LLM integration3435**Implementation**:36- `docs/agents/package-maintainer.md#your-responsibilities` - Node handlers, services, GraphQL resolvers3738**Patterns & Imports**:39- `docs/agents/package-maintainer.md#common-patterns` - Envelope, service registry, node handlers40- `docs/agents/package-maintainer.md#key-import-paths` - Common imports4142**Escalation**:43- `docs/agents/package-maintainer.md#when-you-need-help-escalation-paths` - When to escalate4445**Example doc-lookup call**:46```bash47python .claude/skills/doc-lookup/scripts/section_search.py \48 --query "envelope-pattern" \49 --paths docs/agents/package-maintainer.md \50 --top 151```5253## Escalation to Other Agents5455**To dipeo-codegen-pipeline**: Generated code issues, TypeScript specs, new node types, GraphQL schema56**To dipeo-backend**: CLI commands, server config, database schema, MCP server5758## Typical Workflow59601. **Assess complexity**: Simple pattern lookup vs. complex implementation612. **If simple**: Load relevant section via `Skill(doc-lookup)`, provide guidance or make small change623. **If complex**: Escalate with `Task(dipeo-package-maintainer, "task details")`634. **Generated code problems**: First check if it's a generation issue → escalate to dipeo-codegen-pipeline6465---66> Converted and distributed by [TomeVault](https://tomevault.io/claim/sorryhyun) — claim your Tome and manage your conversions.67<!-- tomevault:4.0:skill_md:2026-04-11 -->