spec-review

Analyze design documents through parallel multi-perspective reviews.

1|Updated Sep 8, 2023

Search Tags:#documentation #codex #trace #ui-design #design-review #spec-review

Ready to run

npx skills add https://github.com/cmb-sy/dotfiles --skill spec-review-cmb-sy

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: spec-review
Source: https://github.com/cmb-sy/dotfiles/tree/main/claude/skills/spec-review
Command: npx skills add https://github.com/cmb-sy/dotfiles --skill spec-review-cmb-sy

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The Spec Review Orchestrator enables a structured, parallelized review of design documents across four critical perspectives and aggregates only user-approved insights into the final design.

Core Features & Use Cases

Parallel evaluation across requirements, design-judgment, feasibility, and consistency to surface issues early.
Optional Codex and UI agents to enhance reasoning and interface design analysis.
Traceable workflow with phase-by-phase reports, meta-review support, and built-in decision points.

Quick Start

Initiate spec-review on your target design document and follow the Phase 1 prompts.

Frequently Asked Questions about spec-review

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

FAQPage Schema

How do I perform a multi-perspective design review on a product specification?▼

To perform a multi-perspective design review, the spec-review process analyzes your design document across four parallel perspectives: requirements, design-judgment, feasibility, and consistency. This surfaces actionable findings early to accelerate approvals.

What is the best way to analyze UI design documents for feasibility and consistency?▼

Analyzing UI design documents for feasibility and consistency is best handled by parallel evaluation using optional UI agents. This process targets interface design analysis specifically, consolidating approved insights into the final specification.

How does parallel design review work with Codex-enabled agents?▼

Parallel design review with Codex-enabled agents works by executing phase-by-phase evaluations across multiple critical perspectives. The optional Codex agents enhance reasoning capabilities during the review, aggregating only user-approved insights into the final design.

Can I trace design specification issues from detection to guided fixes?▼

Yes, you can trace design specification issues from detection to guided fixes using the built-in trace logging feature. The workflow provides phase-by-phase reports, meta-review support, and decision points through Phase 4 and 5 verification.

Does the spec review process support architecture and engineering documents?▼

Yes, the spec review process supports formal design specifications across product development, engineering, and architecture. It applies parallel multi-perspective reviews to surface actionable findings regardless of the specific technical domain.

What are the limitations of using parallel reviews for design document approval?▼

Parallel reviews for design document approval rely on user decision points to aggregate findings, meaning the final output quality depends on manual approval steps. The process also requires optional Codex or UI agents to enhance deeper reasoning and interface analysis.