architecture-review

Cross-reference code against architectural claims and map failure modes into ADR documents.

1|Updated Mar 8, 2026
One-click install
npx skills add https://github.com/aibilitycz/superpowered-toolkit --skill architecture-review-aibilitycz
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture-review
Source: https://github.com/aibilitycz/superpowered-toolkit/tree/main/plugins/super-intelligence/skills/architecture-review
Command: npx skills add https://github.com/aibilitycz/superpowered-toolkit --skill architecture-review-aibilitycz

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Deep architectural review that cross-references code against claims, maps failure modes, and evaluates scalability to produce decision-grade handoff ADRs. This helps teams validate platform designs during scaling, migrations, and CTO handoffs.

Core Features & Use Cases

  • Cross-reference code with architectural claims to identify gaps and risk.
  • Map failure modes across the full lifecycle and generate ADR-backed recommendations.
  • Produce a structured, decision-grade document for architectural reviews, migrations, and platform audits.

Quick Start

Invoke the architecture review on the target repository to produce a decision-grade ADR document.

Frequently Asked Questions about architecture-review

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

FAQPage Schema
How do I review software architecture for scaling readiness?

Architecture review for scaling readiness is performed by cross-referencing source code against architectural claims to identify gaps. It maps failure modes across the full lifecycle and generates decision-grade ADR-backed recommendations for platform migrations.

What is an Architecture Decision Record and when do I need one?

An Architecture Decision Record (ADR) is a structured document capturing architectural decisions and their context. You need an ADR during CTO handoffs, platform audits, and migrations to produce evidence-based analysis and structured documentation.

How do I identify architectural gaps between code and design claims?

To identify architectural gaps, you cross-reference the actual codebase against stated architectural claims. This process evaluates risk management and maps failure modes across the deployment environment to ensure evidence-based analysis.

Can I use architecture review for enterprise platform audits?

Yes, architecture review is applicable to enterprise platform audits across codebases and deployment environments. It evaluates scalability and produces structured, decision-grade documentation for enterprise architecture reviews.

How do I assess risk management during a codebase migration?

Risk management during a codebase migration is assessed by mapping failure modes through the full lifecycle. The review process cross-references code against architectural claims to generate ADR-backed recommendations and structured documentation.

What is the best way to generate a decision-grade handoff document for a CTO?

The best way to generate a decision-grade handoff document is through a deep architectural review that maps failure modes and evaluates scalability. This produces an ADR-backed document validating platform designs for CTO handoffs.