stories-review

Community

Iterative QA for user stories to airtight scope.

Authorthrawn01
Version1.0.0
Installs0

System Documentation

What problem does it solve?

This Skill helps product teams and engineers identify gaps, inconsistencies, and missing acceptance criteria in user stories by applying a disciplined three-pass review workflow against the PRD. It guides teams to ship stories that are complete, non-contradictory, and scoped correctly.

Core Features & Use Cases

  • Three-pass evaluation: a Review Agent detects issues, a Validation Agent confirms or rejects findings, and a Skeptic Agent challenges confirmed items to reduce false positives.
  • Iterative improvement: fixes are applied and the user stories are re-evaluated up to a maximum of three iterations until no new confirmed findings emerge.
  • Context-aware validation: can read the PRD, a domain glossary (CONTEXT.md), and architecture context via ADRs to ensure terminology and constraints are respected.

Quick Start

Supply the user stories file path and the PRD path to initiate the three-pass review loop and return findings.

Dependency Matrix

Required Modules

None required

Components

Standard package

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: stories-review
Download link: https://github.com/thrawn01/claude-dotfiles/archive/main.zip#stories-review

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 510,000+ vetted skills library on demand.