# Agent Architecture

Design AI agent architectures through requirements discovery, or audit and diagnose...

- Repository: https://github.com/github/awesome-copilot (40669 stars)
- Category: Design
- License: MIT
- Last updated: 2026-10-30
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add github/awesome-copilot --skill agent-architecture -g -a claude-code -y`
Codex: `npx skills add github/awesome-copilot --skill agent-architecture -g -a codex -y`
Cursor: `npx skills add github/awesome-copilot --skill agent-architecture -g -a cursor -y`
Gemini CLI: `npx skills add github/awesome-copilot --skill agent-architecture -g -a gemini-cli -y`

## Description

Design AI agent architectures through requirements discovery, or audit and diagnose architectural flaws in existing agents. Architecture only; excludes implementation and general code review.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# AI Agent Architecture

Help the user obtain a justified architecture for their task or an evidence-based audit of an existing agent. Deliver architectural decisions and ways to verify them, without implementing the agent. By default, completed work includes a PDF report and a visualization of the results. An “ideal architecture” fits the requirements, cost of failure, and team resources; it does not maximize the number of components.

## Choose a route

| Request | Route | Read |
|---|---|---|
| New agent, requirements are not yet clear | Design: working cases → early design → requirements and decision coverage → delivery | [design.md](references/design.md), [architecture-contract.md](references/architecture-contract.md) |
| Architecture from an existing specification | Design: fill in what is known and clarify only gaps | The same files; do not restart the interview |
| Review an agent already written | Audit: reconstruct actual paths → verify → deliver findings | [audit.md](references/audit.md), and [architecture-contract.md](references/architecture-contract.md) as criteria |
| Agent makes mistakes, has degraded, or falsely reports “done” | Diagnosis within the audit: case → hypotheses → discriminating checks → correction and closure criterion | audit.md and [diagnostic-review.md](references/diagnostic-review.md) |
| Review and redesign | Audit first; its demonstrated problems become design inputs | audit.md first, then design.md |

In either mode, read [source-map.md](references/source-map.md) once: it explains the origins of the principles and the textbook's limitations. The original PDF is not needed for ordinary skill use. [scenarios.md](references/scenarios.md) is needed only to test the skill itself.

The rest: https://github.com/github/awesome-copilot/blob/HEAD/skills/agent-architecture/SKILL.md