Agent skill · software engineering · 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.
Why this skill is useful
Adds a comprehensive diagnostic script that identifies and fixes multi-layer failures in agent architectures, which is not commonly found in public documentation.
What it needs
Requires bash, glob, grep installed locally. About 6k tokens when loaded. Last updated 2026-08-06. 238,342 stars on the source repository.
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--22c433