agentleFS
S3n0001S3n0001/agent-skills/infer-intent-before-coding/SKILL.md

infer-intent-before-coding

Skill1 starsChanged 2 months agoMITView on GitHub

Turn a vague, conflicting, high-impact, or mechanism-first request into a bounded intent contract before coding. Not for clear routine changes, implementation (engineer-code-change), or planning.

The file

We split this skill into the rules it gives an agent

3 rules. About 0 are common, 3 are distinctive, and 0 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈3

    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:

    Read the repository instructions, then inspect only as much current behavior, callers, tests, types, configuration, and history as it takes …

    line 12
  2. Distinctive:

    If evidence conflicts, describe the concrete conflict and the smallest outcome-preserving resolution rather than choosing silently.

    line 30
  3. Distinctive:

    Consider only edge cases that can affect the requested outcome: invalid or stale input, partial failure and recovery, permission and tenant …

    line 34

≈ “Common” is an estimate: at least 1 in 5 of the 364,980 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

Infer Intent Before Coding

Decide what outcome the change must produce and which boundaries it must respect. The user's stated outcome is authoritative; their proposed mechanism, their diagnosis, and the existing code are all hypotheses.

Build the intent contract

Read the repository instructions, then inspect only as much current behavior, callers, tests, types, configuration, and history as it takes to resolve the ambiguity. Write down:

  • actor, problem, and the observable outcome that counts as success;
  • acceptance conditions and required failure behavior;
  • invariants and public or compatibility contracts that must hold;
  • scope to change, scope to preserve, scope not to touch;
  • each consequential assumption and the evidence behind it.

Existing behavior is evidence, not a veto on an explicitly requested change. A prescribed mechanism ("add a cache") is a clue to the outcome ("search feels instant"); confirm the mechanism serves the outcome before adopting it.

Classify each unknown

UnknownDo this
Discoverable from the repo, docs, tools, or running UILook it up. Never ask the user for facts the workspace can reveal.
Local and reversiblePick the best-supported option; mention it only if it shapes the result.
Consequential: changes product behavior, architecture, public contracts, data, money, security, permissions, destructive scope, or a large amount of workAsk one focused question that names the options and your recommended default.

If evidence conflicts, describe the concrete conflict and the smallest outcome-preserving resolution rather than choosing silently.

Check reachable blind spots

Consider only edge cases that can affect the requested outcome: invalid or stale input, partial failure and recovery, permission and tenant boundaries, concurrency and ordering, compatibility and rollback, and accessibility states for UI work. Scale the pass to uncertainty, blast radius, and reversibility.

For a vague greenfield brief, infer the smallest coherent journey: a real actor, meaningful input, a complete primary flow, a visible or durable result, and essential recovery states. Do not substitute a hollow demo or speculative breadth.

Stop and ask when

  • a consequential unknown remains after inspecting the workspace;
  • the request and the evidence contradict each other in a way that changes the outcome;
  • resolving the ambiguity would need an external write, a destructive action, or production access.

Stay read-only until those are resolved. Investigation never authorizes scope expansion.

Done when

The contract (outcome, acceptance conditions, invariants, scope, assumptions) is written and every remaining question is one only the user can answer. Hand it to engineer-code-change for implementation, or to plan-decision-complete-change when material design decisions still need a plan.

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.