myclaude/requirements-driven-workflow/README.md

requirements - Requirements-Driven Workflow

Lightweight requirements-to-code pipeline with interactive quality gates.

Installation

python install.py --module requirements

Usage

/requirements-pilot <FEATURE_DESCRIPTION> [OPTIONS]

Options

Option	Description
--skip-tests	Skip testing phase entirely
--skip-scan	Skip initial repository scanning

Workflow Phases

Phase	Description	Output
0	Repository scanning	00-repository-context.md
1	Requirements confirmation	requirements-confirm.md (90+ score required)
2	Implementation	Code + requirements-spec.md

Quality Scoring (100-point system)

Category	Points	Focus
Functional Clarity	30	Input/output specs, success criteria
Technical Specificity	25	Integration points, constraints
Implementation Completeness	25	Edge cases, error handling
Business Context	20	User value, priority

Sub-Agents

Agent	Role
requirements-generate	Create technical specifications
requirements-code	Implement functionality
requirements-review	Code quality evaluation
requirements-testing	Test case creation

Approval Gate

One mandatory stop point after Phase 1:

• Requirements must achieve 90+ quality score
• User must explicitly approve before implementation begins

Testing Decision

After code review passes (≥90%):

• --skip-tests: Complete without testing
• No option: Interactive prompt with smart recommendations based on task complexity

Output Structure

.claude/specs/{feature_name}/
├── 00-repository-context.md
├── requirements-confirm.md
└── requirements-spec.md

When to Use

• Quick prototypes
• Well-defined features
• Smaller scope tasks
• When full BMAD workflow is overkill

Directory Structure

requirements-driven-workflow/
├── README.md
├── commands/
│   └── requirements-pilot.md
└── agents/
    ├── requirements-generate.md
    ├── requirements-code.md
    ├── requirements-review.md
    └── requirements-testing.md