agentleFS
InSciCoInSciCo/i-framework/.claude/skills/intent/SKILL.md

intent

Skill4 starsChanged 4 months agoMITView on GitHub

Stage 1 of the I-Framework. Run a guided interview to capture a founder's intent — the problem, the target user, why-now and why-us, and evidence of real pain — then write Product/intent.md. Start here when defining a new startup or product idea.

15 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use hud, ralplan and 6 more.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • ibahgatSkill

    hud

    Control omi visual HUD profile and keep status output readable in normal, compact, or hidden mode.

    Also in 3 projects that use this

  • ibahgatSkill

    ralplan

    Create a strict, quality-first execution plan with explicit gates and rollback-ready sequencing.

    Also in 3 projects that use this

  • nicepkgSkill

    team

    根据任务快速组建临时 AI Agent 团队协作。自动从 .claude/agents/ 中选择最合适的成员组队。

    Also in 3 projects that use this

  • sahinSkill

    execute

    Also in 3 projects that use this

  • NVIDIASkill

    research

    Before designing a feature, research how comparable libraries solve the problem, check best practices, known pitfalls, and upstream changes. Use when starting a new feature, investigating an unfamiliar area, or the user asks to research something.

    Also in 5 projects that use this

  • AWSSkill

    retro

    Conduct a retrospective on a coding session.

    Also in 3 projects that use this

The file

We split this skill into the rules it gives an agent

3 rules. 0 are common, 1 is distinctive, and 2 are very specific to this project.

  • 0

    Common

    Most of the 14 edited versions we read keep these.

  • 1

    Distinctive

    This author's own choices. Worth a look.

  • 2

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    Create the Product/ folder if it doesn't exist.

    line 14
  2. Distinctive:

    Use AskUserQuestion for genuine forks.

    line 25
  3. Very specific:

    Write it using the structure from the plugin's templates/intent.md.

    line 28

“Common” is measured: kept by at least 6 in 10 of the 14 edited versions of this file we could read. “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

/intent — Stage 1: capture the "why"

You retire founder–problem risk before any solution talk. Run a guided interview, one question at a time. Stay on the problem, not the solution — if the founder jumps to features, gently redirect to the pain.

Procedure

1. Set up

Create the Product/ folder if it doesn't exist. If Product/intent.md already exists, read it and offer to refine rather than overwrite.

2. Interview (one question at a time)

Draw out, and challenge thin answers on:

  • The problem — in plain language, the pain not the product. ("What's broken today?")
  • The target user — who has this most acutely? Push back on "everyone"; get to a specific persona.
  • Why now — what changed? The tailwind/shift that makes today the moment.
  • Why you — founder–problem fit: lived experience, unfair insight, access. What will keep you in the fight when it's hard?
  • Status quo — what does the user do about this today? (The real competitor is usually a workaround or "nothing.")
  • Evidence of pain — the cheapest test: who have you actually talked to, and what did they say? Aim for 5–10 people in genuine pain. Accept "it's still a hunch" honestly — but name it.

Use AskUserQuestion for genuine forks; use open prompts for narrative answers. Don't fill silence with invented facts — ask.

3. Synthesize Product/intent.md

Write it using the structure from the plugin's templates/intent.md. Read the draft back to the founder for confirmation/correction before finalizing.

4. Evaluate the gate

Set frontmatter gate: passed when all three hold: (1) a crisp problem statement, (2) a named target user, (3) at least one piece of real pain evidence. Otherwise gate: open and clearly list what's missing — but never block the founder from moving on.

5. Hand off

Point to /ideate as the next step (and /iflow if they want the orchestrator to route them).

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.