agentleFS
ForgeyClapForgeyClap/Forge-Core/.claude/skills/forge-brainstorm/SKILL.md

forge-brainstorm

Skill2 starsChanged 6 days agoMITView on GitHub

Use when the approach is unclear (welke kant op, opties): one direction.

3 other projects use a version of this, 1 of them edited.

Adopted by

Most recently taken up by

The file

We split this skill into the rules it gives an agent

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

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈1

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 1

    Very specific

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

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

    If the request is genuinely ambiguous in a way that changes the answer, ask the ONE most decision-changing question before diverging …

    line 18
  2. Distinctive:

    Do not over-invest: this is a short loop, not a multi-day design-doc process.

    line 25

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

Forge playbook — Structured ideation (brainstorm before build)

Do not duplicate ECC skills — defer to: brainstorming (the deep design-dialogue methodology; it ships with Forge as a pinned vendored skill). This file is the Forge-specific orchestration wrapper: a compact diverge → converge loop sized for a /forge work package rather than a full standalone design doc.

Hard rules

  • No implementation before a written pick + rationale. Even a "simple" task benefits from naming the 2-3 real alternatives and why one was chosen — unexamined assumptions on "simple" work cause the most rework.
  • If the request is genuinely ambiguous in a way that changes the answer, ask the ONE most decision-changing question before diverging (superseded 2026-09: the owner's intake config default is silent, capping the whole build at at most one owner question total — this skill does not get its own separate question budget); otherwise pick the sensible default, state it, and proceed — never silently guess on something consequential.
  • Constraints are gathered from real project evidence (existing architecture, stack, CLAUDE.md, FORGE_PROJECT_PROFILE.md) — not invented defaults that ignore the actual codebase.
  • Do not over-invest: this is a short loop, not a multi-day design-doc process. Match the depth to the task's real complexity/risk (see the fan-out table in CLAUDE.md).

The loop (diverge → constraints → converge → smallest viable first)

  1. Diverge. List 2-4 genuinely different approaches (not trivial variations of the same one). For each: name and what it is · why it could work here · real cost (time/complexity/risk) · one risk it does not address — side by side, so hidden assumptions show.
  2. Constraints. Apply what actually limits the choice here: existing architecture/conventions, stack, team size/skills available, time/complexity budget (fan-out level), security/compliance posture, anything the owner already ruled out.
  3. Converge. Pick one approach and give the rationale in 1-3 sentences — why this one beats the alternatives for this project, not in the abstract. Name what was explicitly rejected and why.
  4. Smallest viable first. Scope the smallest slice that proves the approach works end-to-end before building the full version — the first work package should be small enough to verify quickly, not the whole feature at once.

Output

A short note (inline in the plan, or docs/ if the project already uses design docs) containing: options considered · constraints applied · the pick + rationale · rejected alternatives + why · the smallest-viable-first slice. This becomes the input to the next step, not an end in itself.

Feeds into

The output of this skill is consumed by planner/architect (or the Lead directly on small tasks) to write the actual work package(s) — forge-brainstorm never produces code itself; it produces the decision that the work package is built from.

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.