architecture-audit

Audit codebases for architectural issues and create GitHub issues.

25|5|Updated May 9, 2026
One-click install
npx skills add https://github.com/kamp-us/phoenix --skill architecture-audit-kamp-us
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture-audit
Source: https://github.com/kamp-us/phoenix/tree/main/claude-plugins/kampus-pipeline/skills/architecture-audit
Command: npx skills add https://github.com/kamp-us/phoenix --skill architecture-audit-kamp-us

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the process of auditing a codebase for architectural friction and files each deepening opportunity as a triageable GitHub issue, improving code quality and maintainability.

Core Features & Use Cases

  • Codebase Audit: Walks through a codebase to identify architectural issues.
  • Issue Creation: Files each opportunity as a GitHub issue for further review.
  • Read-Only: Operates without modifying the codebase.
  • Vocabulary Consistency: Uses a predefined architecture vocabulary for findings.
  • Three-Lens Approach: Analyzes the codebase from three different perspectives (Locality, Testability, Vocabulary).

Quick Start

Run the architecture-audit skill on your codebase to automatically identify architectural issues and file GitHub issues for them.

Frequently Asked Questions about architecture-audit

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate codebase audits for architecture issues?

You can automate codebase audits by running the architecture-audit skill, which walks through your project to identify architectural friction and files each deepening opportunity as a triageable GitHub issue.

What is the three-lens approach for code architecture analysis?

The three-lens approach for code architecture analysis evaluates a codebase from three distinct perspectives: Locality, Testability, and Vocabulary, using a predefined architecture vocabulary to categorize findings.

Can I use architecture audit with my existing GitHub repository?

Yes, you can use architecture audit with your existing GitHub repository, as it requires a GitHub repository and the kamp-us/phoenix architecture vocabulary to operate and file issues.

Does the code audit process modify my source files?

No, the code audit process operates in a read-only mode and does not modify your codebase, ensuring your source files remain untouched while it identifies architectural issues and files GitHub issues.

How do I triage architectural friction found during a code audit?

To triage architectural friction found during a code audit, the skill automatically files each identified opportunity as a separate GitHub issue, allowing your team to review and track code quality improvements.

Do I need a specific architecture vocabulary to audit code quality?

Yes, you need the kamp-us/phoenix architecture vocabulary to audit code quality, as the skill uses this predefined vocabulary to ensure consistency when analyzing and reporting architectural findings.