Agent skill · affaan-m
agent-architecture-audit
Full-stack diagnostic for agent and LLM applications. Audits the 12-layer agent stack for wrapper regression, memory pollution, tool discipline failures, hidden repair loops, and rendering corruption. Produces severity-ranked findings with code-first fixes. Essential for developers building agent applications, autonomous loops, or any LLM-powered feature. Use when an agent or LLM feature misbehaves and the failing layer is unknown, or before shipping an agent stack.
What it needs
About 6k tokens when loaded.
What this skill does
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 Do not use for: General code debugging — use agent-introspection-debugging Code review — use language-specific reviewer agents Security scanning — use security-review or security-review/scan Agent performance benchmarking — use agent-eval Writing new features — use the appropriate workflow skill The 12-Layer Stack Every agent system has these layers. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills affaan-m/agent-architecture-audit--9fff42