prod-requirements-normalizer

Convert product briefs and architecture baselines into REQ-* requirements with acceptance criteria.

Updated Mar 22, 2026
One-click install
npx skills add https://github.com/FernanSuoza/AIDD-project-bootstrap --skill prod-requirements-normalizer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: prod-requirements-normalizer
Source: https://github.com/FernanSuoza/AIDD-project-bootstrap/tree/main/templates/skills/prod-requirements-normalizer
Command: npx skills add https://github.com/FernanSuoza/AIDD-project-bootstrap --skill prod-requirements-normalizer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Convert approved product briefs and architecture baselines into clear, testable embedded requirements and acceptance criteria so planning and verification can proceed without ambiguity.

Core Features & Use Cases

  • Requirement normalization: Rewrite inconsistent, duplicated, or vague statements into single-intent REQ-* items that are unambiguous and verifiable.
  • Acceptance criteria drafting: Create measurable Given-When-Then or checklist-style acceptance criteria for each requirement to support testing and planning.
  • Embedding & traceability: Prepare architecture requirements sections using the provided template, assign stable IDs, and link requirements back to source artifacts and unresolved decisions.
  • Use case: After a product brief and architecture baseline are approved, generate REQ-* sections and acceptance criteria to feed backlog planning and architecture review.

Quick Start

Convert the approved product brief and architecture section into REQ-* statements with acceptance criteria and ambiguity notes ready for human review.

Frequently Asked Questions about prod-requirements-normalizer

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

FAQPage Schema
How do I normalize vague product brief statements into testable requirements?

To normalize vague product brief statements, you rewrite inconsistent or duplicated wording into single-intent REQ-* items that are unambiguous and verifiable. This process assigns unique IDs and classifies statements into functional, quality, or constraint types.

What is requirements traceability and when do I need to embed it in architecture baselines?

Requirements traceability links generated requirements back to source artifacts and unresolved decisions. You need to embed it during the requirements-creation phase after architecture baselines are approved, ensuring stable IDs connect each REQ-* item to its source.

How do I write acceptance criteria for embedded requirements using IREB quality gates?

You write acceptance criteria for embedded requirements by drafting measurable Given-When-Then or checklist-style tests for each item. Conforming to IREB quality gates ensures the criteria support testability and pass human review.

Can I convert an approved architecture baseline directly into backlog planning items?

Yes, you can convert an approved architecture baseline into backlog planning items by generating normalized REQ-* statements with acceptance criteria and ambiguity notes. This output is specifically prepared to feed downstream verification and planning phases.

What is the best way to classify requirement statements into functional, quality, or constraint types?

The best way to classify requirement statements is by applying requirements normalization during the planning phase, which parses product briefs to categorize each statement into functional, quality, or constraint types while flagging ambiguity notes for review.