Agentic Workflow Pattern

Standard multi-agent pipeline for implementation tasks.

Architecture Principles

• Use run_in_background: true for all agents to keep main context minimal
• Use Task tool (never TaskOutput) to avoid receiving full agent transcripts
• Agents write outputs to .claude/cache/agents/<stage>/ for injection into subsequent agents
• Main conversation is pure orchestration — no heavy lifting, only coordination

Workflow Stages

1. Research Agent

Task(subagent_type="oracle", run_in_background=true, prompt="""
Query NIA Oracle (via /nia-docs skill) to verify approach and gather best practices.

Output to: .claude/cache/agents/oracle/<task>-research.md