affaan-m avatar

Agent Architecture Audit

This is a full-stack diagnostic for when your agent or LLM application works in the playground but breaks in production, or when wrapper layers somehow make the base model worse. It audits 12 layers where things go wrong: system prompts, memory pollution, tool discipline failures, hidden repair loops that silently rerun LLM calls, and rendering corruption between generation and delivery. You get severity-ranked findings with code-first fixes, not prompt tweaks. Use it when shipping agent features to production, when "the agent is getting worse" reports come in, or when you've been debugging agent behavior for more than 15 minutes without finding the root cause. The workflow searches your codebase for anti-patterns like tool requirements only in prompts instead of code, memory admission without user-correction priority, and silent output mutation layers.

skills.sh installs
1.7K
GitHub stars
229.1K
last updated
Jul 14, 2026

Install

$ npx -y skills add affaan-m/everything-claude-code --skill agent-architecture-audit --agent claude-code

Installs into .claude/skills of the current project.

Files

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

Sponsors

Details

Repository
github.com/affaan-m/everything-claude-code
Categories
Code Review & Quality, AI & Agent Building
First seen
Jun 3, 2026

More from affaan-m/everything-claude-code

All 256
1adobe avatarcode-reviewadobe/skillsUse this when reviewing AEM Edge Delivery Services (EDS, Franklin, Helix) code, either self-review at the end of development before opening a PR, or reviewing a1.7Kskills.sh installs
2safaiyeh avatarapp-store-reviewsafaiyeh/app-store-review-skillapp store review1.6Kskills.sh installs
3nvidia avatartao-convert-dataset-formatnvidia/skillsRun `tao-daft convert` to convert NVIDIA TAO DAFT datasets between supported formats. Do not use for non-DAFT data. Use when the user asks to convert a DAFT dat1.6Kskills.sh installs
4github avatargtm-partnership-architecturegithub/awesome-copilotBuild and scale partner ecosystems that drive revenue and platform adoption. Use when building partner programs from scratch, tiering partnerships, managing co-1.6Kskills.sh installs
5nvidia avatartao-validate-dataset-formatnvidia/skillsRun `tao-daft validate` to check NVIDIA TAO DAFT datasets for structure, schema, and cross-reference errors. Do not use for non-DAFT formats. Use when the user 1.6Kskills.sh installs
6sickn33 avatarcc-skill-security-reviewsickn33/antigravity-awesome-skillscc skill security review1.5Kskills.sh installs