agent-architecture-audit

SKILL.md

Agent Architecture Audit

A diagnostic workflow for agent systems that hide failures behind wrapper layers, stale memory, retry loops, or transport/rendering mutations.

When to Activate

MANDATORY for:

Releasing any agent or LLM-powered application to production

Shipping features with tool calling, memory, or multi-step workflows

Agent behavior degrades after adding wrapper layers

User reports "the agent is getting worse" or "tools are flaky"

Same model works in playground but breaks inside your wrapper

Debugging agent behavior for more than 15 minutes without finding root cause

Especially critical when:

You've added new prompt layers, tool definitions, or memory systems

Different agents in your system behave inconsistently

The model was fine yesterday but is hallucinating today

You suspect hidden repair/retry loops silently mutating responses