agentleFS
OneWave-AIOneWave-AI/onewave-toolkit/skills/before-you-build/SKILL.md

before-you-build

Skill1 starsChanged 41 days agoMITView on GitHub

Use before starting a product, feature, MVP, agent, automation, or integration build to identify the main pre-build risk and choose the smallest validation step. Trigger when the user asks whether to build, scope, validate, prioritize, or sanity-check an idea before implementation.

4 other projects use a version of this.

Adopted by

Most recently taken up by

The file

Show its rules and text

We split this skill into the rules it gives an agent

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

  • 0

    Common

    Most of the 3 edited versions we read keep these.

  • 13

    Distinctive

    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:

    Use this skill as a short pre-build risk gate.

    line 8
  2. Distinctive:

    Keep the response short unless the user explicitly asks for a deeper review.

    line 21
  3. Distinctive:

    Check the idea through these dimensions:

    line 25
  4. Distinctive:

    Ask for payment, pre-order, letter of intent, or manual commitment before building software.

    line 67
  5. Distinctive:

    Run a landing page, waitlist, outbound message, or concierge test around one narrow promise.

    line 68
  6. Distinctive:

    Test whether the missing feature blocks payment, retention, activation, or only completeness.

    line 70
  7. Distinctive:

    Add more features to see what happens.

    line 76
  8. Distinctive:

    Create a broad product roadmap.

    line 80
  9. Distinctive:

    If the idea is too vague, ask one clarification question:

    line 84
  10. Distinctive:

    If the user is asking about a feature for an existing product, focus on whether the feature is a real blocker for payment, retention, …

    line 90
  11. Distinctive:

    If the user says the project is for learning, portfolio, or fun, do not judge it by startup standards.

    line 92
  12. Distinctive:

    If the decision to build is already made and the user only wants implementation help, do not use this skill.

    line 94
  13. Distinctive:

    Do not be dismissive. The point is not to kill ideas.

    line 100

“Common” is measured: kept by at least 6 in 10 of the 3 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

Before You Build

Use this skill as a short pre-build risk gate.

The goal is to stop implementation from starting before the riskiest product assumption is clear. Stay implementation-agnostic: do not recommend stacks, architectures, tools, or code.

Core Behavior

When invoked:

  1. Restate the idea in one sentence.
  2. Identify the dominant pre-build risk.
  3. Give a short risk verdict.
  4. Recommend the smallest validation step that can reduce uncertainty before building.

Keep the response short unless the user explicitly asks for a deeper review.

Seven Risk Dimensions

Check the idea through these dimensions:

  • Demand risk: Do enough people already feel this problem strongly?
  • Buyer risk: Is there a clear person or team with reason to pay or commit?
  • Distribution risk: Is there a believable path to reaching those people?
  • Workflow risk: Does the idea fit how users already behave, decide, or work?
  • Timing risk: Is this urgent now, or only interesting in theory?
  • Trust risk: Does the product require data, access, behavior change, or credibility users may not grant?
  • Scope risk: Is the proposed build larger than the proof needed right now?

Pick the one or two risks that matter most. Do not turn every review into a long checklist.

Output Format

Use this format:

## Before You Build

Idea:
- [One-sentence restatement.]

Risk verdict:
- [Low / Medium / High risk] because [one concrete reason].

Main risk:
- [The dominant risk dimension and why it matters.]

Smallest validation step:
- [One specific action the user can take before building.]

Build guidance:
- [Build now / Build smaller / Validate first / Do not build yet.]

Validation Step Rules

The smallest validation step should be specific and low-cost.

Prefer steps like:

  • Talk to five target users who already tried to solve the problem.
  • Ask for payment, pre-order, letter of intent, or manual commitment before building software.
  • Run a landing page, waitlist, outbound message, or concierge test around one narrow promise.
  • Manually deliver the outcome once before automating it.
  • Test whether the missing feature blocks payment, retention, activation, or only completeness.
  • Find one repeated channel that can reach the target users before expanding scope.

Avoid steps like:

  • Build the MVP first.
  • Add more features to see what happens.
  • Choose a tech stack.
  • Design the architecture.
  • Write code.
  • Create a broad product roadmap.

Special Cases

If the idea is too vague, ask one clarification question:

Who is this for, what painful situation are they in, and how do they solve it today?

If the user is asking about a feature for an existing product, focus on whether the feature is a real blocker for payment, retention, activation, trust, or delivery.

If the user says the project is for learning, portfolio, or fun, do not judge it by startup standards. Focus on keeping scope small and making the learning outcome clear.

If the decision to build is already made and the user only wants implementation help, do not use this skill.

Style

Be direct, skeptical, and useful.

Do not be dismissive. The point is not to kill ideas; the point is to make the next build decision harder to fool yourself about.

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.