ai-systems-architect

Architect AI system designs with token budgets, tool-call caps, and evaluation plans.

8|1|Updated Mar 30, 2026
One-click install
npx skills add https://github.com/drewid74/ai_skills --skill ai-systems-architect
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ai-systems-architect
Source: https://github.com/drewid74/ai_skills/tree/main/ai-systems-architect
Command: npx skills add https://github.com/drewid74/ai_skills --skill ai-systems-architect

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you architect reliable, production-ready AI/agent systems by preventing common failures like runaway tool loops, context overflow, weak evaluation, insecure tool access, and inefficient RAG vs fine-tuning choices.

Core Features & Use Cases

  • End-to-end system architecture guidance: Aligns agent patterns, MCP server design, vector store selection, memory tiers, and evaluation strategy for building dependable applications.
  • Practical decision frameworks: Chooses between routing vs reasoning models, RAG vs fine-tuning, and MCP transport options based on constraints like latency, update frequency, and deployment scale.
  • Safety and cost guardrails: Defines anti-patterns and quality gates for iteration caps, timeouts, token budgeting, auth/rate limiting for tools, and golden-case evaluation.

Quick Start

Ask an AI to use ai-systems-architect to review your proposed agent design and produce an architecture with RAG/Routing decisions, MCP tool guardrails, context-window budgeting, and an evaluation plan.

Frequently Asked Questions about ai-systems-architect

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

FAQPage Schema
How do I prevent agent loops and tool call overruns in production AI architecture?

You can prevent agent loops and cost overruns in AI architecture by defining iteration caps, timeouts, and token budgeting guardrails. These constraints ensure dependable multi-agent workflows by stopping infinite tool calls and restricting execution cycles.

What is the best way to choose between RAG and fine-tuning for an AI assistant?

Choosing between RAG and fine-tuning depends on update frequency, latency constraints, and deployment scale. RAG retrieves external context dynamically, while fine-tuning embeds static knowledge, requiring a decision framework to align model routing with production requirements.

How does context window budgeting work for multi-agent workflows?

Context window budgeting for multi-agent workflows allocates specific token limits across memory tiers and vector stores. This strategy prevents context overflow by managing hybrid embedding distribution and ensuring agents operate within their designated processing capacity.

Can I use MCP tools with secure auth and rate limiting in production agents?

Yes, you can use MCP tools with secure auth and rate limiting by selecting appropriate MCP transport options. Configuring these transport and authentication choices protects tool access and prevents unauthorized calls in production assistant environments.

Why does LLM-as-judge evaluation need golden-case testing for AI systems?

LLM-as-judge evaluation needs golden-case testing to establish reliable quality gates against weak evaluation standards. Providing golden cases ensures the judge model verifies outputs accurately, preventing unreliable assessment in production AI architectures.

When should I not use a reasoning model over a routing model for AI architecture?

You should not use a reasoning model over a routing model when latency constraints and update frequency demand immediate response. Routing models provide faster dispatching for simple tasks, whereas reasoning models add overhead that may violate production AI requirements.