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.