JefersonMarcioEspindola/skill-prd-consultive

A skill for Claude, ChatGPT and Gemini that writes PRDs the consultative way: before any document exists, a board
of personas questions your idea in the chat. Only when no doubt is left does it write the PRD, ready for Claude Code,
Codex, Cursor or any other coding agent.
Coding agents don't ask when a spec is vague. They fill the gap with a plausible guess and build on top of it with
full confidence. Most PRD templates make this worse: they end with a list of "open questions" that nobody answers
before the agent starts.
This skill flips the order. An investor, a senior dev, your ideal customer, a moderator and, when the topic calls for
it, a legal expert push on the idea first. Every doubt ends as a decision, a scope change or an accepted
risk. The PRD records decisions, not questions.
## Contents
How it works
The board
Two modes
What you get
Install
Starter prompt
What happens after you press Enter
Your profile
Language and country
Example
Make your own board
FAQ
Contributing
## How it works
mermaid
flowchart LR
A[Idea] --> B[Understanding problem, audience, positioning]
B --> C{The board signal, objection, question}
C -->|open objections| D[Rebuttals up to 3 rounds]
D --> C
C -->|all settled| E[Convergence MVP scope, flows, data, stack, metric]
E --> F[Decision sheet you approve]
F --> G[PRD.md]
G --> H[PRD.html]
G --> I[PLAN.md optional]
Nothing is written to a file until you approve the decision sheet: positioning, what's in and out of the MVP,
stack, success metric, decisions, accepted risks and the assumptions the skill made on its own, so you can correct
them.
## The board
| Who | What they want to know |
| Helena, investor | Who pays, how much, and what stops someone from copying you in a day |
| Caio, senior dev | The riskiest part, what to cut from the MVP, what depends on third parties |
| Bia or Lucas, ideal customer | Would I use it? Why would I switch from what I do today? |
| Téo, moderator | Runs the session, keeps the objection board, turns debates into decisions |
| Dr. Lúcia, legal expert | Joins when the idea touches sensitive data, money, regulated sectors or AI decisions |
Every persona gives a signal (🟢 would go, 🟡 with conditions, 🔴 not yet), their strongest objection and one
question. Each one has a history, a way of talking and blind spots that the others balance out, so they disagree
with each other the way a real board does. A signal only changes with an argument or evidence, never because you
insisted. Nobody says just "great idea".
The ideal customer adapts to your audience: if the product is for personal trainers, Bia is a personal trainer.
## Two modes
| | Fast mode | Consultative mode |
| For | You've done the research and just want the document | You have an idea and want to know if it holds up |
| What happens | One round of blocking gaps, a lightning opinion from the board, decision sheet, done | Understanding, full board with rebuttals, convergence, verdict, decision sheet |
| Typical length | 2 to 4 messages | 8 to 15 messages |
You control the pace at any time: "speed up", "I want to hear only Helena", "go back, I changed my mind about
pricing".
## What you get
| File | For | What's inside |