generating-constrained-specs

Generate PRD and architecture documents with mandatory DEC-* decision citations.

6|2|Updated Dec 19, 2025
One-click install
npx skills add https://github.com/synaptiai/synapti-marketplace --skill generating-constrained-specs
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: generating-constrained-specs
Source: https://github.com/synaptiai/synapti-marketplace/tree/main/plugins/context-ledger/skills/generating-constrained-specs
Command: npx skills add https://github.com/synaptiai/synapti-marketplace --skill generating-constrained-specs

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

The Constrained Spec Generation skill automates the creation of PRD and architecture documents that require explicit DEC-* decision citations, ensuring every claim and design choice is traceable to a decision.

Core Features & Use Cases

  • Loads decisions and risks from the DECISIONS.yaml and RISKS.yaml, then builds a decision index for quick lookup.
  • Generates PRD and architecture documents with mandatory DEC-* citations, and validates constraint gates to prevent uncited content.
  • Cross-references risks across both documents to surface traceability and mitigations in one place.

Quick Start

Use this command to generate decision-backed PRD and architecture documents for a new project, starting from existing DEC decisions and the risk ledger.

Frequently Asked Questions about generating-constrained-specs

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

FAQPage Schema
How do I generate PRD and architecture documents with decision traceability?▼

To generate PRD and architecture documents with decision traceability, use a constrained spec generator that loads DECISIONS.yaml and RISKS.yaml to build a decision index and mandates explicit DEC-* citations for every requirement before validating against constraint gates.

What is decision-backed specification generation for product requirements?▼

Decision-backed specification generation creates PRDs and architecture documents where every claim and design choice is explicitly linked to a DEC-* decision from a decision ledger, ensuring complete traceability across product goals, requirements, and architecture.

How do I enforce DEC-* decision citations across product and architecture specs?▼

You enforce DEC-* decision citations by applying a constraint validation gate that checks generated PRD and architecture documents, preventing uncited content delivery and cross-referencing risks to surface mitigations in one place.

Do I need a DECISIONS.yaml ledger to use constrained spec generation?▼

Yes, constrained spec generation requires a DECISIONS.yaml ledger and a RISKS.yaml file as inputs to build the decision index and risk framework needed to produce traceable specifications with mandatory citations.

What's the best way to cross-reference risks across PRD and architecture documents?▼

The best way to cross-reference risks across PRD and architecture documents is to load RISKS.yaml into a decision index, generate specs with mandated DEC-* citations, and validate constraint gates to surface traceability and mitigations in one place.

Why do my generated PRD documents fail constraint gate validation?▼

Generated PRD documents fail constraint gate validation when they contain uncited content, meaning requirements or design choices lack explicit DEC-* decision citations from the DECISIONS.yaml ledger required for traceable specification delivery.