arch-review

Audit TypeScript codebases for architecture and code-quality issues.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/maxbeaudoin/productflash --skill arch-review-maxbeaudoin
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: arch-review
Source: https://github.com/maxbeaudoin/productflash/tree/main/.claude/skills/arch-review
Command: npx skills add https://github.com/maxbeaudoin/productflash --skill arch-review-maxbeaudoin

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you identify architecture and code-quality risks in a TypeScript web/SaaS codebase using evidence-based, read-only findings, so you can reduce change pain and onboarding cost without “magic” or code modifications.

Core Features & Use Cases

  • Read-only architecture audit focused on structure, boundaries, and maintainability (not security or testing).
  • Evidence-first findings with ranked results, severity, finding kind, and concrete file:line excerpts plus remediation guidance.
  • Guided review across key quality dimensions including SOLID-as-applies, DRY/KISS/YAGNI/POLA, module coupling/cohesion, colocation, client/server/isomorphism boundaries, API consistency, type-safety hygiene, and error-handling patterns.
  • Project-rule validation that re-checks any stated conventions/invariants found in repo docs (e.g., CLAUDE.md/ADRs) and upgrades findings to Violations when explicit rules are broken.

Quick Start

Ask the AI to run an architecture audit on your repository and produce one ranked report with concrete file-and-line evidence and remediation steps.

Frequently Asked Questions about arch-review

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

FAQPage Schema
How do I find architecture risks and module boundary issues in a TypeScript codebase?

An architecture audit identifies structural risks by checking module boundaries, coupling, and cohesion in TypeScript code. It outputs ranked findings with severity, file:line evidence, and remediation guidance to reduce change pain and onboarding cost.

What is the best way to check TypeScript code for SOLID, DRY, and KISS violations?

The best way to check for SOLID, DRY, and KISS violations is an evidence-first code-quality audit. It evaluates your TypeScript project against these heuristics, providing ranked reports with specific file and line excerpts for concrete remediation.

How can I audit client-server boundaries and type-safety hygiene in my web SaaS application?

You can audit client-server boundaries and type-safety hygiene by running a maintainability review on your TypeScript web codebase. This read-only process checks API consistency, isomorphism separation, and error-handling patterns, generating evidence-backed findings.

Does the architecture review process modify my existing code or project files?

An architecture review does not modify your code; it is a strictly read-only audit. It analyzes your TypeScript files to identify quality risks and structural issues, outputting a ranked report with remediation steps without making any code changes.

Can I validate project conventions and invariants from repo docs during a code audit?

Yes, you can validate project conventions during a code audit. The review re-checks stated rules found in repo docs like CLAUDE.md or ADRs, upgrading findings to Violations when explicit invariants are broken, alongside general code-quality smells.

What limitations exist when reviewing error-handling patterns and API consistency in TypeScript?

A limitation of this read-only audit is that it focuses on static structure and maintainability, not runtime behavior. It explicitly notes when runtime verification is needed for error-handling patterns and API consistency, as it does not execute code.