architecture-review

Identify architectural options and document decisions in Architecture Decision Records.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/leandro-br-dev/charhub --skill architecture-review-leandro-br-dev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture-review
Source: https://github.com/leandro-br-dev/charhub/tree/main/docs/agents/planner/skills/architecture-review
Command: npx skills add https://github.com/leandro-br-dev/charhub --skill architecture-review-leandro-br-dev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Complex features often require careful architectural planning and documented decisions. This Skill standardizes the review process and creates Architecture Decision Records (ADRs) to guide implementation.

Core Features & Use Cases

  • Structured review: Evaluate multiple architectural approaches and capture rationale.
  • ADR generation: Create Architecture Decision Records and reference them to steer subsequent work.
  • Implementation guidance: Provide concrete notes for engineers to implement the chosen solution.

Quick Start

Generate an Architecture Decision Record for the feature after completing this review.

Frequently Asked Questions about architecture-review

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

FAQPage Schema
How do I document architecture decisions for complex software features?

During early design reviews, architecture review evaluates multiple approaches against cross-cutting concerns to produce Architecture Decision Records (ADRs) and concrete implementation guidance.

What is the best way to evaluate multiple architectural approaches for a new feature?

Evaluating architectural approaches requires a structured review that identifies available options, weighs cross-cutting concerns, and produces an Architecture Decision Record detailing the chosen solution.

When do I need to create an Architecture Decision Record?

You need an Architecture Decision Record when multiple valid approaches exist for a complex feature and cross-cutting concerns must be evaluated before implementation begins.

Can I generate implementation guidance alongside an ADR?

Yes, the architecture review process produces both an Architecture Decision Record and concrete implementation notes to guide engineers executing the chosen solution.

Does this architecture review process work for cross-cutting concerns?

Yes, the architecture review process explicitly evaluates cross-cutting concerns when comparing multiple architectural options during early design reviews to ensure comprehensive coverage.