Architecture Debt Analyzer — Development agent for Claude Code
Analyzes architecture debt — circular dependencies, God modules, tight coupling, layer violations, missing separation of concerns, and structural decay.
How to install Architecture Debt Analyzer
Installs to ~/.claude/agents/noah-sheldon-ai-dev-kit-architecture-debt-analyzer.md
mkdir -p ~/.claude/agents && curl -fsSL https://raw.githubusercontent.com/noah-sheldon/ai-dev-kit/HEAD/agents/architecture-debt-analyzer.md -o ~/.claude/agents/noah-sheldon-ai-dev-kit-architecture-debt-analyzer.md Restart Claude Code, or start a new session, for it to be picked up.
What Architecture Debt Analyzer does
name: architecture-debt-analyzer description: Analyzes architecture debt — circular dependencies, God modules, tight coupling, layer violations, missing separation of concerns, and structural decay. Produces a structured architecture debt report. model: opus tools: ["Read", "Grep", "Glob", "Bash"] fallback_model: default
You are the **Architecture Debt Analyzer** for the AI Dev Kit workspace. You scan a codebase for structural and architectural decay — issues that make the system harder
Alternatives in Development
- Tech Debt — You are a technical debt expert specializing in identifying, quantifying, and prioritizing technical 31.9k ★
- Refactoring Expert — Improve code quality and reduce technical debt through systematic refactoring and clean code principles 1.5k ★
- General Code Quality Debugger — Use this agent proactively when you need systematic code review, debugging assistance, refactoring guidance, o 248 ★
Full documentation available on GitHub
View Source RepositoryRelated Agents
Architecture Enforcer
Use proactively when files in layer-boundary directories change. Validates import direction, circular deps, an
Coupling Lens
Paradigm lens agent for module coupling observation. Used by /prism to identify tight or hidden dependencies b
Refactor Coupling
Scans for files with excessive imports (8+ modules) or circular dependencies and returns the offenders.
Code Quality Analyzer
Analyzes code quality debt — God files, long functions, deep nesting, cyclomatic complexity, naming inconsiste
Impl Architecture
Reviews implementation plans from a software architecture perspective. Use when evaluating module structure, s
Interface Verifier
Validates interfaces compile correctly across multiple languages. Checks for type safety, circular dependencie
Related Skills
Review Code Maintainability
Structural maintainability audit: god objects, hidden coupling, dead code, comment-standard compliance, and dr
Verify Flow
Validates existing agents, commands, skills, and hooks against project conventions. Detects structural issues,
Audit Ddd
DDD architecture audit with pattern recommendations. Analyzes layer separation, domain model richness, and arc