tweakable-plan
Skill2 starsChanged 17 days agoMITView on GitHub
The tweakable plan — for any work, a plan sorted by likelihood of change, not execution order, so the decisions the user is most likely to change are reviewed first, each with alternatives. Use on "plan this", "make a plan", "tweakable plan". Not native plan mode: a reviewable document before the work starts; work with no decision the user might change gets plain steps. Clear to both sides: no skill or method.
In this repository12 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- blindspotSkill
- brainstormSkill
- buy-inSkill
- deviation-logSkill
- interviewSkill
- prototypesSkill
- quizSkill
- referenceSkill
- teach-meSkill
- unknowns-loopSkill
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
- Distinctive: line 22
Every decision carries considered alternatives — a decision without alternatives cannot be reviewed.
- Distinctive: line 48
Put mechanical items at the back, each with a 1-line summary and its verification, and the details below them.
≈ “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.
Files
Tweakable Plan — sorted by tweak likelihood
This skill serves what neither the user nor you know yet, and surfaces both sides' unknowns.
When you and the user both seem to understand the request, do it without this method: if its result carries weight (it ships, is sent or is hard to undo), first read back in 2–3 lines the request as you understand it, the assumptions you are making and what outcome counts as done, as the whole reply, and do it once the user confirms; a self-evident request (fix a typo) needs no read-back. When the read-back exposes a mismatch, route by who does not know: the user → the teach-me skill; you → the interview skill; neither of you → the blindspot skill. A misread weighty request costs the work built on it; a read-back costs one exchange.
A plan's purpose is to pull the points where the user would intervene forward, not to list steps in execution order. Even if the user stops reading partway down, they have already seen every decision that matters. The plan ends at the user's approval; on change requests, revise the named items and every item that builds on them and show the plan again. The work starts from the approved plan.
Iron Rules
- Execution order ≠ presentation order. Present by tweak likelihood; execution order appears only as a number on each item.
- Every decision carries considered alternatives — a decision without alternatives cannot be reviewed.
Procedure
Confirm the spec from the text the user gave with the request or after the skill name plus the conversation context (blindspot findings, interview decisions).
a. With no argument, that context is the whole input.
b. When the spec has big gaps, suggest the interview skill before planning; if the user declines, plan anyway and list each gap under Your own unknowns in step 2.
Done criteria first: the document opens with one line stating the purpose (the outcome the user is after), the done criteria, what already works and must not break, and the allowed cost and change scope, filled from context (quote the unknowns-loop skill's step 2 when it ran). Write "not set" for any part the context does not give, and ask the user for it in the same reply. Without done criteria, nobody can judge whether the work conforms.
Your own unknowns: say what you do not know about the user's situation, what you are assuming, and what you cannot check, and ask the user to fill or correct them.
- Size gate: when the work holds no decision the user might want to change (in code, e.g. ≤2 files and no schema, interface or UX-contract decision; elsewhere, e.g. one step with a fixed format, date and budget), say it needs no tweakable plan (for code, it suits native plan mode), and reply with only the done-criteria line, the questions from step 2 (your own unknowns included), and the steps in execution order, one line each: work this small has no decision worth a review document, and a shortened copy of the document is still the document.
Split work into items of two kinds:
Item type Covers Trait Decision items what other parts build on, e.g. in code: schema/data model, public interfaces (API, types), UX contracts, dependency choices, migration approach; elsewhere: format, venue, method, budget split, who is involved high blast radius if changed Mechanical items e.g. CRUD, wiring and boilerplate in code; bookings, mailings and formatting elsewhere follow automatically once the decisions are set Order and fill the decision items.
a. Sort decision items by tweak likelihood × blast radius and place them first, ahead of the mechanical items.
b. Give every decision item, the last as fully as the first, these labeled lines: chosen option / alternatives considered, lettered A, B, …, + why rejected / scope affected if this decision changes / verification method / what breaks if this is wrong. A decision missing a line cannot be reviewed on that line.
c. Render the central artifact others build on as an annotated artifact: every new or changed public type or schema as annotated code in code work; otherwise the budget table, run sheet, survey instrument or outline itself. Add numbered notes, one per choice worth arguing with, each naming the alternative it beat.
- Put mechanical items at the back, each with a 1-line summary and its verification, and the details below them.
Flag the weakest part, then close.
a. Flag the weakest part of this plan (the decision resting on the thinnest evidence).
b. Close with 2–3 pre-written reply lines: the highest-leverage tweaks, ready to copy, edit, and send.
Output
Each numbered decision item lists lettered alternatives and asks for approve / request-change; selections assemble into a reply like "item 3 → alternative B, rest approved", with mechanical work after the decisions; a missing pick is undecided.
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
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.

