agentleFS
alexderzalexderz/agentic-toolbox/skills/discover-the-idea/SKILL.md

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.

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
  1. Distinctive:

    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 …

    line 27
  2. Distinctive:

    Wait for the dump. Send no questions in that message.

    line 36
  3. Distinctive:

    Ask the user to confirm or correct it.

    line 42
  4. Distinctive:

    Look up every fact you can.

    line 52
  5. Distinctive:

    If the dump is a personal decision with no market, skip this step.

    line 57
  6. Distinctive:

    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 …

    line 58
  7. Distinctive:

    Ask the whole frontier in one round.

    line 70
  8. Distinctive:

    Wait for the answers.

    line 83
  9. Distinctive:

    Keep the brief in chat. Write a file only when the user asks.

    line 112
  10. Distinctive:

    Ask the user to confirm the brief.

    line 113
  11. Distinctive:

    Stop. Hand the brief to the refiner only when the user says so.

    line 114
  12. Distinctive:

    Never implement, scaffold, or "just sketch the API".

    line 124
  13. Distinctive:

    Never critique the brief in the same turn.

    line 125
  14. Distinctive:

    Never recommend a tool you have not looked at this session.

    line 126
  15. Distinctive:

    Never name pantheon personas.

    line 127

≈ “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.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

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)

  1. 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.
  2. 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.

  3. Wait for the dump. Send no questions in that message.

1. Reflect

  1. Restate the dump in one short paragraph, in the user's words, tightened, and name what is still vague.
  2. 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.

  1. 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.
  2. 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)

  1. If the dump is a personal decision with no market, skip this step.
  2. 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.
  3. 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.

  1. 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>**: …
    ➡️ …
  2. Wait for the answers.
  3. 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

  1. 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
  2. Keep the brief in chat. Write a file only when the user asks.
  3. Ask the user to confirm the brief.
  4. 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"

Download now (ZIP)

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
What did you use it for? e.g. Reviewing pull requests in a Rails app

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.