{"id":"vibeeval-agentic-workflow","name":"agentic-workflow","summary":"エージェントワークフローパターン","body":"# Agentic Workflow Pattern\r\n\r\nStandard multi-agent pipeline for implementation tasks.\r\n\r\n## Architecture Principles\r\n\r\n- Use `run_in_background: true` for all agents to keep main context minimal\r\n- Use `Task` tool (never `TaskOutput`) to avoid receiving full agent transcripts\r\n- Agents write outputs to `.claude/cache/agents/<stage>/` for injection into subsequent agents\r\n- Main conversation is pure orchestration — no heavy lifting, only coordination\r\n\r\n## Workflow Stages\r\n\r\n### 1. Research Agent\r\n```\r\nTask(subagent_type=\"oracle\", run_in_background=true, prompt=\"\"\"\r\nQuery NIA Oracle (via /nia-docs skill) to verify approach and gather best practices.\r\n\r\nOutput to: .claude/cache/agents/oracle/<task>-research.md\r\n\"\"\")\r\n```\r\n- Enforce NIA as the research layer\r\n- Output: Research findings\r\n\r\n### 2. Planning Agent\r\n```\r\nTask(subagent_type=\"plan-agent\", run_in_background=true, prompt=\"\"\"\r\nRead: .claude/cache/agents/oracle/<task>-research.md\r\nUse RP-CLI to analyze the target codebase section.\r\nGenerate implementation plan informed by research.\r\n\r\nOutput to: .claude/cache/agents/plan-agent/<task>-plan.md\r\n\"\"\")\r\n```\r\n- Receives: Research agent output as context\r\n- Output: Implementation plan\r\n\r\n### 3. Validation Agent\r\n```\r\nTask(subagent_type=\"validate-agent\", run_in_background=true, prompt=\"\"\"\r\nRead: .claude/cache/agents/plan-agent/<task>-plan.md\r\nRead: .claude/cache/agents/oracle/<task>-research.md\r\nReview plan against research findings and best practices.\r\n\r\nOutput to: .claude/cache/agents/validate-agent/<task>-validated.md\r\n\"\"\")\r\n```\r\n- Reviews plan against research\r\n- Output: Validated plan with amendments\r\n\r\n### 4. Implementation Agent\r\n```\r\nTask(subagent_type=\"agentica-agent\", run_in_background=true, prompt=\"\"\"\r\nRead: .claude/cache/agents/validate-agent/<task>-validated.md\r\nRead: .claude/cache/agents/oracle/<task>-research.md\r\n\r\nTDD approach: Write failing tests FIRST, then implement.\r\nRun tests to verify.\r\n\r\nOutput summary to: .claude/cache/agents/implement-agent/<task>-implementation.md\r\n\"\"\")\r\n```\r\n- Receives: Validated plan + research context\r\n- **TDD**: Failing tests first\r\n- Output: Implementation + tests\r\n\r\n### 5. Review Agent\r\n```\r\nTask(subagent_type=\"review-agent\", run_in_background=true, prompt=\"\"\"\r\nRead: .claude/cache/agents/implement-agent/<task>-implementation.md\r\nRead: .claude/cache/agents/validate-agent/<task>-validated.md\r\nRead: .claude/cache/agents/oracle/<task>-research.md\r\n\r\nCross-reference implementation against plan and research.\r\nRun tests to confirm passing.\r\n\r\nOutput to: .claude/cache/agents/review-agent/<task>-review.md\r\n\"\"\")\r\n```\r\n- Cross-references all artifacts\r\n- Confirms tests pass\r\n- Output: Review summary\r\n\r\n## Agent Progress Monitoring\r\n\r\n```bash\r\n# Watch for system reminders:\r\n# \"Agent a42a16e progress: 6 new tools used, 88914 new tokens\"\r\n\r\n# Poll for output files:\r\nfind .claude/cache/agents -name \"*.md\" -mmin -5\r\n\r\n# Check task file size growth:\r\nwc -c /tmp/claude/.../tasks/<id>.output\r\n```\r\n\r\n**Stuck detection:**\r\n1. Progress reminders stop arriving\r\n2. Task output file size stops growing\r\n3. Expected output file not created after reasonable time\r\n\r\n## Directory Structure\r\n\r\n```\r\n.claude/cache/agents/\r\n├── oracle/\r\n│   └── <task>-research.md\r\n├── plan-agent/\r\n│   └── <task>-plan.md\r\n├── validate-agent/\r\n│   └── <task>-validated.md\r\n├── implement-agent/\r\n│   └── <task>-implementation.md\r\n└── review-agent/\r\n    └── <task>-review.md\r\n```\r\n\r\n## Key Rules\r\n\r\n1. **Never use TaskOutput** - floods context with 70k+ token transcripts\r\n2. **Always run_in_background=true** - isolates agent context\r\n3. **File-based handoff** - each agent reads previous agent's output file\r\n4. **Poll, don't block** - check file system for outputs, don't wait\r\n5. **TDD in implementation** - failing tests first, then make them pass\r\n\r\n## Source\r\n- Session 2026-01-01: SDK Phase 3 implementation using this pattern","author":"@vibeeval","ownerProfile":null,"authorContacts":null,"sourceUrl":"https://github.com/vibeeval/vibecosystem/tree/main/skills/agentic-workflow","license":"MIT","category":"writing","lang":"en","tokens":963,"stars":0,"calls30d":1,"claimed":false,"visibility":"public","origin":"crawler","version":"0.1.0","createdAt":"2026-08-22","updatedAt":"2026-08-22","files":[],"requires":{"mcp":[],"tools":[]},"safety":{"flags":[],"scannedAt":"2026-08-22","hasScripts":false,"networkEndpoints":[]}}