4.8 KiB
Quick Task
Read building.md first.
-
Clarifying questions are
textorchoice. The first (what to build) carries"templates":"idea","fill":"note". -
Launched on saved prototypes: the first card (after a
choiceof which prototype, if several) is arecap"What the prototype says" (summary: the request, the chosen variant, what carried over) in place of thattextcard;{ok:false,text}adds to the brief. -
A note on an open question: reword it,
"_delete":trueit or send"stands":true(still fits), with your reply. -
Post
"stopWarning":"A quick task saves nothing until it is built, so stopping now loses what we have worked out."at the start and""once the build is under way. -
Scope check:
choice"Too big for a quick task?":1Continue (lightweight format),2Escalate to a full plan; measured counts against thresholds inbody. -
Feature name (escalating):
text,"pattern":"^[a-z0-9]+(-[a-z0-9]+)*$", kebab-case placeholder. -
The plan: doc
plan, one block per section, Steps as a checklist, plusreview"Build this plan?" ("doc":"plan") with verdictsyes("Build it"),modify("Change the plan"),escalate("Plan it properly instead"),abort("Stop here",danger):{"id":"plan","title":"Plan","blocks":[{"id":"summary","state":"settled","md":"## Summary\n\n..."},{"id":"files","state":"settled","md":"## Files to change\n\n- `src/a.ts` - ..."},{"id":"steps","state":"settled","md":"## Steps\n\n- [ ] **1.** Step one\n- [ ] **2.** Step two"},{"id":"verify","state":"settled","md":"## Verify\n\n- [ ] ..."}]}A
modifyreposts the changed blocks. -
Building after
yes: the Plan tab is the live task list; steps are the tasks. Settle the verdict in the post that starts it:{"stopWarning":"","settle":true,"headline":{"stage":"Building","cleared":0,"total":4},"agent":{"status":"working","activity":"Task 1 of 4: step one","quietMinutes":10}}After each step (
building.md→ While you build), repost thestepsblock alone, asmdsince the plan lives only on the page:{"headline":{"cleared":1},"docs":[{"id":"plan","blocks":[{"id":"steps","state":"settled","md":"## Steps\n\n- [x] **1.** Step one\n- [ ] **2.** Step two"}]}],"agent":{"activity":"Task 2 of 4: step two"}}A step that cannot be done is
- [!]with the reason, not counted incleared. A step added mid-build raisesheadline.totalin the same post. Tick Verify boxes in the post that reports the checks. Do notwaituntil the build is done. -
See it running, before the finish: once built, post
review"See it running" ("doc":"plan", verdictsshow("Show me it working"),fine("No need, finish up"), tokensshow me/no) with--wait. Onshow, seenotes/implement.md→ Show me it working; its one line goes in the finishbody.finesettles the card in the finish post. Aftershow, settle it in the post that shows it, then postreview"Does it look right?" ("doc":"shown", verdictsfine("Looks right, finish up"),changes("I want changes"), tokensapproved/needs changes) with--wait.changes: make it, reshow if visible, reopen with athreadreply, wait again. Onlyfineleads to the finish. -
Archive a finished folder: launched on a diagnosed folder now Fixed or an upgrade folder now Done, with nothing past the diagnosis or brief, or on a folder of only prototypes now built, post
confirm"Archive this bug?" ("Archive this upgrade?", "Archive this prototype?") in the same post as "See it running": dry run'sfilesinbody, with any prototype not built named there,yesLabel"Archive it",noLabel"Keep it in specs/",consequencesnamingspecs--completed/<name>/. Yes:node "<S>/specs.mjs" archive <spec>, and say where it went in the finishbody. -
Finish after the build:
commandis the filled-in commit command in the project's format (AGENTS.md),"where":"When you are happy with it, commit it from your terminal:", withreview(Review it now),"commit":true,"changelog":trueand"dashboard":true. Review and dashboard are required. Whichever button is pressed, what follows isbuilding-review.md. -
Lessons first: with lessons to offer (
references/lessons.md, End), post itscardas onelessonsitem with--waitbefore the finish. -
Escalated / aborted: settle the verdict in the finish post:
"command":"/plan2code-1-plan"with the PLAN-DRAFT's path inbody, no review; or"command":"/plan2code-quick-task". Both"dashboard":true.
Stop requests during a build: building.md.
A UI prototype run inside this skill posts {"run":{"event":"ui-prototype-round","id":"<name>-round-<N>"}} once per round drawn, uses a text card to paste the choice into, and opens its page in a separate browser tab.