prd-from-idealisted

Turn a raw product idea (a paragraph, a Notion dump, a half-formed thought) into a structured PROJECT.md (high-level brief) and PRD.md (product requirements document) inside a project's `.workflow/` folder, following the dev-flow contract. Use when the user pastes a product idea and says "let's plan this", "draft a PRD", "what would this look like as a project", or starts a new project from scratch. Also use when a `.workflow/` exists at phase `empty` or `idea_captured` and the orchestrator routes here. Not for: writing code, designing UI, or producing task lists (those are downstream skills).
lukedj78/dev-flow · ★ 4 · Web & Frontend · score 77

Install: claude install-skill lukedj78/dev-flow

# prd-from-idea — idea → PROJECT.md + PRD.md This skill turns an unstructured product idea into two artifacts that downstream skills depend on: 1. **`PROJECT.md`** — the strategic brief. One page. Audience, problem, value proposition, success criteria. The piece other humans read. 2. **`PRD.md`** — the product requirements doc. Several pages. User stories, acceptance criteria, non-goals, open questions. The piece engineers and downstream skills consume. The skill is interactive — it asks the user a small number of high-leverage questions and turns the answers into the docs. It does **not** invent PRD content from nothing. ## When this skill applies - A user pastes a product idea ("I want to build a dashboard for X") and asks to start. - Orchestrator (`dev-flow`) routes here when `phase` is `empty` or `idea_captured`. - A `PROJECT.md` exists but `PRD.md` doesn't — the skill expands the brief into requirements. If a `PRD.md` already exists, the skill enters **revise mode**: it reads the current PRD, asks what's wrong, and edits in place. It does not silently overwrite. ## Contract This skill follows the dev-flow contract — see `references/contracts.md` (vendored copy) for the canonical schema. Key facts: - Output goes into `<project-root>/.workflow/`. - Set `phase = "idea_captured"` after writing `PROJECT.md`; set `phase = "prd_drafted"` after writing `PRD.md`. - Append a `history` entry to `meta.json` for every run. ## Workflow ### Step 1 — Locate the project root +