# ai-agents-architect

Patterns for building autonomous agents: ReAct loops, planning, tool registries and memory. Useful when your agent loops or mishandles tool calls.

- skill · `type=skill` · Claude Code · 995 installs
- Author: davila7
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/davila7/claude-code-templates/tree/HEAD/cli-tool/components/skills/ai-research/ai-agents-architect
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/skills/ai-agents-architect

## What it does

The skill gives your agent the role of an AI agent systems architect. Inside are named patterns: a reason-act-observe cycle with a hard iteration limit, a plan-first approach where the plan gets revised as results come in, and a tool registry that registers schemas and examples while lazy-loading the expensive tools.

A second block covers anti-patterns and a table of sharp edges. It lists where agents break most often: loops with no iteration cap, vague tool descriptions, tool errors that never reach the agent, memory that stores everything. Each row comes with a short fix. Worth checking against your own code when an agent starts behaving oddly.

The skill assumes you already call an LLM through an API, understand function calling, and can write a basic prompt. It points to related skills: `rag-engineer`, `prompt-engineer`, `backend`, `mcp-builder`.

## Install

### Claude Code (native platform)

1. **claude-code-templates**
```bash
npx claude-code-templates@latest --skill ai-research/ai-agents-architect
```

2. **Skills CLI (Vercel)**
```bash
npx skills add davila7/claude-code-templates --skill ai-agents-architect -a claude-code
```

3. **Manually: put the files in place**
- File: `~/.claude/skills/ai-agents-architect/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/ai-agents-architect/

### Codex

**Manually: put the files in place**
- File: `.agents/skills/ai-agents-architect/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

**Manually: put the files in place**
- File: `.cursor/skills/ai-agents-architect/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install davila7/claude-code-templates ai-agents-architect
```

2. **Manually: put the files in place**
- File: `.github/skills/ai-agents-architect/SKILL.md`

### Gemini CLI

**Platform CLI**
```bash
gemini skills install https://github.com/davila7/claude-code-templates --path cli-tool/components/skills/ai-research/ai-agents-architect
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/ai-agents-architect/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/davila7/claude-code-templates/tree/HEAD/cli-tool/components/skills/ai-research/ai-agents-architect

## When to use it
- design a ReAct loop with an iteration cap
- split a task into a plan and execution steps
- build a tool registry with schemas and examples
- pick a memory strategy that does not hoard everything
- decide whether a multi-agent setup is justified

## Example prompts
- help me design an agent with a ReAct loop and iteration limits
- review my tool registry — the descriptions are too vague
- I need a plan-and-execute setup for a multi-step task

## Similar
- [agents-best-practices](https://affpapa.org/en/nevibecode/skills/agents-best-practices.md) — skill · 1000 installs
- [anthropic-claude-development](https://affpapa.org/en/nevibecode/skills/anthropic-claude-development.md) — skill · 728 installs
- [claude-sdk-integration-patterns](https://affpapa.org/en/nevibecode/skills/claude-sdk-integration-patterns.md) — skill · 434 installs
- [cargo-ai](https://affpapa.org/en/nevibecode/skills/cargo-ai.md) — skill · 9900 installs
- [hindsight-docs](https://affpapa.org/en/nevibecode/skills/hindsight-docs.md) — skill · 9200 installs
- [langchain4j-ai-services-patterns](https://affpapa.org/en/nevibecode/skills/langchain4j-ai-services-patterns.md) — skill · 3700 installs

## Other versions with the same name
- [ai-agents-architect · sickn33](https://affpapa.org/en/nevibecode/skills/sickn33-ai-agents-architect.md) — 1500 installs

From the same set: [davila7/claude-code-templates](https://affpapa.org/en/nevibecode/by/davila7/claude-code-templates.md) — 224 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md