doc-req

Decompose BRD, PRD, and EARS inputs into atomic REQ v3.0 documents.

16|3|Updated Nov 10, 2025
One-click install
npx skills add https://github.com/vladm3105/aidoc-flow-framework --skill doc-req
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: doc-req
Source: https://github.com/vladm3105/aidoc-flow-framework/tree/main/.claude/skills/doc-req
Command: npx skills add https://github.com/vladm3105/aidoc-flow-framework --skill doc-req

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill enables the decomposition of complex system requirements into atomic, implementation-ready REQ documents (Layer 7) using REQ v3.0 format, ensuring traceability and SPEC-readiness.

Core Features & Use Cases

  • Decompose BRD/PRD/EARS into atomic requirements
  • Define acceptance criteria, interfaces, data schemas, and quality attributes
  • Generate SPEC-ready traceability and implementation guidance

Quick Start

Use doc-req to create REQ-NN entries with 12-section REQ v3.0 structure and SPEC traceability.

Frequently Asked Questions about doc-req

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

FAQPage Schema
How do I decompose broad requirements into atomic REQ documents?

Decompose requirements by breaking down BRD, PRD, EARS, or BDD artifacts into individual, implementation-ready REQ v3.0 documents using the 12-section framework. Each atomic requirement captures a single, testable behavior with acceptance criteria, interfaces, and data schemas to enable downstream SPEC creation and traceability.

What is REQ v3.0 format and when should I use it?

REQ v3.0 is a standardized 12-section requirements format that structures atomic requirements for precision, traceability, and SPEC-readiness. Use it when converting high-level requirements into Layer-7 artifacts that must enforce compliance, link to upstream sources, and prepare for implementation and validation artifacts.

How do I ensure traceability from BRD to atomic requirements?

Structure each REQ v3.0 document to explicitly reference its upstream artifact (BRD, PRD, EARS, ADR, or SYS section). The Skill enforces traceability links and SPEC-readiness scoring, making validation and downstream integration auditable from source through implementation.

Can I create atomic requirements from different source formats like EARS or ADR?

Yes. The Skill decomposes atomic requirements from multiple upstream formats—BRD, PRD, EARS, BDD, ADR, and SYS—into consistent REQ v3.0 structure. Source format differences are normalized into a unified Layer-7 requirements layer ready for SPEC and CTR artifact generation.

What makes a requirement SPEC-ready after decomposition?

A requirement is SPEC-ready when it meets the REQ v3.0 12-section framework with clear acceptance criteria, defined interfaces, data schemas, quality attributes, and verifiable traceability to upstream sources. The Skill enforces SPEC-readiness scoring to validate each atomic requirement before downstream handoff.

What happens after I create atomic REQ documents?

Atomic REQ v3.0 documents feed downstream into SPEC (specification), CTR (contract), and IMPL (implementation) artifacts. Traceability links and SPEC-readiness scores enable validation, integration testing, and audit trails from requirements through delivery.