agent-architecture-plannerlisted
Install: claude install-skill Othmane-Khadri/gtm-engineer-playbook
# 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