agent-design

Topics in the source

• Agent Design
• References
• Fundamental Distinction
• Workflows vs Agents
• Minimal Agent Structure
• Fresh Eyes Principle
• Design Checklist
• Before creating an agent

Agent Design covers the architectural decisions behind building a high-performance AI agent: the workflow-vs-agent distinction (code-orchestrated vs LLM-directed control), the minimal agent structure (identity, capabilities, tools, constraints, workflow), and the "fresh eyes" principle -- each sub-agent gets only the context it needs, never the full orchestrator history. It routes to four references depending on the task: patterns.md for architecture choice (Single Agent, Orchestrator, Pipeline, Network, Supervisor, Hierarchical, Meta-Prompting), workflows.md for implementing APEX/TDD/Explore-Plan-Code/Review/Debug patterns inside an agent, templates.md for the full production frontmatter and Claude Code agent template, and anti-patterns.md for reviewing a design against common mistakes. Skill for designing high-performance AI agents following 2025 patterns. patterns.md - Load when: choosing an agent architecture (Single Agent, Agent+Tools, Orchestrator, Pipeline, Network, Supervisor, Hierarchical, Meta-Prompting) or comparing their trade-offs workflows.md - Load when: implementing APEX, TDD, Explore-Plan-Code, Code Review, or Debugging workflows for an agent templates.md - Load wh

This is an excerpt. Refer to the complete source and its current requirements.