agentleFS
jdureyjdurey/skills/forge/SKILL.md

forge

Skill0 starsChanged 4 months agoMITView on GitHub

A premise-first ideation and validation engine. Use the Forge when you want to generate, pressure-test, or de-risk an idea, strategy, product concept, positioning angle, or research direction — anything where the failure mode is "well-designed but already saturated" or "nobody actually pays for this." It validates the premise against live evidence before any design work begins, and fans the prompt across genuinely independent model families (not one model running multiple subagents) to surface disagreement rather than echo consensus. Do NOT use for routine builds, simple lookups, or problems one model is already handling cleanly.

78 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use forge-ship, forge-review and 10 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.
  • redteamlifeSkill

    forge-ship

    Use when the user asks to merge, release, promote, reconcile, or close out work in a repo containing `docs/forge/` or governed by FORGE. Not for per-task commits; those complete inside forge-execute-task.

    Also in 6 projects that use this

  • tonmoy007Skill

    forge-review

    Run a multi-dimensional parallel code review over the current change.

    Also in 8 projects that use this

  • weselbenSkill

    forge-docs

    Load before code changes, before writing docs or an ADR, when a user question exposes a missing how-to, and when closing a chunk of work; also loaded by forge after each squash-merge and by deep-research after a report.

    Also in 3 projects that use this

  • DailenGSkill

    forge-design

    Design, UX, and polish discipline for the forge lifecycle. Covers the design tier, the design brief in docs/DESIGN.md, UX requirements and their verification methods, the per-slice design pass, the UX defect register, and the release polish pass. Load whenever work touches a user-facing surface (GUI, terminal, library API, or operated service), whenever a UX observation needs disposing of, and whenever a release is in reach.

    Also in 3 projects that use this

  • DshamirSkill

    forge-plan

    Takes analysis.json + budget cap → derives the full phase sequence, hyperparameters, instance type, cost estimate, and acceptance thresholds. Emits plan.md (the single human gate document) and plan.json (the machine-readable spec that dispatch-v2 consumes). Refuses to plan if estimated cost exceeds budget×1.2.

    Also in 4 projects that use this

  • tonmoy007Skill

    forge-build

    Run Stage 6 of the Forge pipeline — implementation. Use when the user says

    Also in 3 projects that use this

The file

We split this skill into the rules it gives an agent

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

  • 0

    Common

    Most of the 67 edited versions we read keep these.

  • 6

    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 it when novelty and validity both matter and a wrong-but-plausible answer is expensive: strategy, positioning, product or premise …

    line 24
  2. Distinctive:

    Write a prompt instructing each family to generate candidate premises and immediately kill any that fail the gate against live web …

    line 75
  3. Distinctive:

    No payer means kill.

    line 82
  4. Distinctive:

    Read the distilled responses.

    line 109
  5. Distinctive:

    Always show the kills, not just the survivors.

    line 127
  6. Distinctive:

    Write a prompt with a reality gate built in.

    line 134

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

Forge

An ideation engine built around two disciplines, both learned by getting them wrong.

The failure mode the Forge is designed to prevent: spending real effort on a design whose founding premise is already saturated, dismissed, or lacks a real buyer. By the time that fact surfaces in a conventional process, the sunk cost has made it hard to see clearly. The Forge front-loads the reality check so the gate runs before the design, not after.

When this earns its cost

Use it when novelty and validity both matter and a wrong-but-plausible answer is expensive: strategy, positioning, product or premise ideation, research direction. For purely technical stuck-problem solving with an objective pass/fail gate, a divergent-solve approach is the closer fit. For routine tasks a single model handles clearly, the dispatch overhead is not worth it.

The two non-negotiable disciplines

1. Validate the premise before designing anything. Ideas are cheap; the gate is the point. Before any design work, every candidate premise is tested against live web evidence: Is this space already saturated or actively dismissed by practitioners? Does a real, currently-existing buyer pay for this outcome? Is it different in a way the market rewards? The falsifiability test always points outward at the world, not inward at the logic of the idea itself. Internally consistent is not the same as externally valid.

2. Use genuinely independent model families, not one model with multiple subagents. Fanning a prompt across subagents spawned from the same model is convergent thinking in costume. Different model families (trained by different labs on different data) get stuck in different places. The divergence between families, not the consensus, is what makes the method useful. Use whatever independent families and CLIs you have available; codex, grok, and gemini are examples of this pattern, not requirements.

Phase 0a -- Gate your own premise before dispatch

The panel will faithfully answer whatever premise you hand it, including a false assumption you built in. Prose intentions aren't enough — a bad premise that reads fine costs a full cross-model cycle you can't get back. So write the premise as one literal sentence and run it through this checklist. If any check fails, fix the framing; do not dispatch.

PREMISE: <one literal sentence: what is being forged, for whom, with what assets, on what substrate>
  • Preserve the literal ask. Does the premise forge the thing that was literally asked for, or did you widen it into an adjacent generic goal? "Innovative uses of this specific tool" is not "any productivity win"; "this product's edge" is not "growth in general." If you generalized the ask, you've already lost the signal. Keep the literal noun. When unsure, echo the one-line premise back and get a yes before spending the dispatch — one cheap line beats a wasted cycle.
  • Verify the substrate, don't assume it. Any tool, machine, account, quota, or install the premise depends on must be confirmed with an actual check (run the command, hit the endpoint, check the quota), never assumed. Feasibility reasoning built on an assumed substrate flips the moment the assumption is wrong — verify the box before deciding what runs on it.
  • Strip unearned givens. Does the framing assume credentials, an existing audience, prior relationships, capital, or resources the actual operator does not have? Name only what is genuinely in hand, and state each unearned given as an auto-KILL gate in the prompt — "any path requiring X is a KILL" — not as a soft preference.

Garbage premise in, garbage survivors out. The gate in Phase 0 does not catch a flawed framing; only this step does.

Phase 0 -- Reality gate (almost always run first)

Write a prompt instructing each family to generate candidate premises and immediately kill any that fail the gate against live web evidence, citing real URLs. The gate:

  • G1 Saturation -- already common, crowded, or actively dismissed by practitioners? Find who is already doing it. Saturated or dismissed means kill.
  • G2 Paid demand -- name a real, currently-existing buyer or contract that pays for this outcome, with a verifiable URL (a live job post, a funded company, a paid contract pattern). No payer means kill.
  • G3 Novelty that matters -- different in a way the market rewards? Why has no obvious incumbent already taken it?
  • G4 Edge-fit (when ideating around a specific person's advantage) -- does this genuinely require their particular intersection, or could a generalist do it?

Require each family to show its kills alongside its survivors and end with a forced summary line: "GATE RESULT: N survivors / M killed." A run with zero kills means the gate did not bite. Re-run with a harder gate or a more pointed falsifiability rider.

Give each family a distinct facet or source set (a short per-family focus instruction) so they do not all search the same corners of the web.

Phase 1 -- Divergent generation (after a premise survives the gate)

Same fan-out, new prompt. Each family independently designs an answer in a fixed, comparable output format so you can diff the responses. Use per-family focus instructions to push each toward a different angle rather than letting them converge on the same framing.

Phase 2 -- Adversarial cross-verify

Bundle all families' Phase 1 answers into one file and feed it back: each family attacks the others' designs against explicit pass/fail gates, names the single hardest hole in each, and proposes its own synthesis. Cross-family attack, not self-review.

Phase 3 -- Synthesis and verification (orchestrator does this)

Read the distilled responses. Verify the load-bearing claims yourself with web search before trusting them -- precedent cases and "live demand" URLs are the most confabulation-prone outputs. A single fabricated payer can flip a verdict. Down-weight any family whose evidence is vaguer (generic landing pages, no specific post) relative to one citing exact, checkable URLs.

For a large set of claims, fan the verification out: one researcher-tier pass per claim, each told to try to refute it rather than confirm it. Force a verdict schema so results compose cleanly. For a small claim set (roughly eight or fewer), a single batched refute-mode pass is usually sufficient and cheaper than one-agent-per-claim.

Two failure modes to catch explicitly:

  • A precedent that is real but irrelevant: it happened, but it required resources the operator does not have, so it does not support the claim it is cited for.
  • A stale fact: the company or role was real but has since been acquired or dissolved, so it is no longer the buyer named.

Output discipline

Always show the kills, not just the survivors. The kills are where the gate earns its keep. Each surviving claim should carry its evidence URL; flag any you could not verify. Note provenance: which families ran, which were unavailable, and what you verified versus accepted on the panel's word.

One-paragraph version

Write a prompt with a reality gate built in. Fan it simultaneously to genuinely independent model families -- trained by different labs so they fail differently -- and require each to kill premises that lack real, URL-verifiable demand before designing anything. Collect the survivors, cross-verify load-bearing claims yourself, then synthesize. The goal of the gate is to find kills, not survivors; a clean gate that kills nothing did not bite hard enough.

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.