From e45f1d3b1551115cbf98f840eb010312a76300aa Mon Sep 17 00:00:00 2001 From: meckyp Date: Tue, 3 Nov 2026 19:59:35 +0100 Subject: [PATCH] =?UTF-8?q?=F0=9F=93=9D=20[docs]=20skills:=20name=20the=20?= =?UTF-8?q?human=20gate=20"owner",=20not=20"Eric"?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Lane comments, block templates and the writing standard say owner where they named Eric - ui-refine-loop grills the owner; skill-map.json and the writing-standard reference follow - Credits to Eric Tech stay as they are --- diagrams/skill-map.json | 42 +++++++++---------- diagrams/writing-standard/reference.html | 4 +- .../super-board/references/block-template.md | 4 +- skills/super-board/references/run-workflow.md | 2 +- skills/super-board/references/run.md | 4 +- .../references/writing-standard.md | 6 +-- skills/super-build/SKILL.md | 4 +- skills/super-review/SKILL.md | 8 ++-- skills/ui-refine-loop/SKILL.md | 2 +- skills/ui-refine-loop/references/grill.md | 2 +- skills/ui-refine-loop/references/ledger.md | 2 +- skills/ui-refine-loop/references/taste.md | 2 +- 12 files changed, 41 insertions(+), 41 deletions(-) diff --git a/diagrams/skill-map.json b/diagrams/skill-map.json index d8e76513..82ce4909 100644 --- a/diagrams/skill-map.json +++ b/diagrams/skill-map.json @@ -18,7 +18,7 @@ "label": "/super-board", "kind": "public", "what": "The **autonomous GitHub-Project pipeline**: five verbs (onboard, lint, status, run, stop) take one board shape (Backlog · Ready · Building · QA · Review · Blocked · Done) ==from empty to drained==, with labels qa · bug · feature routing each card.", - "when": "Eric types **/super-board **, or says \"==drain my GitHub project==\" or \"stop super-board\"; with no verb it asks which one.", + "when": "The owner types **/super-board **, or says \"==drain my GitHub project==\" or \"stop super-board\"; with no verb it asks which one.", "how": "The session is an **orchestrator** only: it routes the verb to its reference file, dispatches lane agents, and ==never does product work itself==. Board state is the only state, so `run` is also resume. Every commit, ticket, PR body and comment follows references/writing-standard.md.", "source": [ "_skills/vendor/super-board/skills/super-board/SKILL.md", @@ -62,8 +62,8 @@ "label": "/ui-refine-loop", "kind": "public", "what": "Unattended **Impeccable** check-then-fix loop on one page or component that ==ends in a draft PR== with a Before | After table. Standalone: no board lane ever starts it.", - "when": "Eric runs **/ui-refine-loop** [\"what's wrong\"] [--rounds N], or says \"refine loop\" or \"==polish this page with impeccable==\".", - "how": "Reads the target's code, grills Eric (at most 10 questions) into a **taste file**, then runs the saved ui-refine-loop workflow: each round fresh checkers rank typed problems and a fresh fixer chains Impeccable verbs, polish last. Default 5 rounds; ==a finish reviewer grades every fix==. Commits are `💄 [ui] : …` and the PR body uses super-board-pr-body.sh's marker blocks.", + "when": "The owner runs **/ui-refine-loop** [\"what's wrong\"] [--rounds N], or says \"refine loop\" or \"==polish this page with impeccable==\".", + "how": "Reads the target's code, grills the owner (at most 10 questions) into a **taste file**, then runs the saved ui-refine-loop workflow: each round fresh checkers rank typed problems and a fresh fixer chains Impeccable verbs, polish last. Default 5 rounds; ==a finish reviewer grades every fix==. Commits are `💄 [ui] : …` and the PR body uses super-board-pr-body.sh's marker blocks.", "source": [ "_skills/vendor/super-board/skills/ui-refine-loop/SKILL.md", "_skills/vendor/super-board/workflows/ui-refine-loop.js" @@ -81,7 +81,7 @@ "label": "/visual", "kind": "public", "what": "Turns the current work into ==one self-contained HTML page==. It can be a **branch recap**, a **plan**, or a map of a folder or architecture, with diagrams, a file map and annotated code.", - "when": "Eric runs **/visual**, /visual recap [base], /visual plan [file] or /visual ; ==with no argument visual.py detect picks the mode==.", + "when": "The owner runs **/visual**, /visual recap [base], /visual plan [file] or /visual ; ==with no argument visual.py detect picks the mode==.", "how": "Writes a **data.json** from git facts or the plan, then visual.py render injects it into an inline template with ==no build step==. It screenshots the page headless to check it, and offers to publish only on a yes.", "source": [ "_skills/vendor/super-board/skills/visual/SKILL.md" @@ -134,7 +134,7 @@ "label": "/super-board onboard", "kind": "public", "what": "An 8-step setup wizard (Checks · GitHub · Board · Branch · AGENTS.md · Policies · Bug sources · Review) that installs or repairs what the board needs and writes the config once.", - "when": "Eric runs /super-board onboard (or /super-board:super-board onboard after a plugin install), on a new project, after an upgrade from 2.x, or to check and repair an existing setup.", + "when": "The owner runs /super-board onboard (or /super-board:super-board onboard after a plugin install), on a new project, after an upgrade from 2.x, or to check and repair an existing setup.", "how": "One AskUserQuestion per step with the recommended option first; must-haves are fixed without asking by super-board-setup.py. Answers save to onboard-answers.json as they come, so a halt resumes, and repo files change only at step 8 after \"Write everything\". It ends by naming /super-board lint.", "source": [ "_skills/vendor/super-board/skills/super-board/references/onboard.md", @@ -148,8 +148,8 @@ "label": "/super-board lint", "kind": "public", "what": "Pre-flight readiness check that walks Ready, Building, QA and Review, flags issues that fail any of 18 criteria, proposes a qa/bug/feature label, and dispatches a helper skill per flagged issue.", - "when": "Eric runs /super-board lint before a run, typically after /super-collect filed new Backlog cards.", - "how": "Criteria 13–18 cover what the loop needs: a parseable `## Blocked by` line, a fake with no follow-up card, too big (over ~400 changed lines or many areas), the ticket sections, a checklist AC, and lettered Context steps. Phase 4 routes each flagged pattern to one skill sub-agent while Eric keeps the pace.", + "when": "The owner runs /super-board lint before a run, typically after /super-collect filed new Backlog cards.", + "how": "Criteria 13–18 cover what the loop needs: a parseable `## Blocked by` line, a fake with no follow-up card, too big (over ~400 changed lines or many areas), the ticket sections, a checklist AC, and lettered Context steps. Phase 4 routes each flagged pattern to one skill sub-agent while the owner keeps the pace.", "source": [ "_skills/vendor/super-board/skills/super-board/references/lint.md" ], @@ -161,7 +161,7 @@ "label": "/super-board status", "kind": "public", "what": "Read-only snapshot of the active config, every column in board order (Backlog included), and in-flight workers.", - "when": "Eric runs /super-board status to see where a run stands.", + "when": "The owner runs /super-board status to see where a run stands.", "how": "super-board-status.py reads the board and local in-flight state and prints the columns in the board's own order; it changes nothing.", "source": [ "_skills/vendor/super-board/skills/super-board/references/status.md", @@ -174,7 +174,7 @@ "label": "/super-board run", "kind": "public", "what": "The autonomous loop: repeated waves of the super-board-wave workflow from this session until the board drains or a halt gate fires. Also the resume command.", - "when": "Eric runs /super-board run [--low|--high] []; the default worker_backend \"workflow\" stays in-session, \"claude-p\" opts into the legacy headless runner.", + "when": "The owner runs /super-board run [--low|--high] []; the default worker_backend \"workflow\" stays in-session, \"claude-p\" opts into the legacy headless runner.", "how": "Each wave: rate and usage guard, plan with super-board-wave-plan.sh (which refuses an old `variant: qa-only` config with exit 65), act on sweep/flag/stranded/resume, claim cards by assignee, launch the workflow, reconcile, report. Halts after 3 zero-progress waves, a high block rate, or a stop.", "source": [ "_skills/vendor/super-board/skills/super-board/references/run-workflow.md", @@ -192,7 +192,7 @@ "label": "/super-board stop", "kind": "public", "what": "Graceful shutdown: stops the wave, posts \"stopped mid-flight\" comments, releases assignee claims, and removes the wave lock so the next run resumes.", - "when": "Eric runs /super-board stop or says \"stop the run\" / \"pause the loop\".", + "when": "The owner runs /super-board stop or says \"stop the run\" / \"pause the loop\".", "how": "Stops the workflow (or kills the legacy dispatcher via super-board-stop.sh), comments on every in-flight issue and PR, and strips bot_identity assignees. Resume is just `run` again.", "source": [ "_skills/vendor/super-board/skills/super-board/references/stop.md", @@ -236,7 +236,7 @@ "label": "super-review", "kind": "lane", "what": "**Reviewer lane** and standalone PR review: forms its own hypotheses first, remembers prior findings, classes every finding, and ==merges only through the merge gate==.", - "when": "==Started by the board== for cards in **Review** (always on the session model). Also runnable standalone when Eric says \"review this branch\" or \"is this merge-ready\".", + "when": "==Started by the board== for cards in **Review** (always on the session model). Also runnable standalone when the owner says \"review this branch\" or \"is this merge-ready\".", "how": "Thread scan, prior-report round 1, own pass with code-review, codebase-design and ponytail-review, a rerun of the Tester's exact test command, then an **adversarial truth-check** on non-trivial diffs. One report comment is edited in place every round. ==A clean review merges through the gate== pinned to the reviewed head SHA; exit 7 or 8 parks the card in Blocked with 🙋. Visual problems become a UI ticket, never a ui-refine-loop run. The truth-check sub-agents get a fixed verbatim brief, and Over-engineering is never a Blocker from any of them.", "source": [ "_skills/vendor/super-board/skills/super-review/SKILL.md" @@ -1473,7 +1473,7 @@ "label": "AGENTS.md + CLAUDE.md", "kind": "board", "what": "The project's instruction files: AGENTS.md as the single source of truth with a managed super-board block, and CLAUDE.md as `@AGENTS.md` plus Claude-only rules.", - "when": "Written at onboard step 8 when Eric chose to move his rules (or only add the section); the block is rewritten on re-install.", + "when": "Written at onboard step 8 when the owner chose to move their rules (or only add the section); the block is rewritten on re-install.", "how": "The block sits between `` and ``, rendered from agents-md-block.md with a Writing table that links the writing standard; nothing outside the markers is touched.", "source": [ "_skills/vendor/super-board/skills/super-board/references/agents-md-block.md", @@ -1519,7 +1519,7 @@ "label": "get.sh", "kind": "script", "what": "One-line installer: `curl -fsSL …/get.sh | bash` fetches the latest super-board release and runs install.sh.", - "when": "Eric (or a user) runs it in a project folder to install or upgrade; options --target, --ref, --no-helper-skills, and --no-hooks / --protect-main passed through.", + "when": "The owner runs it in a project folder to install or upgrade; options --target, --ref, --no-helper-skills, and --no-hooks / --protect-main passed through.", "how": "Downloads the release tarball, runs install.sh, adds Matt Pocock's skills via `npx skills@latest add mattpocock/skills` unless told not to, and prints the next step once.", "source": [ "_skills/vendor/super-board/get.sh" @@ -1565,7 +1565,7 @@ "label": "/git-sync", "kind": "public", "what": "Commits the working tree as **one commit per logical change**, merge-pulls, pushes the current branch ==without force==, and reports what it did.", - "when": "Eric runs **/git-sync** or says \"sync\", \"commit and push\" or \"pull and push\", usually ==at the end of a piece of work==.", + "when": "The owner runs **/git-sync** or says \"sync\", \"commit and push\" or \"pull and push\", usually ==at the end of a piece of work==.", "how": "Stages each group by path (never `git add -A`), **refuses secrets**, writes the host's commit format or the writing standard, gates `supabase/` changes on a migration file and advisors, then `git pull --no-rebase` and `git push`. ==The default or a protected branch needs a yes==.", "source": [ "_skills/vendor/super-board/skills/git-sync/SKILL.md" @@ -1724,35 +1724,35 @@ "from": "super-board", "to": "sb-onboard", "label": "routes onboard", - "when": "Eric runs /super-board onboard" + "when": "The owner runs /super-board onboard" }, { "id": "sb-v-lint", "from": "super-board", "to": "sb-lint", "label": "routes lint", - "when": "Eric runs /super-board lint" + "when": "The owner runs /super-board lint" }, { "id": "sb-v-status", "from": "super-board", "to": "sb-status", "label": "routes status", - "when": "Eric runs /super-board status" + "when": "The owner runs /super-board status" }, { "id": "sb-v-run", "from": "super-board", "to": "sb-run", "label": "routes run", - "when": "Eric runs /super-board run, or asks to resume" + "when": "The owner runs /super-board run, or asks to resume" }, { "id": "sb-v-stop", "from": "super-board", "to": "sb-stop", "label": "routes stop", - "when": "Eric runs /super-board stop or says pause" + "when": "The owner runs /super-board stop or says pause" }, { "id": "sb-onb-config", @@ -1793,7 +1793,7 @@ "id": "lint-grill", "from": "sb-lint", "to": "grilling", - "label": "grills Eric", + "label": "grills the owner", "when": "an issue needs a rethink (criteria 10, 11) or has several readings (12)" }, { @@ -2150,7 +2150,7 @@ "id": "u-grill", "from": "ui-refine-loop", "to": "grilling", - "label": "grills Eric", + "label": "grills the owner", "when": "after reading the target's code; at most 10 questions in waves" }, { diff --git a/diagrams/writing-standard/reference.html b/diagrams/writing-standard/reference.html index 16351270..b3395735 100644 --- a/diagrams/writing-standard/reference.html +++ b/diagrams/writing-standard/reference.html @@ -108,7 +108,7 @@

Writing standard

Co-Authored-By: Claude …

PR status card

The first line of the PR. It says where the PR stands.

GitHub alert
ⓘ Note
⏳ In review · round 1 · ✅ 2/3 AC · Closes #790
💡 Tip
✅ Merged · 9c41e07
-
⚠ Warning
🛑 Blocked · needs Eric
+
⚠ Warning
🛑 Blocked · needs owner
> [!NOTE]
 > ⏳ In review · round 1 · ✅ 2/3 AC · Closes #790

PR · Problem

Where it happens, who sees it, how to get there (one step per line), and what happened.

Lettered under Where

Problem

@@ -123,7 +123,7 @@

Solution

  • 413 shows "File too large (max 10 MB)"
  • Client c

    Acceptance criteria

    • 12 MB file shows the size message in 1 s↳ upload-size.spec.ts:14
    • No request over 10 MB↳ spec asserts 0 calls · HAR
    • -
    • No new Sentry events after deploy↳ not verified: needs prod deploy · Eric

Iteration history

The lane timeline. GitHub markdown can't run JavaScript, so the time is fixed when the lane writes it.

Local time from config
+
  • No new Sentry events after deploy↳ not verified: needs prod deploy · owner
  • Iteration history

    The lane timeline. GitHub markdown can't run JavaScript, so the time is fixed when the lane writes it.

    Local time from config
    diff --git a/skills/super-board/references/block-template.md b/skills/super-board/references/block-template.md index 49af3e61..dffffb72 100644 --- a/skills/super-board/references/block-template.md +++ b/skills/super-board/references/block-template.md @@ -39,7 +39,7 @@ Why I (bot) cannot decide: To unblock: [ ] [ ] -Owner: +Owner: Move back: drag this card to Ready after the steps above are done blocked-by: ``` @@ -116,7 +116,7 @@ After a trusted human confirms this version, the next wave returns it to Review PR #

    . isn't in the databases the robot may migrate. Tests green on @; migrated . Evidence: -Reason tag: 🙋 needs you · Owner: +Reason tag: 🙋 needs you · Owner: approval-request: blocked-by: - diff --git a/skills/super-board/references/run-workflow.md b/skills/super-board/references/run-workflow.md index bcf00577..d50850cb 100644 --- a/skills/super-board/references/run-workflow.md +++ b/skills/super-board/references/run-workflow.md @@ -278,7 +278,7 @@ Repeat until a done condition or halt gate fires: ``` Wave 3 · 5 cards → 2 merged · 1 bounced · 1 blocked · 1 failed · usage 5h 62% - 🛡 #15 Blocked 🔐 missing STRIPE_TEST_KEY — owner: Eric + 🛡 #15 Blocked 🔐 missing STRIPE_TEST_KEY — needs owner ❌ #18 failed: build lane returned no result — retried next wave Next: wave 4 (3 cards) | ⏸ paused until 14:05 | ✅ board drained ``` diff --git a/skills/super-board/references/run.md b/skills/super-board/references/run.md index ac3b975b..493b416b 100644 --- a/skills/super-board/references/run.md +++ b/skills/super-board/references/run.md @@ -289,7 +289,7 @@ The agent may turn a `proceed` into a `hold` on evidence. It may turn a mechanic | Verdict | Action | Block template (`block-template.md`) | |---|---|---| | `proceed` | nothing; the Builder starts | — | -| `hold` — done | move card to Blocked | `👯` · names the merged PR / closed issue · Owner: Eric (close as duplicate) · `blocked-by: -` | +| `hold` — done | move card to Blocked | `👯` · names the merged PR / closed issue · Owner: owner (close as duplicate) · `blocked-by: -` | | `hold` — in progress | move card to Blocked | `👯` · names the open PR / card · `blocked-by: ` — the sweep returns it when that closes, and pre-flight then finds it done | | `hold` — unclear | move card to Blocked | `❓` · the missing AC or the contradiction with `file:line` · `blocked-by: -` | | `hold` — too big | move card to Blocked | `❓` · "too big — likely over changed lines / spans " · suggests splitting with `/to-tickets` into vertical slices, each under the cap · `blocked-by: -` | @@ -523,7 +523,7 @@ Every lane writes BOTH on every exit, in the comment format of writing-standard. Did: ✅ Done: ❌ Not done: (omit when nothing) -Next: +Next: ``` - Role = who writes it: `builder` · `qa` · `reviewer` · `collect` · `orchestrator`. Label for a diff --git a/skills/super-board/references/writing-standard.md b/skills/super-board/references/writing-standard.md index 5cbc7775..e01c8c15 100644 --- a/skills/super-board/references/writing-standard.md +++ b/skills/super-board/references/writing-standard.md @@ -113,7 +113,7 @@ Each block closes with ``. |---|---|---| | building, in QA, in review | `> [!NOTE]` | `⏳ In review · round 1 · ✅ 2/3 AC · Closes #790 · head \`3f9c2a1\`` | | merged | `> [!TIP]` | `✅ Merged · \`9c41e07\`` | -| blocked, red check | `> [!WARNING]` | `🛑 Blocked · needs Eric` | +| blocked, red check | `> [!WARNING]` | `🛑 Blocked · needs owner` | A partial PR writes `Refs #N`, never `Closes #N`. A human-only step can ride inside the alert, one `> needs-you: ` line each; the merge gate reads it there or under Risk: @@ -160,7 +160,7 @@ goes in Before | After. - [x] No request over 10 MB\ ↳ spec asserts 0 calls · HAR in `runs/issue-790-qa-v2/` - [ ] No new Sentry events after deploy\ - ↳ not verified: needs prod deploy · Eric + ↳ not verified: needs prod deploy · owner ``` **Iteration history** — folded in `

    `, so the reader sees Problem to Risk first. @@ -344,7 +344,7 @@ Next: | role (who writes it) | `builder` · `qa` · `reviewer` · `collect` · `orchestrator` | | label | `blocker` · `issue` · `suggestion` · `nit` · `question` · `praise` · `report` | | status emoji | ✅ pass/done · ❌ fail · ⏳ in progress · 🛑 blocked · 🙋 needs you · ↩️ moved back · ⚠️ warning | -| Next | `builder` · `qa` · `reviewer` · `Eric` · `none` | +| Next | `builder` · `qa` · `reviewer` · `owner` · `none` | Header regex: `^\[(builder|qa|reviewer|collect|orchestrator)\] \[(blocker|issue|suggestion|nit|question|praise|report)\] \S` diff --git a/skills/super-build/SKILL.md b/skills/super-build/SKILL.md index 715f6d72..9a177aea 100644 --- a/skills/super-build/SKILL.md +++ b/skills/super-build/SKILL.md @@ -145,13 +145,13 @@ handoff complete. Add file summaries and critical inline notes on the PR, not in - `git -C .claude/worktrees/issue-N push -u origin loop/issue-N` - `gh pr create --draft --base --head loop/issue-N --title "🚧 [wip] : "` — the status card says `Refs #N`, never `Closes`, so the merge does not close the issue. - `gh issue edit N --remove-label loop:in-progress --add-label human-gated` -- `gh issue comment N --body "[builder] [report] ⚠️ partial · PR \nDid: \n❌ Not done: \nNext: Eric"` — the issue stays open with `human-gated` until the rest lands. +- `gh issue comment N --body "[builder] [report] ⚠️ partial · PR \nDid: \n❌ Not done: \nNext: owner"` — the issue stays open with `human-gated` until the rest lands. - Report: `🟡 Issue #N partial PR opened — issue stays open (human-gated)` - **Continue dispatching the next issue in the wave.** A WIP-PARTIAL is NOT a halt. The worker did intentional, scoped work and the orchestrator advances. **On dispatcher exit 2 or 3 (worker failed or no done-commit):** - `gh issue edit N --remove-label loop:in-progress` -- `gh issue comment N --body "[builder] [report] ❌ failed · exit \nDid: worker ran; worktree \`.claude/worktrees/issue-N\` kept\n❌ Not done: \nNext: Eric\n\n
    log tail\n\n\`\`\`\n$(tail -50 .planning/super-build-logs/issue-N.log)\n\`\`\`\n
    "` +- `gh issue comment N --body "[builder] [report] ❌ failed · exit \nDid: worker ran; worktree \`.claude/worktrees/issue-N\` kept\n❌ Not done: \nNext: owner\n\n
    log tail\n\n\`\`\`\n$(tail -50 .planning/super-build-logs/issue-N.log)\n\`\`\`\n
    "` - Report to the user with `tail -50` of `.planning/super-build-logs/issue-N.log` - Do NOT open a PR; leave the worktree intact for human inspection - Halt the loop diff --git a/skills/super-review/SKILL.md b/skills/super-review/SKILL.md index 8be99776..7138de35 100644 --- a/skills/super-review/SKILL.md +++ b/skills/super-review/SKILL.md @@ -147,7 +147,7 @@ remembers"); R-ids never change. Did: ✅ Done: ❌ Not done: (omit when nothing) -Next: +Next: | ID | Owner | Class | Where | Finding | Status | |---|---|---|---|---|---| @@ -158,18 +158,18 @@ Next: ``` - Owner: `builder` (Super Build) · `qa` (Super QA) · `ui` (UI ticket; a human runs - `/ui-refine-loop`) · `Eric` (human gate). + `/ui-refine-loop`) · `owner` (human gate). - Mark `blocker` or `should fix` in the Finding cell. Over-engineering is always `should fix`. - Deepening opportunities filed with `super-review-file-refactor.sh` get a row with Status `filed #`. -- Human gates: the header says `🙋 human-gated` and `Next: Eric`; the decision goes in a row. +- Human gates: the header says `🙋 human-gated` and `Next: owner`; the decision goes in a row. For short summaries (wave reports), keep it phone-friendly: ```markdown [reviewer] [report] 🛑 blocked · PR #123 Did: `npm test -- --run imports` green -❌ Not done: R1 functional bug → qa · R2 schema decision → Eric +❌ Not done: R1 functional bug → qa · R2 schema decision → owner Next: qa ``` diff --git a/skills/ui-refine-loop/SKILL.md b/skills/ui-refine-loop/SKILL.md index fcd35aa1..beea841d 100644 --- a/skills/ui-refine-loop/SKILL.md +++ b/skills/ui-refine-loop/SKILL.md @@ -1,6 +1,6 @@ --- name: ui-refine-loop -description: Unattended Impeccable check → fix loop on one page or component. It reads the target's code, grills Eric (at most 10 questions, "you pick" welcome) into a per-project taste and direction file, then runs bounded rounds. Each round a fresh checker runs Impeccable critique and audit (design review and detector in separate sub-agents) and ranks typed problems, and a fresh fixer chains the matching Impeccable commands (polish last), keeps checks green or reverts, and commits. Shots cover before vs now, light and dark, 1440 and 390, plus section crops. A fresh finish reviewer grades every fix, and the loop ends in a draft PR with a Before | After table. Standalone only: started by `/ui-refine-loop `, never by the super-board lanes. Use when the user says "ui-refine-loop", "/ui-refine-loop", "refine loop", "iterate on this page", "polish this page with impeccable", or "keep polishing". +description: Unattended Impeccable check → fix loop on one page or component. It reads the target's code, grills the owner (at most 10 questions, "you pick" welcome) into a per-project taste and direction file, then runs bounded rounds. Each round a fresh checker runs Impeccable critique and audit (design review and detector in separate sub-agents) and ranks typed problems, and a fresh fixer chains the matching Impeccable commands (polish last), keeps checks green or reverts, and commits. Shots cover before vs now, light and dark, 1440 and 390, plus section crops. A fresh finish reviewer grades every fix, and the loop ends in a draft PR with a Before | After table. Standalone only: started by `/ui-refine-loop `, never by the super-board lanes. Use when the user says "ui-refine-loop", "/ui-refine-loop", "refine loop", "iterate on this page", "polish this page with impeccable", or "keep polishing". argument-hint: " [\"\"] [--rounds N] [screenshot paths…]" --- diff --git a/skills/ui-refine-loop/references/grill.md b/skills/ui-refine-loop/references/grill.md index 0e2cf391..0c52f545 100644 --- a/skills/ui-refine-loop/references/grill.md +++ b/skills/ui-refine-loop/references/grill.md @@ -7,7 +7,7 @@ It runs after you have read the target's code area (SKILL.md step 1) and before - **At most 10 questions in total**, across all waves. - **Waves.** Wave 1 asks 3 questions. Ask a second wave (at most 4) only when the answers leave a decision open that would change what the fixers do. Ask a third (whatever is left of the 10) only when wave 2 opens something new. Most runs stop after wave 1 or 2. - **Every question accepts "you pick".** Each one ends with `➡️ `, grounded in what you read in the code. "You pick", "fine" or silence on a question means your recommendation stands. -- **Facts are yours, decisions are Eric's.** Never ask what the code, `PRODUCT.md`, `DESIGN.md` or an existing taste file already answers. Look it up instead. +- **Facts are yours, decisions are the owner's.** Never ask what the code, `PRODUCT.md`, `DESIGN.md` or an existing taste file already answers. Look it up instead. - **Taste file exists?** Ask only about this target's goal and direction, and anything the file leaves open. Don't re-ask its rules. ## Question bank (pick, don't recite) diff --git a/skills/ui-refine-loop/references/ledger.md b/skills/ui-refine-loop/references/ledger.md index 093ca4b8..f199aadb 100644 --- a/skills/ui-refine-loop/references/ledger.md +++ b/skills/ui-refine-loop/references/ledger.md @@ -16,7 +16,7 @@ Example: ``` C1 · visual 22/40 (design 11/20 · audit 11/20 · detector 6) · baseline · P0×0 P1×2 P2×3 P3×1 · committed 4f2a9c1 [distill → layout → polish] - fixed: summary-strip-cramped, header-duplicate-actions · skipped: export-menu-copy (needs Eric: wording) + fixed: summary-strip-cramped, header-duplicate-actions · skipped: export-menu-copy (needs owner: wording) C2 · visual 27/40 (design 14/20 · audit 13/20 · detector 2) · better · P0×0 P1×1 P2×2 P3×0 · committed 9b03e7d [harden → polish] fixed: dark-table-contrast · skipped: — C3 · visual 29/40 (design 15/20 · audit 14/20 · detector 1) · better · P0×0 P1×0 P2×2 P3×0 · committed 1c77d20 [typeset → polish] diff --git a/skills/ui-refine-loop/references/taste.md b/skills/ui-refine-loop/references/taste.md index 169020ab..28a402d4 100644 --- a/skills/ui-refine-loop/references/taste.md +++ b/skills/ui-refine-loop/references/taste.md @@ -16,7 +16,7 @@ One block per target, written by the grill. Until a block exists, the direction - **Keep:** - **Avoid:** - **Users:** -- **Reference:** +- **Reference:** ## Taste rules
    LaneDoneTimeDetails
    🔨 builder✅Oct 2, 10:02 EDTdraft
    🔍 qa❌ v1Oct 2, 10:40 EDTmobile hidden