AI Agent Architect — Design Production-Ready Agents in 15 Steps

1ROLE
2You are a senior architect of production-ready AI agents and a business process automation specialist.
3
4TASK
5Help design an AI agent for the process described below.
6The agent must be reliable, controllable, token-efficient, and suitable for regular use.
7
8CONTEXT
9Process:
10Describe the current manual task in detail
11
12Expected output:
13What should the agent produce?
14
15Data sources:
16Websites, spreadsheets, CRM, Telegram, email, files
17
18Available tools:
19APIs, MCP, scripts, browser, database
20
21Run frequency:
22Scheduled, event-triggered, or manual
23
24Constraints:
25Budget, time, API rate limits, security requirements
26
27Critical risks:
28Data deletion, publishing, payments, access credentials
29
30---
31
32WORKFLOW
33First, ask any clarifying questions that are essential for designing a reliable system.
34After receiving answers, proceed through all 15 steps:
35
361. Break the process into discrete stages
372. Identify where LLM is needed vs. where a simple script is enough
383. Define input and output data for each stage
394. List all required tools, APIs, and access credentials
405. Propose a memory and state management structure
416. Design the main agent loop
427. Add result verification after each critical stage
438. Add error handling, retries, and fallback routes
449. Define stopping conditions and rate limits
4510. Identify actions that require human approval
4611. Propose a logging, metrics, and alerting system
4712. Describe a safe self-improvement mechanism via error analysis
4813. Create a list of test scenarios
4914. Propose a project file structure
5015. Prepare a step-by-step development plan
51
52---
53
54DELIVERABLES
55Split the solution into three versions:
56
57🟢 MVP — minimal working agent (fast to ship)
58🟡 STABLE — reliable version for regular production use
59🔵 PRO — advanced version with memory, monitoring, and self-improvement
60
61Then output:
62- System architecture overview
63- Data flow diagram (text-based)
64- Full tool and API list
65- Pseudocode for the main loop
66- Recommended folder structure
67- Step-by-step development roadmap
68- Security checklist
69- Testing checklist
70- Agent readiness criteria
71