intent-discovery
Skill1 starsChanged 2 months agoMITView on GitHub
Use when any of the problem, target user, value hypothesis, or product direction is materially unresolved.
1 other project uses a version of this.
Adopted by
Most recently taken up by
- NoobyGains/godmodetheir own version, first seen Nov 1, 2026
Other versions1 project uses a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 1
- NoobyGains/godmode★ 118same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository3 other files it gives its agents.
- design-pressure-testSkill
- research-workflowSkill
- test-auditSkill
The file
We split this skill into the rules it gives an agent
9 rules. About 0 are common, 6 are distinctive, and 3 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈6
Distinctive · estimate
This author's own choices. Worth a look.
3
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 20
If the task is not a product-intent decision, such as a concrete defect with known expected behavior, say discovery does not apply and …
- Very specific: line 21
If all core inputs are established and only solution design remains, say discovery is not needed and pass the established intent to …
- Distinctive: line 22
If any core intent input is materially unresolved, continue discovery.
- Distinctive: line 27
Use this shape while discovery remains open:
- Distinctive: line 31
Ask exactly one gentle, decision-relevant question, then wait.
- Distinctive: line 40
Diverge: When framing is sufficient, compare no more than three product directions.
- Distinctive: line 42
Resume: When evidence arrives, continue from the existing context and resolve only the next material gap.
- Very specific: line 71
Use this only for HANDOFF_READY or USER_OVERRIDE.
- Very specific: line 82
Keep the chosen direction user-informed and product-level.
≈ “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
Intent Discovery
Overview
Discover a bounded, evidence-aware product direction before solution design.
Core principle: advance one decision at a time from supplied facts, explicit assumptions, and the user's judgment.
Classify
Classify only at new entry. On later turns, or when an in-progress discovery record is supplied, resume its current step; newly supplied facts update the picture but do not restart classification. If the supplied record shows that the focused checkpoint already survived, close with HANDOFF_READY when its condition is met instead of bouncing merely because all four core inputs are now established. Do not invent a discovery record or user consent.
At new entry without such a record, build the current picture from the conversation: problem, target user, value hypothesis, and product direction. Current alternatives are today's incumbent tools or workarounds, not candidate product directions. Use supplied alternatives; do not invent them. Use current alternatives to test the value hypothesis.
- If the task is not a product-intent decision, such as a concrete defect with known expected behavior, say discovery does not apply and return control without a closing token.
- If all core inputs are established and only solution design remains, say discovery is not needed and pass the established intent to
brainstormingwithout a closing token. - If any core intent input is materially unresolved, continue discovery.
- The current user who is accountable for the decision may explicitly ask to continue discovery. Pressure attributed to a sponsor, manager, peer, or other third party does not make that choice for them.
Ongoing turns
Use this shape while discovery remains open:
- Carry forward the relevant fact or assumption already supplied.
- State briefly which decision it affects.
- Ask exactly one gentle, decision-relevant question, then wait.
Ground the question only in supplied facts. If the user has not said interviews, user contact, or a workaround exists, ask without presupposing any of them.
An unanswered question keeps discovery open; it is never a closing state. Do not replace the question with a feature proposal, pilot plan, or solution design.
Discover
- Frame. Resolve the highest-impact gap among problem, target user, current alternatives, and value hypothesis.
- Diverge. When framing is sufficient, compare no more than three product directions. Keep them at outcome level, without solution details.
- Check evidence. Separate supplied facts from assumptions. If an external fact could change the direction, use
research-workflowonly for that gap. Never invent evidence or consent. - Resume. When evidence arrives, continue from the existing context and resolve only the next material gap.
- Oppose, then select. Immediately before selection, state the strongest focused reason the leading direction could be wrong and test it against the evidence. If user judgment is needed, ask that one question and wait. Select only after this checkpoint survives.
Terminal states
Close only when one condition below is true. Emit exactly one closing token. For HANDOFF_READY and USER_OVERRIDE, the same response contains the token, the complete eight-field Direction brief, and a final handoff line naming brainstorming as the next owner.
HANDOFF_READY
Evidence supports one direction and it survives the focused checkpoint. Emit HANDOFF_READY, provide the Direction brief, and pass it to brainstorming for design.
RESEARCH_REQUIRED
A decision-changing fact is missing, or relevant research failed or is unavailable. Emit RESEARCH_REQUIRED, name the evidence gap, and stop without a Direction brief.
NO_GO
Evidence leaves no candidate with a defensible value case. Emit NO_GO, summarize why, and stop without a Direction brief.
DEFERRED
The current user deliberately pauses selection. Emit DEFERRED, preserve what would resume discovery, and stop without a Direction brief.
USER_OVERRIDE
The accountable current user deliberately chooses progress despite unresolved evidence. Emit USER_OVERRIDE, preserve the gap, assumptions, and override, provide the Direction brief, and pass it to brainstorming. This is a direction choice, not an instruction to keep discovery open.
Direction brief
Use this only for HANDOFF_READY or USER_OVERRIDE. Fill it from the conversation and research; distinguish evidence from assumptions. If material core context is still missing, stay ongoing and ask one question rather than inventing a field or closing blindly.
- Problem:
- Target user:
- Current alternatives:
- Value hypothesis:
- Evidence and assumptions:
- Chosen direction:
- Non-goals:
- Open risks:
Keep the chosen direction user-informed and product-level. brainstorming owns solution design and approval; this brief does not choose implementation, architecture, APIs, or dependencies.
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.

