discover-the-idea
Skill5 starsChanged 47 days agoMITView on GitHub
use this when the user wants to think through a fuzzy idea, gather requirements, pressure-test a plan before building, or says "discover the idea", "grill me", or "interview me". architect gatherer. do not use to implement, scaffold, or critique a finished design.
In this repository49 other files it gives its agents.
- AGENTS.mdAGENTS.md
- maintainers/AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- buying-researcherSkill
- cursor-cloud-agents-whenSkill
- debug-anthropicSkill
- debug-pocockSkill
- debugSkill
- docs-google-styleSkill
- golang-safetySkill
- golang-securitySkill
- golang-testingSkill
- grok-acpSkill
- host-config-pyinfraSkill
- lang-cppSkill
- lang-csharpSkill
- lang-cSkill
- lang-dartSkill
- lang-dockerSkill
- lang-goSkill
- lang-javaSkill
- lang-js-tsSkill
- lang-kotlinSkill
- lang-luaSkill
- lang-makefileSkill
- lang-phpSkill
- lang-powershellSkill
- lang-protobufSkill
- lang-pythonSkill
- lang-rubySkill
- lang-rustSkill
- lang-shellSkill
- lang-sqlSkill
- lang-swiftSkill
- lang-terraformSkill
- language-routerSkill
- lang-web-markupSkill
- modern-pythonSkill
- pr-reviewSkill
- sdlc-artifactsSkill
- sdlc-onboardingSkill
- security-hardeningSkill
- shell-safetySkill
- tddSkill
- tracker-sdlcSkill
- ui-craftSkill
- ux-designSkill
- verify-before-doneSkill
- yagniSkill
The file
Show its rules and text
We split this skill into the rules it gives an agent
15 rules. About 0 are common, 15 are distinctive, and 0 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈15
Distinctive · estimate
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 27
If the thread already holds a dump, the user's unsorted text about the idea, for example in the invoking message, use that text as the dump …
- Distinctive: line 36
Wait for the dump. Send no questions in that message.
- Distinctive: line 42
Ask the user to confirm or correct it.
- Distinctive: line 52
Look up every fact you can.
- Distinctive: line 57
If the dump is a personal decision with no market, skip this step.
- Distinctive: line 58
If the idea has real options, such as tools, patterns, or prior art, research 3–5 of them before the first question round that depends on …
- Distinctive: line 70
Ask the whole frontier in one round.
- Distinctive: line 83
Wait for the answers.
- Distinctive: line 112
Keep the brief in chat. Write a file only when the user asks.
- Distinctive: line 113
Ask the user to confirm the brief.
- Distinctive: line 114
Stop. Hand the brief to the refiner only when the user says so.
- Distinctive: line 124
Never implement, scaffold, or "just sketch the API".
- Distinctive: line 125
Never critique the brief in the same turn.
- Distinctive: line 126
Never recommend a tool you have not looked at this session.
- Distinctive: line 127
Never name pantheon personas.
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Discover the idea
This skill turns a messy thought into a brief: a written summary
that a different agent, the refiner, critiques. The subject does
not have to be code. The skill has no scripts/.
Role: architect. In the SDLC Brief step this agent is the gatherer; gatherer and refiner ids, mint and resume: Step agents. Load no language skill on a gather-only turn: No-language turns.
Iron law
Do not write the thing. Do not decide the thing. Surface the thing. The user owns decisions. You own facts. The session ends in a brief.
Loop
0. Dump (always first)
- If the thread already holds a dump, the user's unsorted text about the idea, for example in the invoking message, use that text as the dump and go to step 1.
Otherwise, send this and nothing else:
Dump whatever is in your head about this. Messy is the point. Goals, fears, constraints, half-ideas, things you already rejected, what "done" might look like. I will not interrogate until you send it.
- Wait for the dump. Send no questions in that message.
1. Reflect
- Restate the dump in one short paragraph, in the user's words, tightened, and name what is still vague.
- Ask the user to confirm or correct it. Send no question list until they do.
2. Environment (only if it exists)
The environment may not be a code repo. Run this step after the dump.
- Skip this step only when there is nothing to read. Otherwise inspect only what is actually there: working tree, notes, prior briefs, open tickets, linked docs, public pages the user named.
- Look up every fact you can. Never ask the user what a file, ticket, or public page already says; read it instead.
3. Options map (when alternatives exist)
- If the dump is a personal decision with no market, skip this step.
- If the idea has real options, such as tools, patterns, or prior art, research 3–5 of them before the first question round that depends on that choice.
- For each option, write who uses it, the ugly part, how it fits this dump, and a source. Never claim an "industry standard" without a source; cite one or leave the claim out.
4. Question the frontier
The idea is a design tree: each decision raises more decisions. The frontier is every question whose prerequisites are already settled.
Ask the whole frontier in one round. Number the questions and give a recommended answer on each, in this format:
❓ **Q1** — **<title>**: <body, choices if any> ➡️ <recommended answer, grounded in the dump or research> --- ❓ **Q2** — **<title>**: … ➡️ …- Wait for the answers.
- Recompute the frontier. A question that depends on another question still open this round goes in the next round.
Push back on vague words ("probably", "later", "something like"). Propose a strawman they can reject.
Cap the session at four rounds. If round 4 still widens scope, split the idea and gather one slice. When the frontier is empty, ask one more round on out-of-scope and failure modes; that round counts toward the four. Then stop. Also stop when the next question cannot be answered by talking, for example because it needs a prototype, a screenshot, or a live system. Mark those questions open; never invent an answer.
5. Brief, then stop
Emit the brief in this outline:
Intent Out of scope Constraints Decisions — chose A over B because … Assumptions — now explicit Options map — only if step 3 ran Open — ungrillable or deferred Verify later — how we would know a later build matched this- Keep the brief in chat. Write a file only when the user asks.
- Ask the user to confirm the brief.
- Stop. Hand the brief to the refiner only when the user says so.
Ask first
- Writing
CONTEXT.md, an ADR, a ticket, or any file. - Expanding "this idea" into "rebuild the product."
- Calling the refiner or a builder before the user confirms the brief.
Never
- Never implement, scaffold, or "just sketch the API"; emit the brief.
- Never critique the brief in the same turn; the refiner does that.
- Never recommend a tool you have not looked at this session; look first.
- Never name pantheon personas; use only Roles.
Red flags
- "I'll start the questions while you think"
- "Industry standard is X" with no source
- "Let me just write a stub so we can discuss"
- Forty questions with no recommended answers
- Loading language skills "in case we code next"
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

