Production Agent Builder

---

name: ai-agent-builder description: Structured 8-step framework for building production AI agents. Use when designing a new AI agent, planning agent architecture, building an automated workflow, or reviewing an existing agent's design. Covers task selection, step mapping, I/O specification, system prompt writing, memory design, safeguards, interface choice, and testing. Triggers on "build an agent", "design an agent", "agent architecture", "create an AI workflow", "production agent", "agent planning", "how to build an agent".

---

AI Agent Builder

Structured framework for building AI agents that work in production. Based on the Storm & Storm methodology.

When to Use

Designing a new AI agent from scratch

Planning architecture for an automated workflow

Reviewing or improving an existing agent's design

Teaching someone how to build agents

The 8-Step Process

Follow these steps in order. Each step has a clear goal and concrete deliverables.

Step 1: Choose a Task

Pick ONE painful, repeating workflow. Not "AI in general."

Must be repeatable (weekly+), follow steps, have clear I/O

Define success: "Given X, the agent should output Y so that Z happens."

Step 2: Map the Steps

Break the task into 4–7 steps: INPUT → ACTIONS → DECISION → OUTPUT

Classify each step: ⚖️ pure rules | 📖 heavy reading/writing | 🎯 judgement calls

Choose infrastructure (no-code vs dev-friendly)

You need: strong model + tool calling + basic logs

Step 3: Specify Inputs, Outputs & Tools

Treat the agent like an API, not a chatbot.

Define required input fields (text, file, URL, ID)

Define structured outputs (JSON/template the system can trust)

Attach tools: data (search/DB/CRM), action (email/Slack/tasks), orchestration (schedulers/webhooks/queues)

Step 4: Write the System Prompt

Create a clear role with: role definition, boundaries, style, 1–2 example conversations.

Use ReAct pattern: observe → think → act → reflect

Step 5: Add Memory

Three layers: conversation state, task memory, knowledge memory (vector store/file search).

Key question: "What does this agent need to remember for the next step to be smarter?"

Step 6: Add Safeguards

Gate high-risk actions (email, data changes, money) behind human approval.

Rules: never invent IDs, ask when ambiguous

Log every tool call and decision for audit

Step 7: Build the Interface

Match to where users work: chat, Slack command, button in app, or web form.

Step 8: Test

For each real example: watch the trace, score correctness + efficiency + time saved.

Tighten prompts/tools/rules where it fails. Iterate.

Detailed Reference

For expanded details on each step, including selection criteria, classification examples, tool categories, memory layer patterns, and a pre-launch checklist:

→ Read references/guide.md

Output Format

When using this framework to design an agent, produce a design document covering:

# Agent Design: [Name]
Task & Success Criteria
[Step 1 output]
Step Map
[Step 2 output — numbered steps with classifications]
I/O Specification
[Step 3 output — inputs, outputs, tools]
System Prompt
[Step 4 output — the actual prompt]
Memory Architecture
[Step 5 output — which layers, what's stored]
Safeguards
[Step 6 output — gated actions, rules, logging]
Interface
[Step 7 output — chosen interface and why]
Test Plan
[Step 8 output — example inputs, expected outputs, scoring criteria]