architecture-audit

Analyze architecture Markdown files to generate an audit report and prioritized improvements roadmap.

2|1|Updated Mar 18, 2026

Search Tags:#architecture #audit #roadmap #quality-assurance #system-design #design-review

Ready to run

npx skills add https://github.com/harshitsinghbhandari/domain-expansion --skill architecture-audit-harshitsinghbhandari

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: architecture-audit
Source: https://github.com/harshitsinghbhandari/domain-expansion/tree/main/skills/architecture-audit
Command: npx skills add https://github.com/harshitsinghbhandari/domain-expansion --skill architecture-audit-harshitsinghbhandari

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Comprehensive architecture audit that combines ruthless analysis with solution-focused improvement planning. Reads architecture Markdown files, produces a brutal audit report with file/component scores, and generates a prioritized improvements roadmap.

Core Features & Use Cases

Two-phase architecture review: Audit Phase (rigorous, systemic) and Improvements Phase (prioritized roadmap).
Outputs: audit.md with a ruthlessly analytical report and a improvements roadmap document, all produced in a single run.
Triggered by explicit requests and required input Markdown architecture content to audit.

Quick Start

Provide architecture Markdown files and trigger the audit with an explicit request such as 'audit architecture' to generate both the audit report and the improvements roadmap.

Frequently Asked Questions about architecture-audit

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

FAQPage Schema

How do I conduct a system design review on my architecture documentation?▼

To conduct a system design review, provide architecture Markdown files and trigger an explicit audit request. The analysis reads design docs and diagram references to evaluate structural flaws, outputting a brutal audit report with file and component scores.

What is the best way to generate an improvements roadmap from a design review?▼

The best way to generate an improvements roadmap is by running a two-phase architecture audit. After the rigorous audit phase identifies structural flaws, the improvements phase translates those findings into a prioritized roadmap of actionable solutions.

Can I audit architecture Markdown files that reference external diagrams?▼

Yes, you can audit architecture Markdown files that reference external diagrams. The analysis processes design docs and diagram references within the Markdown input to evaluate structural quality and produce the audit report.

How do I trigger an architecture audit to get component scores?▼

To trigger an architecture audit and get component scores, provide your architecture Markdown files and use an explicit request such as 'audit architecture'. This generates both the audit report and the prioritized improvements roadmap in a single run.

What limitations exist when running an architecture audit on design docs?▼

An architecture audit on design docs requires explicit triggers and Markdown inputs to operate. It does not process non-Markdown files directly and relies entirely on the provided documentation to surface structural flaws and generate the improvements roadmap.