prd-context-to-spec

Converts finalized PRD and frozen project context into a repo-aware spec.md.

Updated Jun 28, 2026
One-click install
npx skills add https://github.com/jason23452/my-skill --skill prd-context-to-spec-jason23452
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: prd-context-to-spec
Source: https://github.com/jason23452/my-skill/tree/main/flow/prd-context-to-spec
Command: npx skills add https://github.com/jason23452/my-skill --skill prd-context-to-spec-jason23452

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? After a PRD is finalized and the project baseline is frozen, teams still need a single, testable specification that bridges product intent and the actual repository state. This Skill generates that spec.md contract so design, engineering, and verification all work from the same source. ## Core Features & Use Cases - Repo-aware spec generation: Combines prd.md, project-context.md, and bootstrap-result.json into a structured spec.md with fixed sections covering functional requirements, business rules, data needs, API expectations, and error handling. - Acceptance Criteria Mapping: Maps every PRD AC to functional requirements in a fixed table, flagging unmappable criteria as Missing instead of silently dropping them. - Blocking and assumption handling: Distinguishes blocking uncertainties (marked decision_required) from non-blocking assumptions, and emits a structured blocked result when required inputs are missing. - Use Case: After bootstrapping a baseline project and freezing its context, run this Skill to produce a Traditional Chinese spec.md in the PRD artifact directory, ready for spec review, design, and task planning. ## Quick Start Use the prd-context-to-spec skill to generate spec.md from the finalized prd.md and frozen project-context.md in the current PRD run directory.

Frequently Asked Questions about prd-context-to-spec

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

FAQPage Schema
How do I turn a PRD into a technical specification document?▼

Provide the finalized prd.md, the frozen project-context.md, and the bootstrap result summary. The Skill generates a spec.md with fixed sections including functional requirements, business rules, API expectations, and an acceptance criteria mapping table.

What inputs are required to generate spec.md from a PRD?▼

Three inputs are mandatory: prd.md, project-context.md, and bootstrap-result.json or an equivalent Bootstrap Result Gate summary. If any are missing or the gate is blocked, the Skill outputs a structured blocked result instead of guessing.

Where is the generated spec.md file written?▼

spec.md is written to the same PRD run artifact directory as prd.md. It is never written to the repo root, targetProjectRoot, targetCodeProjectRoot, or other planning folders.

What happens when the PRD conflicts with the project context?▼

Scope-changing conflicts are not resolved silently. They are recorded in Open Questions and marked decision_required so the spec review gate can escalate them to the user, while non-blocking uncertainties go into Assumptions.

Does every PRD acceptance criterion appear in the spec?▼

Yes. Every PRD AC must appear in the Acceptance Criteria Mapping table with its covering FR or BR. If an AC cannot be mapped, it is still listed with Covered By set to Missing and an explanation.