review-draft

Validate business-layer documentation for structural and substantive integrity.

Updated May 6, 2026
One-click install
npx skills add https://github.com/SuSuSleep/scaffold --skill review-draft-sususleep
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: review-draft
Source: https://github.com/SuSuSleep/scaffold/tree/main/skills/review-draft
Command: npx skills add https://github.com/SuSuSleep/scaffold --skill review-draft-sususleep

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill prevents costly implementation errors by validating business-layer documentation before development begins, ensuring that user stories and use cases are complete, coherent, and ready for planning.

Core Features & Use Cases

  • Structural Validation: Automatically checks for missing sections, placeholders, and required fields in UC and US documents.
  • Substance Review: Analyzes alignment between user stories and test scenarios, ensuring that promises made in the documentation are actually verifiable.
  • ADR Trigger Detection: Identifies complex design decisions that require an Architecture Decision Record (ADR) to prevent future technical debt.

Quick Start

Run the review-draft skill to validate all current documentation drafts and receive a readiness report before starting your implementation plan.

Frequently Asked Questions about review-draft

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

FAQPage Schema
How do I validate user stories and use cases before implementation planning?

To validate user stories and use cases, this skill checks business-layer documentation for structural integrity, missing requirements, and alignment between test scenarios and API contracts before implementation planning begins.

What is documentation structural validation and how does it identify blockers?

Documentation structural validation automatically scans project-specific scaffolds to identify blockers by detecting missing sections, incomplete placeholders, and unrecorded design decisions in use case and user story drafts.

Does this quality gate check alignment between user stories and test scenarios?

Yes, the quality gate performs a substance review to analyze alignment between user stories and test scenarios, ensuring that documentation promises are verifiable and coherent prior to development.

When do I need to trigger an Architecture Decision Record for my user stories?

You need to trigger an Architecture Decision Record when this validation skill detects complex design decisions within your user stories that require documentation to prevent future technical debt.

Can I use this validation on any project-specific documentation scaffold?

Yes, you can use this validation on any project-specific documentation scaffold, as it operates directly on your existing use case and user story structures to identify missing required fields.