review-solution

Evaluate solution.md against architecture quality gates and amend findings.

1|Updated Apr 25, 2026
One-click install
npx skills add https://github.com/daddia/space --skill review-solution-daddia
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: review-solution
Source: https://github.com/daddia/space/tree/main/.agents/skills/review-solution
Command: npx skills add https://github.com/daddia/space --skill review-solution-daddia

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Reviews solution.md as a Senior Solution Architect, checking structural soundness, section completeness, NFR specificity, ADR coverage, and drift from what was actually built. Amends the document and appends a verdict.

Core Features & Use Cases

  • Thorough section-by-section evaluation against the project context, goals, and ADR usage.
  • Generates an amended solution.md with explicit findings and a final verdict, plus a review summary.
  • Helps ensure architecture quality gates are consistently applied before sign-off.

Quick Start

Provide solution.md to the reviewer and run the review-solution skill to obtain amendments and verdict.

Frequently Asked Questions about review-solution

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

FAQPage Schema
How do I perform an architecture review on a solution document?▼

To perform an architecture review, evaluate the solution.md against quality gates covering context, runtime, data model, deployment, ADRs, and risk. This identifies structural findings and generates an amended document with a final verdict.

What is a solution.md architecture review and when do I need one?▼

A solution.md architecture review evaluates structural soundness, NFR specificity, and ADR coverage against quality goals. You need one for post-delivery or phase-ready documents, and when major changes occur that require re-validation.

How do I check my ADR coverage and solution document drift?▼

Checking ADR coverage and document drift involves evaluating the solution.md against project context and architecture quality gates. The review identifies blocking and non-blocking findings, amends the document, and appends a concise summary.

Can I use automated architecture quality gates for pre-sign-off validation?▼

Yes, you can apply architecture quality gates to ensure section completeness and NFR specificity before sign-off. The review process checks cross-cutting concepts and deployment views, producing an amended solution.md and a recorded verdict.

What are the limitations of reviewing solution documents for architectural risk?▼

Reviewing solution documents for architectural risk focuses strictly on evaluating provided solution.md content against quality gates. It requires post-delivery or phase-ready documents and is triggered when major changes necessitate re-validation.

What is the best way to document blocking and non-blocking architecture findings?▼

The best way to document architecture findings is to generate a concise review summary alongside an amended solution.md. This summary records both blocking and non-blocking findings while appending a final architectural verdict.