architecture-review

Analyze codebase architecture for module complexity, silent failures, and type safety gaps.

359|32|Updated Jan 27, 2026
One-click install
npx skills add https://github.com/getsentry/warden --skill architecture-review-getsentry
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture-review
Source: https://github.com/getsentry/warden/tree/main/.agents/skills/architecture-review
Command: npx skills add https://github.com/getsentry/warden --skill architecture-review-getsentry

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill identifies critical structural issues in a codebase that hinder reliability, maintainability, and future development velocity.

Core Features & Use Cases

  • Module Complexity Analysis: Detects monolithic files and modules with too many responsibilities.
  • Silent Failure Detection: Finds code paths that hide errors or mask operational problems.
  • Type Safety Audits: Uncovers instances where TypeScript's safety guarantees are bypassed.
  • Test Coverage Gaps: Maps untested critical logic and edge cases.
  • LLM-Friendliness Assessment: Evaluates documentation, naming, and error message clarity for AI-assisted development.
  • Use Case: A senior engineer uses this Skill to perform a pre-release architectural audit, ensuring the codebase is robust, maintainable, and ready for scaling.

Quick Start

Perform a staff-level architecture review on the current codebase, focusing on module complexity and silent failure patterns.

Frequently Asked Questions about architecture-review

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

FAQPage Schema
How do I perform a codebase architecture review to find structural weaknesses?

An architecture review analyzes module complexity, silent failure patterns, type safety gaps, test coverage, and LLM-friendliness to identify structural weaknesses and provide actionable refactoring recommendations for codebase health.

What are silent failure patterns and how do I detect them during code refactoring?

Silent failure patterns are code paths that hide errors or mask operational problems. Detecting them during refactoring involves analyzing the codebase architecture to uncover these hidden paths and prevent reliability issues.

How do I audit TypeScript code for type safety gaps and maintainability issues?

Auditing TypeScript code for type safety gaps involves uncovering instances where TypeScript's safety guarantees are bypassed, while maintainability analysis detects monolithic files and modules with too many responsibilities.

Can I assess my codebase documentation for LLM-friendliness and AI-assisted development?

Yes, an architecture review evaluates LLM-friendliness by assessing documentation, naming, and error message clarity to ensure the codebase is optimized for AI-assisted development workflows.

What is the best way to identify untested critical logic and test coverage gaps?

The best way to identify test coverage gaps is through a comprehensive architecture review that maps untested critical logic and edge cases, ensuring codebase robustness before release.