agent-architecture-planner

# Agent Architecture Planner Design autonomous agents using the "Shell Orchestrates, Claude Thinks" pattern. This skill takes a workflow description, selects the right architecture pattern, and produces a complete agent package: shell wrapper, system prompt, config, scheduling setup, and cost estimate. The core principle: **the shell handles everything deterministic** (API calls, file I/O, scheduling, budget tracking), and **Claude handles everything that requires judgment** (scoring, filtering, writing, categorizing). This separation makes agents cheaper, more reliable, and easier to debug. --- ## Tools Used | Tool | Purpose | |---|---| | `Read` | Check for existing agent docs, load reference files | | `Write` | Output all agent architecture files | | `Bash` | Make shell scripts executable, verify directory structure | | `Glob` | Check for existing agents to avoid naming conflicts | --- ## Methodology Follow these steps in order. Do not skip steps. Do not produce output files before completing the discovery interview and confirming the architecture with the user. --- ### Step 1 — Workflow Discovery (Interactive) Present these questions to the user **all at once** in a numbered list. Tell the user they can answer inline or paste a block of text. Ask exactly these questions: ``` I need to understand the workflow before designing the agent. Answer these 6 questions — be as specific as possible. 1. What task do you want to automate? (Describe the manual workflow as...