Architecture Audit

by softspark

Architecture Audit is a Quality skill for Claude Code, published by softspark in ai-toolkit.

170 stars20 forkson softspark/ai-toolkitAdded 2026/09/08+2% in starsRepository updated 2026/09/07

View source on GitHub Download repo ZIP

ai-agentsai-skillsanthropicclaudeclaude-codeclinecodexcopilotcursorgeminimcpopencodetoolkitwindsurf

Install in seconds

Install Architecture Audit

Copy Architecture Audit into your Claude Code skills folder. Run the command in your terminal, or review the source on GitHub before installing.

terminal

npx degit https://github.com/softspark/ai-toolkit/tree/main/app/skills/architecture-audit ~/.claude/skills/architecture-audit

Requires Node.js. Downloads this skill only — not the rest of the repository — into your Claude Code skills folder.

Without Node.js

git clone https://github.com/softspark/ai-toolkit.git

Clones the whole repository, then copy the skill’s own directory into your skills folder yourself.

In this catalog

Source file: app/skills/architecture-audit/SKILL.md in softspark/ai-toolkit
Installs to: ~/.claude/skills/architecture-audit
Collection: One of 25 skills cataloged from this repository
Category: Quality — 1897 skills

What Architecture Audit does

Architecture Audit explores a codebase for architectural friction, shallow modules, and tight coupling. It surfaces candidates, compares interface designs, and files an RFC issue when you need to deepen a module boundary.

Architecture Audit is cataloged under Quality on DirSkills. Architecture Audit comes from a repository tagged ai-agents, ai-skills, anthropic, claude and claude-code.

Documentation

README

Excerpt

Architecture Audit

$ARGUMENTS

Explore a codebase organically, surface architectural friction, and propose module-deepening refactors as GitHub issue RFCs.

Usage

/architecture-audit [area to audit or 'full codebase']

What This Command Does

Explores codebase organically — friction IS the signal
Presents deepening candidates to user
Frames problem space for chosen candidate
Spawns 3+ parallel sub-agents for radically different interface designs
Compares and recommends
Files RFC as GitHub issue

Key Concept

A deep module (Ousterhout) has a small interface hiding a large implementation. Deep modules enhance testability, AI navigation, and enable boundary testing.

This is the opening of the README. Read the full README on GitHub.

Commands Architecture Audit provides

Slash commands named in this skill’s SKILL.md, listed in the order they first appear.

/architecture-audit
/refactor
/refactor-plan
/design-an-interface
/architecture-decision
/analyze
/explore

Frequently asked about Architecture Audit

What else does softspark publish alongside Architecture Audit?
Architecture Audit is one of 25 skills that DirSkills catalogs from softspark/ai-toolkit, the repository it ships in. Its siblings there include API Patterns, Accessibility Validator and Agent Creator. Each one is a separate skill with its own page in this directory, installs the same way Architecture Audit does, and is maintained by softspark in that same repository. The rest of the collection is listed on the softspark/ai-toolkit page.
How does Architecture Audit compare to other Quality skills?
Architecture Audit ranks #1745 by stars among the 1897 Quality skills in this catalog. The most-starred ones next to it are Benchmark, Benchmark Optimization Loop and API Design Patterns. DirSkills ranks by the star count of the repository each skill ships in, so that order reflects how popular those repositories are rather than any review of Architecture Audit against them. Open each page to compare what they document and how they install.