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.