architecture-review

Cross-reference code against design docs and produce ADR-backed architecture review documents.

18|3|Updated Mar 28, 2026
One-click install
npx skills add https://github.com/ondrej-svec/heart-of-gold-toolkit --skill architecture-review-ondrej-svec
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture-review
Source: https://github.com/ondrej-svec/heart-of-gold-toolkit/tree/main/plugins/deep-thought/skills/architecture-review
Command: npx skills add https://github.com/ondrej-svec/heart-of-gold-toolkit --skill architecture-review-ondrej-svec

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Deep architectural review of a platform or product — cross-references code against claims, maps failure modes, evaluates scaling bottlenecks, and produces a decision-grade handoff document with ADRs. Use when: reviewing an existing system for scaling readiness, performing a CTO handoff, evaluating platform architecture for enterprise readiness, or auditing a codebase before a major migration. Triggers: architecture review, scaling review, platform review, CTO handoff, system audit, scaling analysis, architecture assessment, production readiness.

Core Features & Use Cases

  • Cross-reference code against architectural claims and design docs to verify alignment.
  • Map failure modes and scaling bottlenecks across the system lifecycle to identify risks.
  • Produce a formal ADR-backed review document suitable for CTO handoffs and enterprise audits.

Quick Start

Analyze a target repository or issue URL to initiate an evidence-based architecture review and generate an ADR-driven report.

Frequently Asked Questions about architecture-review

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

FAQPage Schema
How do I perform an architecture review for production readiness and scaling?

To perform an architecture review for production readiness, cross-reference code against design docs to verify alignment, map failure modes, evaluate scaling bottlenecks, and generate an ADR-backed decision document.

What is an ADR-backed architecture audit and when do I need one?

An ADR-backed architecture audit is a formal evaluation producing decision-grade handoff documents. You need one during CTO handoffs, major migrations, or when validating enterprise readiness of existing platforms.

How do I map failure modes and scaling bottlenecks in an existing codebase?

Mapping failure modes and scaling bottlenecks involves cross-referencing architectural claims against actual code to identify lifecycle risks, verifying system reliability, and documenting findings for CTO handoffs.

Can I use an architecture review to validate platform readiness before a major migration?

Yes, an architecture review validates platform readiness before migration by auditing the codebase, evaluating scaling bottlenecks, and producing a decision-grade handoff document with ADRs.

What is the best way to prepare a CTO handoff document for system design evaluation?

The best way to prepare a CTO handoff document is conducting an evidence-based architecture review that cross-references code, maps failure modes, and outputs formal Architecture Decision Records.

What are the limitations of an evidence-based architecture review?

Evidence-based architecture reviews require cross-referencing actual code with design documentation; systems lacking updated docs or accessible codebases limit the ability to map failure modes and produce accurate ADRs.