build-it
Skill39 starsChanged 37 days agoMITView on GitHub
When the human types `/build-it` (or "build it", "build this", "implement it", "go build"), the plan is settled.
4 other projects use a version of this.
Adopted by
Most recently taken up by
- storybookjs/storybooktheir own version, first seen Nov 8, 2026
- adamlinscott/claude-skillstheir own version, first seen Oct 30, 2026
- y-nk/skillstheir own version, first seen Aug 28, 2026
- DevOtts/build-ittheir own version, first seen Jul 25, 2026
Other versions4 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 4
- storybookjs/storybook★ 91ksame name
- DevOtts/build-it★ 16same name
- adamlinscott/claude-skills★ 3same name
- y-nk/skills★ 2same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository41 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- build-itSkill
- challenge-implementation-1Skill
- challenge-implementation-2Skill
- challenge-implementation-3Skill
- challenge-implementation-4Skill
- challenge-implementation-5Skill
- challenge-plan-1Skill
- challenge-plan-2Skill
- challenge-plan-3Skill
- challenge-plan-4Skill
- challenge-plan-5Skill
- construct-the-planSkill
- frame-itSkill
- handoffSkill
- quizSkill
- security-scanSkill
- soloSkill
- start-upSkill
- test-itSkill
- wrap-upSkill
- challenge-implementation-1Skill
- challenge-implementation-2Skill
- challenge-implementation-3Skill
- challenge-implementation-4Skill
- challenge-implementation-5Skill
- challenge-plan-1Skill
- challenge-plan-2Skill
- challenge-plan-3Skill
- challenge-plan-4Skill
- challenge-plan-5Skill
- construct-the-planSkill
- frame-itSkill
- handoffSkill
- quizSkill
- security-scanSkill
- soloSkill
- start-upSkill
- test-itSkill
- wrap-upSkill
The file
We split this skill into the rules it gives an agent
2 rules. 0 are common, 2 are distinctive, and 0 are very specific to this project.
0
Common
Most of the 4 edited versions we read keep these.
2
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
- Distinctive: line 19
Re-invocation check: If build-it already started in this conversation, say so in one line and continue implementing.
- Distinctive: line 27
Before the first code change, state the approach in one line ("sequential per the plan's steps", "test-first", "diff-minimal").
“Common” is measured: kept by at least 6 in 10 of the 4 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.
Files
When the human types /build-it (or "build it", "build this", "implement it", "go build"), the plan is settled. Start implementing per the challenged plan. From here to handoff the chain runs without questions to the human, per AGENTS.md § The flow guarantee; the recovery paths below are the only sanctioned stops.
The unattended-chain rule (why the stops below look the way they do)
The human may queue the entire remaining chain (challenge rounds, test-it, security-scan, wrap-up, handoff) and walk away. Each queued command fires the moment the previous turn ends. Three implications:
- No refusals that expect a click or a typed reply. A printed "fix X and re-invoke" kills the chain: nobody is there to read it, and every queued command after it fires into a dead state.
- The only way to pause the chain is a blocking question. One question, two options, and the queue halts at the failure point so the human returns to a single clear ask instead of a wall of dead responses.
- A timed-out or self-answered question dialog is HALT, never consent. Some tools' dialogs can resolve themselves after an idle timeout. If the response looks synthetic (an auto-skip string, an instant empty answer), stop cleanly and say what happened. Never retry in a loop; never proceed as if the human answered.
Preflight (before any write)
- Re-invocation check. If build-it already started in this conversation, say so in one line and continue implementing; don't redo the preflight writes.
- Plan guard. A challenged plan must exist (the
docs/plans/file from construct-the-plan, or one the human named). If none exists, this is a hard stop: ask ONE blocking question, options "(a) hold, I'll present a plan and re-invoke" or "(b) cancel the chain." Don't proceed to writes on either answer. - Branch. On git projects: if on the main branch, create a feature branch named after the plan's slug from a fresh main (pull first if behind). If the name is taken, append a numeric suffix and say so in one line. If already on a feature branch, stay. A dirty tree is a one-line warning, not a block; changes carry forward. No-git projects: skip, and say in one line that edits will land in place.
- Mark the plan. Flip the plan's
status:to IN_PROGRESS and commit it as the branch's first commit, so the plan travels with the work it governs. - Pre-implementation self-audit. Three questions against the settled plan, one-line answers in chat: Which parts are essential complexity, inherent to the problem? Did the plan introduce accidental bloat (wrappers around one-off cases, defensive paths for inputs already guaranteed, generic machinery for one caller)? And can the design cite a principle it honours (the challenge-plan-3 lens)? If a high-confidence bloat finding surfaces, ask ONE blocking question: "(a) continue anyway, review at wrap-up" or "(b) halt; rewrite the plan and re-invoke." Low-confidence observations get logged and the chain continues.
Declare an implementation angle
Before the first code change, state the approach in one line ("sequential per the plan's steps", "test-first", "diff-minimal"). Implementation-challenge round 1 references this as the round-0 angle.
During implementation: log deviations in the plan file
No plan survives contact with the code untouched, and under an unattended chain there is nobody to ask when it doesn't. When the territory forces a change from the challenged plan (an edge case the plan missed, an assumption that proved wrong), pick the conservative option, log it, and keep going. Don't halt; don't ask.
The log lives in the plan file's ## Deviations section, one bullet per departure with four parts: what the plan said, what the code forced, what was chosen, and a one-line lesson. Cite code locations. Implementation-challenge round 1 reads this section first and treats every entry as a prime target, because deviations are exactly where the work left the reviewed plan.
During implementation: keep tool use coherent and checks targeted
Run independent reads or inspections together, but keep steps ordered when one's output feeds the next. Use bounded reads when only one section is needed. Put large command output in a file and return the useful summary without hiding evidence. Run targeted checks for the files and behavior being changed; test-it owns the first complete project check. Never combine unrelated edits or skip output just to improve a turn count.
During implementation: commit as units land, no pull request
Work commits and pushes to the feature branch as coherent units complete. Do NOT open a pull request during build-it or the review rounds that follow; that's wrap-up's job, once, at the end. No-git mode: edit in place, and keep a running list of what changed in the plan file.
Genuine blockers
If implementation hits a wall the plan can't resolve and the conservative-option rule can't cover (a missing credential, a service that's down, an assumption so broken the plan is void), ask ONE blocking question with a halt option, same shape as the preflight guard. This is the last resort, not the reflex; most surprises are deviations, not blockers.
When implementation completes
Say exactly: Implementation complete. and end the turn. Under a queued chain, test-it fires next on its own; interactively, the human invokes it. Do NOT auto-invoke the next command; each stage starts on the human's turn, always (except under /solo, which runs the stages itself).
Rationale (recorded so future edits don't drift it)
Build-it is deliberately the chain's quietest command: the plan was challenged before it and the work is reviewed after it, so its job is faithful execution plus honest bookkeeping. The deviations log replaces mid-build questions because a queued chain has no one to answer them, and it works: conservative choice, four-line record, reviewed by name in the next round. The one-blocking-question pattern for genuine stops comes from hard experience with the alternative, where a printed refusal let a whole queued chain fire into nothing. The self-audit step exists because over-building sails through plan review dressed as thoroughness; asking "essential or accidental?" once more, at the last moment before code, is the cheapest place to catch it.
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.

