agentleFS
lennytoolslennytools/lenny/skills/claudes-gamble/SKILL.md

claudes-gamble

Skill1 starsChanged 2 months agoMITView on GitHub

Use when forced to choose between two or more viable approaches at a design, architecture, or implementation juncture and you need a fast, principled tiebreaker, especially when scale instincts compete with the smallest working solution. Pairs with elon-first-principles, first-principles, and karpathy.

The file

We split this skill into the rules it gives an agent

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

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈2

    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:

    External-system reality is the tiebreaker for integrations: When a fork models another system's behavior, "RATIONAL" means closest to that …

    line 57
  2. Distinctive:

    If neither candidate matches reality, stop and verify before resuming the gamble.

    line 60

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

Claude's Gamble: "Do the hyperscale and the rational approach converge?"

Overview

A forced-juncture tiebreaker. When you must pick and you feel deliberation starting, name the two ends of the spectrum out loud and check whether they agree. The bet: most of the time the scaled-out ideal and the smallest sane path point at the same next move. When they do, there is nothing to deliberate. Just do it.

Core principle: Name the HYPERSCALE approach and the RATIONAL approach. If they CONVERGE, do that immediately. If they DIVERGE, that divergence is information. Take the rational path for v0 and flag the fork.

When to use

  • You're at a fork (which table, which abstraction, build-now vs defer, reuse vs new) and starting to weigh options.
  • "We should build this for scale" is pulling against "ship the smallest working thing."
  • You notice analysis creeping where a decision should be quick.
  • A reviewer/plan adds scope and you're unsure whether to absorb it now.

Not for: genuine product forks that change what you're building (those belong to the human), or choices already settled by the plan/spec.

The method

  1. Name HYPERSCALE: the fully scaled, do-it-right-for-millions-of-users ideal. In a codebase this is often already written down, such as in HYPERSCALE: comments.
  2. Name RATIONAL: the smallest correct thing that works for v0 right now.
  3. Check convergence:
digraph gamble {
    "Name hyperscale + rational" [shape=box];
    "Do they point at the same next move?" [shape=diamond];
    "DO IT - no further deliberation" [shape=box];
    "Take RATIONAL for v0 + leave a HYPERSCALE: note" [shape=box];
    "Real product fork, not an impl detail?" [shape=diamond];
    "Escalate to human" [shape=box];

    "Name hyperscale + rational" -> "Do they point at the same next move?";
    "Do they point at the same next move?" -> "DO IT - no further deliberation" [label="converge"];
    "Do they point at the same next move?" -> "Take RATIONAL for v0 + leave a HYPERSCALE: note" [label="diverge"];
    "Take RATIONAL for v0 + leave a HYPERSCALE: note" -> "Real product fork, not an impl detail?";
    "Real product fork, not an impl detail?" -> "Escalate to human" [label="yes"];
    "Real product fork, not an impl detail?" -> "DO IT - no further deliberation" [label="no"];
}

Quick reference

SituationHyperscaleRationalVerdict
Where to store a task snapshotdedicated snapshot servicereuse an existing task-state recordConverge → reuse (do it)
Cross-project reportingcentralized aggregation servicesummarize each project separatelyDiverge → rational for v0, leave a HYPERSCALE: note
Near-real-time notificationsalways-on event workerscheduled pollingDiverge → rational, escalate only if latency is a product requirement

Standing rules

  1. External-system reality is the tiebreaker for integrations. When a fork models another system's behavior, "RATIONAL" means closest to that system's verified documentation or measured behavior, never implementation convenience. If neither candidate matches reality, stop and verify before resuming the gamble. Any deliberate approximation must be disclosed where users rely on it.
  2. The gamble exists so the human is NOT interrupted. Resolving a fork and logging it (decision · why · how to reverse) IS the deliverable; asking the human mid-run is the failure mode. Batch what they would want to know into the ledger's human review queue for merge-ready. Only hard rails such as credentials, merge or PR actions, real spend, and irreversible changes escalate.

Common mistakes

  • Deliberating after convergence. The whole point: if both ends agree, the decision is already made. Stop and act.
  • Treating divergence as a stall. Divergence is not "ask the human" by default. It is "rational for v0, flag the future." Only escalate a real product fork.
  • Skipping the naming step. Saying "let's just do the simple thing" without naming the hyperscale alternative hides the cases where they genuinely diverge and the fork matters.
  • Using it to delete guardrails. Convergence picks the path, never permission to drop a safety invariant.

Relationship to neighbors

  • elon-first-principles decides whether a thing is required at all (delete scope). Claude's Gamble decides which way to build a thing you've already decided to build.
  • first-principles derives the correct answer from fundamentals when convention is misleading. Use it when you can't yet name a sane "rational" end.
  • karpathy then measures that the chosen path actually works.

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.