ai-systems-architect

Designs production-grade AI systems, agent platforms, RAG pipelines, and evaluation architectures.

2|Updated Aug 21, 2026
One-click install
npx skills add https://github.com/suhanr/next-gen-claude-skills --skill ai-systems-architect-suhanr
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ai-systems-architect
Source: https://github.com/suhanr/next-gen-claude-skills/tree/main/skills/02-ai-systems-architect
Command: npx skills add https://github.com/suhanr/next-gen-claude-skills --skill ai-systems-architect-suhanr

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Designing AI systems that survive production is hard: teams struggle with model selection, RAG pipeline design, agent orchestration, evaluation, cost control, and safety boundaries. This Skill turns Claude into an AI systems architect that produces implementation-ready architectures instead of vague diagrams. ## Core Features & Use Cases - AI System Architecture: Decompose product goals into model, retrieval, tool, memory, and application layers with explicit contracts for every boundary. - RAG and Agent Design: Plan retrieval pipelines, embeddings, reranking, agent loops, tool calling, and MCP-style connector architectures. - Evaluation and Observability: Define evaluation datasets, failure taxonomies, tracing, cost/latency budgets, and human-in-the-loop approval gates before launch. - Use Case: Ask for an architecture for a customer-support copilot and receive a component diagram, model/tool selection matrix, evaluation plan, security model, and implementation roadmap. ## Quick Start Ask Claude to design the architecture for a RAG-based document Q&A system including model selection, evaluation plan, and cost assumptions.

Frequently Asked Questions about ai-systems-architect

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I design a RAG system architecture for production?▼

Start by separating retrieval, reranking, generation, and application layers with explicit contracts between them. Define evaluation datasets and failure taxonomies before launch, and add observability for traces, latency, cost, and answer quality.

How do I choose between a single agent and a multi-agent system?▼

Choose the smallest reliable architecture first and only add multi-agent complexity when a single agent demonstrably cannot meet the requirement. Each added agent introduces orchestration, evaluation, and failure-handling overhead that must be justified.

What should an AI system evaluation plan include?▼

An evaluation plan should include representative datasets, a failure taxonomy, quality metrics, red-teaming scenarios, and guardrail checks. It should be designed before production launch and tied to observable traces of prompts, tool calls, and outputs.

When should I not use an LLM agent for a workflow?▼

Avoid agents when a deterministic workflow or simple model call satisfies the requirement, since agents add latency, cost, and unpredictable failure modes. Consequential actions also need human-approval boundaries rather than full autonomy.

How do I control LLM cost and latency in production?▼

Use model routing, caching, batching, and streaming to manage inference economics, and track cost and latency per request through observability tooling. Re-evaluate model choices when scale, budget, or quality requirements change.