ql-spec

Generate machine-verifiable PRDs with user stories and acceptance criteria.

24|Updated Feb 16, 2026
One-click install
npx skills add https://github.com/andyzengmath/quantum-loop --skill ql-spec
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ql-spec
Source: https://github.com/andyzengmath/quantum-loop/tree/main/skills/ql-spec
Command: npx skills add https://github.com/andyzengmath/quantum-loop --skill ql-spec

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Quantum-Loop's ql-spec formalizes informal feature ideas or approved designs into a machine-verifiable Product Requirements Document (PRD) so downstream agents and reviewers can unambiguously implement and verify work. It prevents ambiguous specs, scope creep, and unverifiable acceptance claims by enforcing structured questions, a nine-section PRD, and strict machine-verifiable criteria.

Core Features & Use Cases

  • Structured Context Gathering: Checks for existing design docs, quantum.json, and repo files to ground the PRD in current project state.
  • Clarifying Questions: Produces 5–8 multiple-choice clarifying questions (A–D) to resolve ambiguity before writing requirements.
  • Verifiable PRD Output: Generates a nine-section PRD with user stories sized for single-agent execution, numbered functional requirements, mandatory non-goals, lifecycle handling, and saves to tasks/prd-<feature-name>.md without initiating implementation.

Quick Start

Generate a formal PRD by providing any existing design context and answering the clarifying multiple-choice questions the skill asks.

Frequently Asked Questions about ql-spec

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

FAQPage Schema
How do I generate a machine-verifiable PRD from a feature description?▼

To generate a machine-verifiable PRD from a feature description, provide your design context to the tool. It will ask 5-8 multiple-choice clarifying questions and output a nine-section PRD with explicit user stories, acceptance criteria, and functional requirements saved to tasks/prd-<feature-name>.md.

What are machine-verifiable acceptance criteria in product requirements?▼

Machine-verifiable acceptance criteria are explicit, unambiguous test conditions embedded in a PRD. They allow autonomous agents and reviewers to programmatically confirm that a user story or functional requirement has been successfully implemented without subjective interpretation.

Can I write user stories for autonomous agents from a one-line feature request?▼

Yes, you can convert a one-line feature request into user stories for autonomous agents. The tool enforces 5-8 clarifying multiple-choice questions to resolve ambiguity, then generates user stories specifically sized for single-agent execution within a formal PRD.

How do I prevent scope creep when creating product requirement documents?▼

Prevent scope creep when creating product requirement documents by enforcing mandatory non-goals and a strict nine-section PRD structure. This formalizes informal ideas into explicit functional requirements with lifecycle handling, preventing ambiguous specs and unrequested features.

Does the PRD generation process start implementation automatically?▼

No, the PRD generation process does not start implementation automatically. It strictly saves the formalized product requirements document to tasks/prd-<feature-name>.md for downstream planning and review, ensuring no code is written before spec approval.

What is the best way to structure a PRD for downstream coding agents?▼

The best way to structure a PRD for downstream coding agents is using a nine-section format with numbered functional requirements, lifecycle checklists, and machine-verifiable acceptance criteria. This ensures unambiguous implementation and verification by autonomous agents.