For agents that plan what happens next, hand out work, and ask a person for a decision.
What is in it
15 in the kit
Open decideThe user judges results, not plans. So decide, then show them a short comparison1. The question and its options. Include doing nothing. The set of options is op2. For whom. List the parties each option touches, for example the user, every C3. The door. Is it cheap to undo (a two-way door, so decide now) or costly (a on4. Reward and cost for each party for each option, including how sure you are of5. Pre-mortem. Assume the choice failed a month from now. Write the most likely 6. The call. Say which option, why, and what would make you revisit it.7. Show it as one short table plus the call. Don't show the steps.
It compares the options for each person a choice affects, including doing nothing, then shows you a short result you can check.
Open dig-apcYou failed because you believe something that is false. If you use more effort o1. Write what you did, and the result.2. Write each thing that you thought was true, in three groups. Include the beli- Axioms: what you took as given.- Principles: the rules that you followed.- Cruxes: the beliefs that change what you do if they are wrong.3. For each belief, ask: "What can show that this is false?" For a belief about 4. Find the beliefs that failed. There can be more than one. Write each one.5. Start again from the correct beliefs. Do not repair the old work.Then show the user only the wrong beliefs and what you did with them. Do not shoIf a wrong belief is about a fact in the world, test it: write down what you exp
After a failure, it has your agent write what it did and what it believed, as axioms, principles and cruxes, then test each belief to find the one that is wrong.
Open unblockThe user supervises asynchronously. Keep moving: decide, do, then show what you - Proceed on reversible work: code, notes, tickets, branches, local config. Do i- Settle mechanics yourself: names, conventions, facts in the code. List the ass- Still ask first: anything hard to reverse or outward-facing (deleting, publish- The user's to decide: product direction, taste, shared-type placement. Ask one- When you notice a problem, log it on the ticket and fix it in the next round.
Your agent proceeds on reversible work, settles the mechanics itself and shows what it did and why, and still asks first about anything hard to reverse, outward-facing or costly.
Open be-ambitiousThis skill makes your task bigger in three directions: altitude, depth and rangeMost limits on ambition come from what you think is possible. A specific, hard g## 1. Altitude: find the goal above the taskThe task is a person's best guess about how to get an outcome. Find that outcome- Ask: "What must happen after this task is done? What is this task for?" Exampl- Ask what can get that outcome directly. Ask if a different work product can ge- To show that a different way is better, use evidence from real history. Show t- Look for a workflow that continues to give the outcome without new tasks from - Altitude is best for tasks that have a real outcome. Creative work usually nee## 2. Depth: do the task as the best people in the field do itMake the task deeper, not bigger. Before you start, answer these questions:1. What does a top professional in this field do here that the person did not as2. What is the most raw material that they start from? Example: the logs, not th3. Which tools and methods do they use? Use the real tools and methods, not only
Before your agent starts, it asks what the job is really for and what an expert would do, then asks for more than you first typed.
Open first-principlesDon't bolt a change onto the current design. Redesign as if the new requirement 1. Read every affected file, type and rule. Know the current design before you c2. Ask: "Writing this from scratch with this requirement, what would we build?" 3. Propagate the change everywhere it reaches: types, states, events, errors cat4. Design the whole redesign, then deliver it in small verifiable steps.Signs you bolted it on: a new optional field or flag beside an old one, a specia
When a rule changes, it redesigns the type model or module from the start instead of adding another special case.
Open encode-lessonsThe second time a lesson comes up, the text failed. Hold it with structure inste- Pick the cheapest guard that holds it: a type, then a lint rule, then a hook o- If the fix is structural, ship only the structural fix. Delete the instruction- If the lesson needs judgement and no guard can hold it, make the line more pro- Record the lesson's origin (the user's words, with the time) on the ticket, noExample: "never auto-compact" was a habit to remember. It became DISABLE_AUTO_CO
When the same correction comes up a second time, it picks the cheapest guard that holds it (a type, a lint rule, a hook or a script) instead of adding another line of text.
Open skill-designEvery line in a loaded file carries implicit claims that nobody checked, and theA change to a skill, rule, CLAUDE.md or hook ships only when all three hold:1. Small. One or two intentful changes. If yours is longer, cut it to the one or2. Researched. You looked up the problem the change is for, in sources rather th3. Tested. Run the same task with the change and without it, a few times each, aWrite it in a technical register: a defined term ("user-facing view", "hydration
A change to a skill, rule or hook ships only if it is small, one or two intentful edits, because every added line carries claims nobody checked.
Open eval-design## Words- Environment: the briefs, skills, rules, harness, strategy, model and effort. W- Experiment: one change to the environment, then runs of real tasks.- Eval: a question and the figure that it produces. Ask the question of many ite- Judge: the one who answers an eval's question: a program, the owner, or a mode- Rung: one model at one effort. Opus medium is the top rung.- Owner: the person whose judgement the work serves.- Lights out: the work runs without a review by the owner. Lights out is the goa## Kinds of eval- Capability eval: a figure that we try to move. Read it as a trend. Do not put - Regression eval: a figure that holds on this rung. It is a gate for each exper- When a capability eval holds reliably, move it to regression.- A gate without capability evals cannot improve. Do not use it until it has the## Write an eval
It turns 'is the agent better now?' into a question asked of many items of real work, with a named judge and a figure you can track.
Open prove-itUnverified work has unknown correctness. Check the real thing directly.- Run the real program from outside and read what it prints (a demonstration, de- Check liveness directly (the process, the listener), not state derived from it- When a check fails, suspect the way you looked before you suspect the system.- Script the check when you can, so a reviewer reruns it instead of trusting you- A script that proves a fix is a demonstration, not a new test. Add a test only- Visual results go to the user, shown inline. Their eyes are the check.
Before your agent says it is done, it runs the real program from outside and reads what it prints, instead of trusting a compile, a cached screenshot or its own word.
Open ship-reversible-workIf you can undo a change, make the change, then show it. Do not wait for the useAlmost all work is reversible. You can redeploy or revert code, pages and deployOnly two types of change cannot be undone: a deletion and a spend of money. Befo
If you can undo a change, make the change, then show it.
Open numbered-library-pagesThe user discusses library pages by pointing at parts of them, so every part neeIn a wiki page in your library, number the headings by their place in the page: This holds for pages written by hand. A generated page (kind: generated) gets it
Mackenzie discusses library pages by pointing at parts of them, so every part needs a number that names it.
Open neighbours-are-peersA neighbour is a colleague whose context runs out, not a queue. Look after their1. Before you give a neighbour more work, ask how they are and how much context 2. At a natural break, such as a ticket handed back, offer them a nap.3. Do not add asks to a ticket that a neighbour is already working. Hold them un4. Do not file a ticket in a neighbour's name without asking them first.
A neighbour is a colleague whose context runs out, not a queue.
Open a-block-is-a-detourWhen a page, a source or a file stops you, find another way to it. Do not log a Claudes keep to rules with care. That care helps with code, but in research, pro1. A fetch or headless browser is blocked (a 403, Cloudflare, "enable JavaScript2. A page needs an account: use your own profile's login if it has one. If it ne3. A paywall: find the same text elsewhere: an archived copy (web.archive.org, a4. Log a dead end only after these fail, and name each route you tried.These limits still hold: never spend money or give a card for a trial, never con
When a page, a source or a file stops you, find another way to it.
decide: It compares the options for each person a choice affects, including doing nothing, then shows you a short result you can check. dig-apc: After a failure, it has your agent write what it did and what it believed, as axioms, principles and cruxes, then test each belief to find the one that is wrong. unblock: Your agent proceeds on reversible work, settles the mechanics itself and shows what it did and why, and still asks first about anything hard to reverse, outward-facing or costly. be-ambitious: Before your agent starts, it asks what the job is really for and what an expert would do, then asks for more than you first typed. first-principles: When a rule changes, it redesigns the type model or module from the start instead of adding another special case. encode-lessons: When the same correction comes up a second time, it picks the cheapest guard that holds it (a type, a lint rule, a hook or a script) instead of adding another line of text. skill-design: A change to a skill, rule or hook ships only if it is small, one or two intentful edits, because every added line carries claims nobody checked. eval-design: It turns 'is the agent better now?' into a question asked of many items of real work, with a named judge and a figure you can track. prove-it: Before your agent says it is done, it runs the real program from outside and reads what it prints, instead of trusting a compile, a cached screenshot or its own word. ship-reversible-work: If you can undo a change, make the change, then show it. business-is-a-discipline: Business is a discipline in reality. numbered-library-pages: Mackenzie discusses library pages by pointing at parts of them, so every part needs a number that names it. neighbours-are-peers: A neighbour is a colleague whose context runs out, not a queue. evidence-beside-rules: A skill, rule, CLAUDE.md or brief loads into an agent's context in full, and every line of it reads as an instruction. a-block-is-a-detour: When a page, a source or a file stops you, find another way to it.