| name | agentic-workflow-guide |
| description | Create, review, and update Prompt and agents and workflows. Covers 5 workflow patterns, agent delegation, Handoffs, Context Engineering. Use for any .agent.md file work or multi-agent system design. Triggers on 'agent workflow', 'create agent', 'ワークフロー設計'. |
| license | CC BY-NC-SA 4.0 |
| metadata | {"author":"yamapan (https://github.com/aktsmm)"} |
Agentic Workflow Guide
Design, review, and improve agent workflows based on proven principles.
When to Use
| Action | Triggers |
|---|
| Create | New .agent.md, workflow architecture, scaffolding |
| Review | Orchestrator not delegating, design principle check, context overflow |
| Update | Adding Handoffs, improving delegation, tool configuration |
Core Principles
→ references/design-principles.md
| Tier | Principles |
|---|
| Essential | SSOT, SRP, Simplicity First, Fail Fast, Feedback Loop |
| Quality | Transparency, Gate/Checkpoint, DRY, Observability |
| Scale | Human-in-the-Loop, Loose Coupling, Graceful Degradation |
See design-principles.md > Simplicity First for Anthropic's key recommendation.
Workflow Patterns
→ references/workflow-patterns/overview.md
| Pattern | When to Use |
|---|
| Prompt Chaining | Sequential tasks with validation |
| Routing | Processing varies by input type |
| Parallelization | Independent tasks run together |
| Orchestrator-Workers | Dynamic task decomposition |
| Evaluator-Optimizer | Repeat until quality criteria met |
Stop Conditions (MANDATORY): Define success/failure criteria and exit conditions for every loop.
Design Workflow
- Requirements - Goal, subtasks, dependencies, quality criteria
- Pattern Selection - [!] Ask user to confirm pattern before proceeding
- Design Diagram - Visualize with Mermaid
- Principle Check - Validate against review checklist
- Implement & Iterate - Build small → verify → improve
When to Escalate
→ references/splitting-criteria.md
| Level | Configuration | Escalation Triggers |
|---|
| L0 | Single Prompt | Retry 3+, unstable output |
| L1 | Prompt + Instructions | Steps > 5, "missed/overlooked" errors |
| L2 | Single Agent | Multiple responsibilities, context > 70% |
| L3 | Multi-Agent | Independent subtasks needed |
Quick Check: Prompt > 50 lines? Steps > 5? SRP violation? Context > 70%? → Consider splitting.
Review Checklist
→ references/review-checklist.md
Key References
agent Quick Fix
Problem: Orchestrator says "I'll delegate" but does work directly.
Solution: Use MUST/MANDATORY language. See agent-guide.md.
You MUST use agent for each file. Do NOT read files directly.
Tools Reference
→ references/agent-template.md
| Purpose | VS Code Copilot | Claude Code |
|---|
| Shell | runInTerminal | Bash |
| Read | read/readFile | Read |
| Edit | edit/editFiles | Write |
| Subagent | agent | Task |
| Web fetch | web/fetch | (MCP) |
External References
Official Documentation
Design Principles
Instructions & Context
Community Resources
Prompt Engineering
Done Criteria
