task-pipeline-skill 1.88.1 → 1.90.0

package/plugins/task-pipeline/skills/task-pipeline/templates/brief.md

@@ -8,6 +8,9 @@
 - **Task (one line):** <what the operator asked for, restated>
 - **UI verdict:** yes / no — does this touch a user-facing surface (web/mobile/CLI/TUI)?
   If yes, the stage-3 super-ux UX track is armed.
+- **surface_class:** flagship / product / internal / ad — UI tasks only. Selects the
+  visual gate profile: the director record's fields at stage 3, whether the visual half
+  of the look gates stage 6, and whether stage 10 needs the approved contact sheet.
 
 ## Contents
 
@@ -129,9 +132,9 @@ is not neutral — it is a scheduled interruption.
 | 0 Docs regime | Where settled things live (register or ADR set — one home, never both); who may write it; lease mechanism present, or is this run `ungated`? Gate command + ratchet floors; may this run raise a floor? | … |
 | 1 Docs | External libs/APIs/SDKs in play; any context7 can't resolve → where their docs live | … |
 | 2 Decompose | Platform (several capabilities/surfaces) or one module? If platform — deploy cadence: per module, or once at the end | … |
-| 2–3 Spec | UI verdict (arms super-ux); scenario-tracing waiver, if any | … |
+| 2–3 Spec | UI verdict (arms super-ux) and `surface_class`; scenario-tracing waiver, if any | … |
 | 3 Design surface | UI only: Figma on or text-only (check `docs/ux/foundation.md` → Design tooling first); Figma MCP connected? **If not — ship text-only, or stop and connect it?** | … (super-ux never blocks on a missing MCP, so an unanswered row here ships the feature without mockups) |
-| 3 Design file | Figma on only: **which team/org + which file** — existing URL, or "create one in team `<name>`" **with creation authorized**. Canonical record: `docs/ux/foundation.md` → Design tooling | … (team: `<name>` · file: `<url>` \| `create in <team>, authorized` — never create when a recorded file resolves) |
+| 3 Design file | Figma on only: **which team/org + which file per surface** (App, Web, ASO) — existing URL, or "create one in team `<name>`" **with creation authorized**. Canonical record: `docs/ux/foundation.md` → Design tooling | … (team: `<name>` · App: `<url>` · Web: `<url>` · ASO: `<url>` \| `create in <team>, authorized` — never create when a recorded file resolves) |
 | 4–5 Dev | Base branch; worktree/branch policy; is `main` off-limits; commit convention; task tracker | … |
 | 5 Integration | How the branch lands — direct merge, PR (who approves), or "leave it, I'll merge"; is parallel fan-out (one worktree per implementer) wanted? | … |
 | 6 Tests | Test command; what "green" means; known-red baseline; coverage expectation | … |

package/plugins/task-pipeline/skills/task-pipeline/templates/browser-claims.json

@@ -1,6 +1,11 @@
 {
  "schema_version": "browser-claims/1",
- "note": "One row = one browser claim: which REQ/scenario it serves, which STATE it was captured in, and which KIND of check produced it — the look, the spec suite or the library script (the browser.md split). A functional PASS never yields a visual PASS; an artifact closes only the state it was captured in (the initial screenshot does not close an opened/error claim); no browser channel means status NOT_RUN with the reason, never a quiet green. python3 test/browser_claims_test.py validates a filled copy with stdlib only.",
+ "note": "One row = one browser claim: which REQ/scenario it serves, which STATE it was captured in, and which KIND of check produced it — the look, the spec suite or the library script (the browser.md split). A functional PASS never yields a visual PASS; an artifact closes only the state it was captured in (the initial screenshot does not close an opened/error claim); no browser channel means status NOT_RUN with the reason, never a quiet green. python3 test/browser_claims_test.py validates a filled copy with stdlib only. THE VISUAL LOOK (references/browser.md → The visual half) is the same file, not a second schema: a look row that carries `axes` is a frame of the contact sheet — one SCR state at one viewport × theme × text × locale, with its `capture` record (revision, route, motion, captured_at, source), the Figma frame and/or approved `baseline` it is compared against, the `diff` of that comparison, and the `rubric` items read on it (type G gate / J judge / H human; a J item stays NOT_ASSESSED until a labelled set calibrates the judge; every FAIL carries its region → defect → fix triple). File-level: the `surface` and `revision` the sheet is for, `review_rounds` (each return from the person with triples adds one — the measure of passes), and `approved_by` / `approved_at`, which make its frames the next baseline. Rows cover the states pairwise across the axes plus the mandatory pairs (dark × large text, RTL × narrow), never the full cross product. Frames and the viewing HTML stay out of git; this JSON goes in. python3 scripts/visual_gate.py sheet <file> --class <surface_class> validates it.",
+ "surface": "landing",
+ "revision": "<commit the frames were captured at>",
+ "review_rounds": 0,
+ "approved_by": null,
+ "approved_at": null,
  "claims": [
   {
    "id": "BC-01",
@@ -49,6 +54,223 @@
    "artifact_state": null,
    "status": "NOT_RUN",
    "reason": "the spec suite half — its PASS counts for functional claims only"
+  },
+  {
+   "id": "BC-05",
+   "req": "REQ-5",
+   "scenario": "SCN-007",
+   "component": "SCR-01",
+   "state": "SCR-01/default",
+   "kind": "look",
+   "axes": {
+    "viewport": "375x667",
+    "theme": "light",
+    "text": "default",
+    "locale": "en"
+   },
+   "artifact": "shots/landing/SCR-01-default-375x667-light-default-en.png",
+   "artifact_state": "SCR-01/default",
+   "capture": {
+    "revision": "<commit the frames were captured at>",
+    "route": "/",
+    "motion": "reduced",
+    "captured_at": "2026-10-07T00:00:00Z",
+    "source": "the capability that took it, e.g. chrome-devtools take_screenshot"
+   },
+   "figma_frame": "https://www.figma.com/design/<fileKey>/<file>?node-id=<frame>",
+   "baseline": null,
+   "diff": {
+    "against": "figma",
+    "status": "NOT_RUN",
+    "reason": "template row — the frame is compared once it is captured"
+   },
+   "rubric": [
+    {
+     "id": "R1",
+     "type": "G",
+     "status": "NOT_ASSESSED"
+    },
+    {
+     "id": "R7",
+     "type": "J",
+     "status": "NOT_ASSESSED",
+     "note": "a judge item stays NOT_ASSESSED until a labelled set calibrates the judge"
+    }
+   ],
+   "status": "NOT_RUN",
+   "reason": "template row — the visual look: one SCR state at one point of the axes matrix"
+  },
+  {
+   "id": "BC-06",
+   "req": "REQ-5",
+   "scenario": "SCN-007",
+   "component": "SCR-01",
+   "state": "SCR-01/empty",
+   "kind": "look",
+   "axes": {
+    "viewport": "375x667",
+    "theme": "dark",
+    "text": "200%",
+    "locale": "ar"
+   },
+   "artifact": "shots/landing/SCR-01-empty-375x667-dark-200pct-ar.png",
+   "artifact_state": "SCR-01/empty",
+   "capture": {
+    "revision": "<commit the frames were captured at>",
+    "route": "/",
+    "motion": "reduced",
+    "captured_at": "2026-10-07T00:00:00Z",
+    "source": "the capability that took it, e.g. chrome-devtools take_screenshot"
+   },
+   "figma_frame": "https://www.figma.com/design/<fileKey>/<file>?node-id=<frame>",
+   "baseline": null,
+   "diff": {
+    "against": "figma",
+    "status": "NOT_RUN",
+    "reason": "template row — the frame is compared once it is captured"
+   },
+   "rubric": [
+    {
+     "id": "R1",
+     "type": "G",
+     "status": "NOT_ASSESSED"
+    },
+    {
+     "id": "R7",
+     "type": "J",
+     "status": "NOT_ASSESSED",
+     "note": "a judge item stays NOT_ASSESSED until a labelled set calibrates the judge"
+    }
+   ],
+   "status": "NOT_RUN",
+   "reason": "template row — the visual look: one SCR state at one point of the axes matrix"
+  },
+  {
+   "id": "BC-07",
+   "req": "REQ-5",
+   "scenario": "SCN-007",
+   "component": "SCR-01",
+   "state": "SCR-01/error",
+   "kind": "look",
+   "axes": {
+    "viewport": "1280x800",
+    "theme": "light",
+    "text": "200%",
+    "locale": "ar"
+   },
+   "artifact": "shots/landing/SCR-01-error-1280x800-light-200pct-ar.png",
+   "artifact_state": "SCR-01/error",
+   "capture": {
+    "revision": "<commit the frames were captured at>",
+    "route": "/",
+    "motion": "reduced",
+    "captured_at": "2026-10-07T00:00:00Z",
+    "source": "the capability that took it, e.g. chrome-devtools take_screenshot"
+   },
+   "figma_frame": "https://www.figma.com/design/<fileKey>/<file>?node-id=<frame>",
+   "baseline": null,
+   "diff": {
+    "against": "figma",
+    "status": "NOT_RUN",
+    "reason": "template row — the frame is compared once it is captured"
+   },
+   "rubric": [
+    {
+     "id": "R1",
+     "type": "G",
+     "status": "NOT_ASSESSED"
+    },
+    {
+     "id": "R7",
+     "type": "J",
+     "status": "NOT_ASSESSED",
+     "note": "a judge item stays NOT_ASSESSED until a labelled set calibrates the judge"
+    }
+   ],
+   "status": "NOT_RUN",
+   "reason": "template row — the visual look: one SCR state at one point of the axes matrix"
+  },
+  {
+   "id": "BC-08",
+   "req": "REQ-5",
+   "scenario": "SCN-007",
+   "component": "SCR-01",
+   "state": "SCR-01/loading",
+   "kind": "look",
+   "axes": {
+    "viewport": "1280x800",
+    "theme": "dark",
+    "text": "default",
+    "locale": "ar"
+   },
+   "artifact": "shots/landing/SCR-01-loading-1280x800-dark-default-ar.png",
+   "artifact_state": "SCR-01/loading",
+   "capture": {
+    "revision": "<commit the frames were captured at>",
+    "route": "/",
+    "motion": "reduced",
+    "captured_at": "2026-10-07T00:00:00Z",
+    "source": "the capability that took it, e.g. chrome-devtools take_screenshot"
+   },
+   "figma_frame": null,
+   "baseline": null,
+   "diff": null,
+   "rubric": [
+    {
+     "id": "R1",
+     "type": "G",
+     "status": "NOT_ASSESSED"
+    },
+    {
+     "id": "R7",
+     "type": "J",
+     "status": "NOT_ASSESSED",
+     "note": "a judge item stays NOT_ASSESSED until a labelled set calibrates the judge"
+    }
+   ],
+   "status": "NOT_RUN",
+   "reason": "template row — the visual look: one SCR state at one point of the axes matrix"
+  },
+  {
+   "id": "BC-09",
+   "req": "REQ-5",
+   "scenario": "SCN-007",
+   "component": "SCR-01",
+   "state": "SCR-01/long-content",
+   "kind": "look",
+   "axes": {
+    "viewport": "1280x800",
+    "theme": "dark",
+    "text": "200%",
+    "locale": "en"
+   },
+   "artifact": "shots/landing/SCR-01-long-content-1280x800-dark-200pct-en.png",
+   "artifact_state": "SCR-01/long-content",
+   "capture": {
+    "revision": "<commit the frames were captured at>",
+    "route": "/",
+    "motion": "reduced",
+    "captured_at": "2026-10-07T00:00:00Z",
+    "source": "the capability that took it, e.g. chrome-devtools take_screenshot"
+   },
+   "figma_frame": null,
+   "baseline": null,
+   "diff": null,
+   "rubric": [
+    {
+     "id": "R1",
+     "type": "G",
+     "status": "NOT_ASSESSED"
+    },
+    {
+     "id": "R7",
+     "type": "J",
+     "status": "NOT_ASSESSED",
+     "note": "a judge item stays NOT_ASSESSED until a labelled set calibrates the judge"
+    }
+   ],
+   "status": "NOT_RUN",
+   "reason": "template row — the visual look: one SCR state at one point of the axes matrix"
   }
  ]
 }

package/plugins/task-pipeline/skills/task-pipeline/templates/run.md

@@ -70,6 +70,7 @@ hand:  <N|10> — task "<quoted>" — done <n> — surfaced <n> — decisions <n
 holds: <stage id> — <n> (<class: what, owner>; … or "none") — enumerated <n>/8 classes, <unlooked: classes not enumerable>
 gate:  <stage id> — command "<cmd>" — exit <N> — <ISO-8601>
 event: <compact|session-end|subagent|memory> — <detail> — <ISO-8601>
+review: <stage id> — surface <name> — rounds <N> — <returned|approved|unresolved> — <ISO-8601>
 read:  references/<file>.md            # hook-appended, deduped, UNATTESTED (no writer field)
 ```
 
@@ -109,6 +110,14 @@ read:  references/<file>.md            # hook-appended, deduped, UNATTESTED (no
   it. A later audit reads `grep -c '^hand:'` against `grep -c '^iter:'` and the two
   should agree, plus one for stage 10.
   **`amb` prints its ids or `— no register`, never a bare `0` with nothing beside it.**
+- **`review:`** — one line each time the person reviewing a visual surface's contact sheet
+  answers it: `returned` with triples, `approved`, or `unresolved` items they took over.
+  `rounds` is the sheet's `review_rounds` after that answer — the count of human passes the
+  surface took, written where it happened rather than recalled at the end
+  (`references/browser.md` → *The visual half*). `scripts/stage_checkpoint.py` carries it
+  into the checkpoint of the stage it names, and stage 10 copies the last one per surface
+  into the acceptance file. **It is a measurement, never a target**: a number of passes to
+  beat is an instruction to stop showing the sheet.
 - **`touch:`** — one line per file per pass, and the reason names **what forced the
   edit**: a finding id, a failed gate item, an operator instruction. *"Cleanup"*,
   *"polish"* and *"while I was there"* are not reasons; they are churn with better
@@ -131,6 +140,7 @@ touch: src/export.ts — pass 3 (stage 5) — reason: F-014
 event: compact — auto — 2026-08-10T11:58Z
 event: subagent — general-purpose — 2026-08-10T12:00Z
 gate:  6 — command "npm test" — exit 0 — 2026-08-10T12:02Z
+review: 6 — surface landing — rounds 1 — returned — 2026-08-10T12:02Z
 stage: 6 Tests — gate manual — verdict pass — 2026-08-10T12:03Z
 hand:  3 — task "add CSV export to the orders table" — done 2 — surfaced 1 — decisions 1 — amb 2 (OQ-0007, ledger row 4)
        scope 5f21ac3/node-24-linux/REQ-001,REQ-004 — unverified 1 (XLSX path: no fixture)