audit-architecture

Audit backend architecture for drift, encapsulation breaches, and primitive compliance.

Updated Mar 30, 2026
One-click install
npx skills add https://github.com/weside-ai/claude-code-plugin --skill audit-architecture-weside-ai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: audit-architecture
Source: https://github.com/weside-ai/claude-code-plugin/tree/main/we/skills/audit-architecture
Command: npx skills add https://github.com/weside-ai/claude-code-plugin --skill audit-architecture-weside-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires python, pyyaml, argparse, re, subprocess, yaml, ast, json, collections, datetime, pathlib, typing, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill performs a thorough audit of a project's backend architecture, identifying potential issues such as architectural drift, encapsulation breaches, and primitive compliance.

Core Features & Use Cases

  • Multi-Phase Audit: Healthcheck, Hotspot Map, Subsystem Deep-Read, Cross-Cutting Lenses, Findings Consolidation.
  • Architectural Significance Analysis: Identifies architectural hotspots and assesses their risk.
  • Documentation Verification: Ensures code adheres to documented architectural invariants.
  • Use Case: Use this Skill to conduct regular audits of your backend architecture to ensure it remains robust and maintainable.

Quick Start

Run the audit with the command '/we:audit-architecture'. You can also specify subsystems or phases to run: '/we:audit-architecture <subsystem-id>' or '/we:audit-architecture --skip-phase=2'.

Frequently Asked Questions about audit-architecture

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

FAQPage Schema
How do I audit backend architecture for encapsulation breaches and compliance issues?

To audit backend architecture for encapsulation breaches and compliance issues, this Skill applies Python scripts to analyze code, verify invariants, and visualize findings using Mermaid diagrams.

What is architectural drift and how do I identify it in my codebase?

Architectural drift occurs when code deviates from documented design invariants. You identify it by performing a subsystem deep-read and cross-cutting analysis to detect structural anomalies and encapsulation breaches.

Can I run an architecture audit on a specific subsystem instead of the whole project?

Yes, you can run the architecture audit on a specific subsystem by providing the subsystem identifier as an argument, allowing you to target the analysis and skip unrelated project modules.

Do I need Python to perform an automated code review and architecture analysis?

Yes, you need Python to perform this architecture analysis, as the audit relies on Python libraries like pyyaml, ast, and subprocess to parse code and verify architectural invariants.

How do I visualize architectural hotspots and risk areas in a backend codebase?

To visualize architectural hotspots and risk areas, the audit tool generates Mermaid diagrams that map subsystem health, highlight cross-cutting concerns, and consolidate findings into a clear overview.

Can I skip specific phases like the healthcheck during a backend compliance audit?

Yes, you can skip specific phases during a backend compliance audit by using the skip-phase flag, allowing you to bypass steps like the healthcheck and focus directly on hotspot mapping or subsystem deep-reads.