ai-agents

# AI Agents Development — Architecture Hub Use this skill to decide whether a workflow should be an agent, which agent shape fits, which protocol boundary to use, and what production controls must exist before rollout. Default posture: explicit control flow, bounded tools, typed contracts, auditable state, human approval for high-risk actions, and telemetry from day one. Keep this file lean. Load detail from [`references/index.md`](references/index.md), `assets/`, and sibling skills only when needed. ## When to Use This Skill Use this skill when the user asks for: - agent architecture or operating-model decisions - build-vs-not-agent assessment - MCP vs A2A protocol choice - production readiness review for an existing agent system - evaluation, observability, rollout, or safety planning - framework selection after requirements are already clear - a starting template for a new agent spec ## Use Other Skills for Depth - Prompt contracts and structured outputs → [`../ai-prompt-engineering/SKILL.md`](../ai-prompt-engineering/SKILL.md) - Retrieval, chunking, reranking, search quality → [`../ai-rag/SKILL.md`](../ai-rag/SKILL.md) - Vector-brain implementation, schemas, ingest scripts, manifests, and retrieval tool contracts → [`../ai-vector-brain/SKILL.md`](../ai-vector-brain/SKILL.md) - Bot building (support, sales, conversation design, LangGraph) → `ai-bot-builder` - Voice bots (STT/TTS pipeline, telephony, latency) → [`../ai-voice-bots/SKILL.md`](../ai-voice-bots/SKILL.md...