pipeline-refino-ui
Skill0 starsChanged 2 months agoMITView on GitHub
Refines the interface of an existing product (web app, site or PWA) with an Apple Human Interface Guidelines digest as the quality benchmark, never as the brand: inventory and baseline evidence, the ruler, a four-lens audit (technical, heuristic, HIG conformance, aesthetic), interface rules that keep the project's identity, implementation on a dedicated branch, the double gate (dev-qa + dsg-critic), a Vercel preview and the 5-block round report. Use for 'Protocolo Refino UI <projeto>', 'refino de UI', 'melhorar usabilidade do <produto>' or 'auditoria HIG' (audit-only runs stop after stage 3). Not for new landing pages, rebrands, copy-only work or new features.
In this repository20 other files it gives its agents.
- CLAUDE.mdCLAUDE.md
- global/CLAUDE.mdCLAUDE.md
- copywriting-frameworksSkill
- design-mdSkill
- format-carouselSkill
- format-hooksSkill
- format-linkedinSkill
- format-reelsSkill
- funnel-designSkill
- humanizationSkill
- launch-playbooksSkill
- offer-designSkill
- pipeline-brandSkill
- pipeline-campaignSkill
- pipeline-contentSkill
- pipeline-copySkill
- pipeline-landing-pageSkill
- pipeline-luxoSkill
- pipeline-sistemaSkill
- scroll-worldSkill
The file
We split this skill into the rules it gives an agent
7 rules. About 0 are common, 2 are distinctive, and 5 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈2
Distinctive · estimate
This author's own choices. Worth a look.
5
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 41
Not a reason to skip: a luxury-tier pack.
- Distinctive: line 48
Run the stage-2 freshness check now (zero cost): a stale digest becomes a plan item, not a mid-run stop.
- Distinctive: line 50
Stop for GO. After GO, run the chain to the barrier and stop only for the irreversible actions in Rules, item 9.
- Very specific: line 121
REJECT branch: only when the aesthetic lens returned REJECT, dsg-director (opus · xhigh) first writes …
- Very specific: line 123
Start from the existing tokens.
- Very specific: line 561
Every stage passes state forward as a file.
- Very specific: line 583
every item of <AS>/brain/knowledge/checklists/ui-refino.md is PASS, N/A with a reason, or (R16 only) deferred with a reason.
≈ “Common” is an estimate: at least 1 in 5 of the 364,980 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Pipeline — Refino de UI
Purpose: make an existing product clearer, more trustworthy, consistent and accessible, measured against Apple's HIG translated to the web, without changing what it does or whose brand it wears.
Runs under a single-round plan (Planning Doctrine, ~/.claude/CLAUDE.md) with a task contract per delegated step (<AS>/docs/task-contract.md). Invoked as /pipeline-refino-ui, usually from a client repo in ~/Projetos vscode/, where brain/ is a different tree, so every path here is anchored to the Agent System root.
Placeholders
| Token | Meaning |
<AS> | Agent System root, absolute: $HOME/Agent System (quote it in shell, the path has a space). <AS>/… means relative to that root; expand it to the absolute path in every contract you hand over. |
<project> | Target project folder, absolute: where the client-round PLANO-* / REPORT-* files live. |
<repo> · <default-branch> | Git top-level of <project> (git -C "<project>" rev-parse --show-toplevel) and its default branch. Client projects usually own a nested repo. |
<pack> | Project pack <AS>/brain/projects/<pack>/, or none. |
<slug> | The pack name; the repo folder name when there is no pack or the pack spans several products. If any output path of this chain already exists from an earlier round, append -<ddmm>: never overwrite an earlier round. |
<ddmm> | The plan date as ddmm (client-round naming): PLANO-REFINO-UI-<ddmm>.md, branch refino-ui-<ddmm>. |
<routes> | In-scope routes from the plan, comma-separated, query strings allowed: "/,/clientes,/negocio?id=x". |
<base-antes> · <base-depois> | Origins captured before and after (Rules, item 6). |
<scratch> | The main session's scratchpad directory (absolute), outside every repo. |
<state-antes> · <state-depois> | Playwright storage states, one per origin: <scratch>/refino-ui-<slug>/state-<label>.json. |
<workspace> | Where stage 5 works: <repo> on branch refino-ui-<ddmm>, or a git worktree of that branch. |
When to use
- An existing product's interface needs refinement (clarity, trust, consistency, accessibility, task completion) across its real screens, states and breakpoints, with behavior unchanged.
- The user says "Protocolo Refino UI
<projeto>", "refino de UI", "melhorar usabilidade do<produto>" or "auditoria HIG". - Audit-only (a diagnosis, or scoping a client proposal): plan, stages 1–3 and the stage-7 report; skip 4–6.
When NOT to use
- A new landing page:
/pipeline-landing-page. - A new or reworked identity (fonts, palette, marks):
/pipeline-brand. This pipeline preserves identity by rule. - Copy-only changes:
/pipeline-copy. - New features, behavior, API or data-model changes:
/pipeline-sistema. - One unambiguous UI fix: edit directly, no pipeline.
- Not a reason to skip: a luxury-tier pack. Compose with
pipeline-luxo: its references join the ruler (stage 2),dsg-typographyruns beforedsg-uiinside the existing families (stage 4), and its calibration lenses join the aesthetic lens (stage 3) and thedsg-criticgate (stage 6).
Plan first (before stage 1)
The main session plans under the director doctrine; nothing below runs before the user's GO.
- Load
<AS>/brain/projects/<pack>/(brand.md,icp.md,voice.md,status.md) and skim<project>: framework, route list,package.jsonscripts, latestPLANO-*/REPORT-*. - Run the stage-2 freshness check now (zero cost): a stale digest becomes a plan item, not a mid-run stop.
- Write the plan in PT-BR from
~/.claude/templates/plano-rodada.mdto<AS>/brain/ops/plans/<YYYY-MM-DD>-refino-ui-<slug>.mdand copy it to<project>/PLANO-REFINO-UI-<ddmm>.md. Block 2 = stages 1–7 with<routes>and the primary flows in scope. Block 3 = barrier: test account for the storage state, identity decisions already visible, production approval. Block 4 =<AS>/brain/knowledge/checklists/ui-refino.md. Block 5 = usage; reference for a product of 8–12 screens: ≈ $130 API-equiv all-Fable, ≈ $60–75 with Fable deciding and Opus 5.5 executing (recommended). Convert withclaude-usage --estimate <usd>. - Stop for GO. After GO, run the chain to the barrier and stop only for the irreversible actions in Rules, item 9.
Chain
| # | Stage | Owner · model · effort | Output (under <AS>/brain/ops/) | Gate |
| 1 | Inventory + baseline | dev-qa · sonnet · high | handoffs/ui-inventory-<slug>.md, reports/shots/<slug>/antes/ | main session: R1–R2 |
| 2 | Ruler | main session, no agent, zero cost | section 9 (Ruler) of the inventory | freshness warning: R3 |
| 3 | Audit | 4 lenses in parallel on sonnet (dev-qa, dsg-ui, dsg-critic ×2), then dsg-critic · opus · xhigh consolidates | handoffs/ui-audit-<slug>-<lens>.md ×4, reports/ui-audit-<slug>.md | main session: R4 |
| 4 | Interface rules | dsg-ui · sonnet · high; dsg-director · opus · xhigh first, only on an aesthetic REJECT | handoffs/ui-rules-<slug>.md (+ handoffs/brief-design-<slug>.md) | main session: R5 |
| 5 | Implementation | dev-builder · opus (Opus 5.5 override) · high; dsg-motion · sonnet · high only for listed motion moments | commits on refino-ui-<ddmm>, handoffs/build-<slug>.md (+ handoffs/motion-<slug>.md) | stage 6 |
| 6 | Double gate + preview | ops-utility · haiku · low (evidence), then dev-qa · sonnet · high and dsg-critic · opus · xhigh in parallel, then dev-ops · sonnet · medium | reports/shots/<slug>/depois/, compare.html, reports/qa-<slug>.md, reports/design-<slug>.md, reports/deploy-<slug>.md | PASS + APPROVE, max 2 loops each: R6–R15 |
| 7 | Report | main session | reports/round-<slug>.md, <project>/REPORT-REFINO-UI-<ddmm>.md | final review: R16–R18 |
The main session (Fable) plans, runs the zero-cost stage 2, arbitrates gates and reviews. It never executes implementation or revision-loop work.
Stage 1 — Inventory + baseline · dev-qa (sonnet · high)
Why dev-qa: it has no Edit tool (structurally read-only on source), it owns the test session, and the inventory doubles as its stage-6 test map.
- Inputs: the pack;
<project>source (read-only); the plan's<routes>and flows; template<AS>/brain/knowledge/templates/ui-inventory.md. - Procedure
- Map from code, not memory: routes, shared components, token sources (Tailwind theme, CSS custom properties, theme files), states implemented per screen and component, conventions,
package.jsonscripts, auth model, latest known suite result. - Primary workflows: 3–7 from the pack (
icp.md,status.md) and repo docs, each with entry route and observable success state. Flows without pack support are markedinferred. <base-antes>: a local production build of<default-branch>when it runs with the env files present; otherwise the live production URL (stage 6 then gates the preview). Issue<state-antes>through the project's E2E auth setup, or a throwaway login script in<scratch>that reads test credentials from env, never hardcoded. Record the exact command so any origin can be issued a session.- Capture from the core (drop
--storage-statewhen no route needs a session):
A dark scheme exists: repeat the screenshot withcd "$HOME/Agent System" && node scripts/screenshot.mjs --url <base-antes> --routes "<routes>" --out brain/ops/reports/shots/<slug> --label antes --storage-state <state-antes> --reduced-motion cd "$HOME/Agent System" && node scripts/a11y-scan.mjs --url <base-antes> --routes "<routes>" --label antes --out brain/ops/reports/shots/<slug> --storage-state <state-antes>--color-scheme dark --label antes-dark. Eachok:falseentry inmanifest.jsonis retried once, then recorded under Risks. - Optional accelerator: when the
impeccableplugin is present and the pack fills Users and Brand Personality, write<project>/.impeccable.md(## Design Context: Users · Brand Personality · Aesthetic Direction = the current identity, preserved · Design Principles = identity preserved, HIG as the quality bar, the audit priority order), only if absent and left untracked. Never runimpeccable teach(it stops to ask the user). Otherwise skip silently. - Fill the template (sections 1–8).
- Map from code, not memory: routes, shared components, token sources (Tailwind theme, CSS custom properties, theme files), states implemented per screen and component, conventions,
- Output:
<AS>/brain/ops/handoffs/ui-inventory-<slug>.md;<AS>/brain/ops/reports/shots/<slug>/antes/(<route-slug>-<bp>.png,manifest.json,a11y-report.md,a11y-summary.json, per-page JSON;antes-dark/when captured);<state-antes>; optionally<project>/.impeccable.md. - Gate: the main session checks R1–R2; gaps go back to
dev-qa(max 2 loops). - Parallelism: none; the capture depends on the screen map.
Stage 2 — Ruler · main session (no agent, zero cost)
- Inputs: the inventory;
<AS>/brain/design-library/principles/INDEX.md; the digest<AS>/brain/design-library/principles/apple-hig-web.mdand its corpus manifest<AS>/brain/design-library/references/apple-hig/manifest.json; the pack'sbrand.md. - Procedure
- Freshness check:
cd "$HOME/Agent System" && node -e 'const m=require("./brain/design-library/references/apple-hig/manifest.json");const t=Date.parse(m.fetchedAt);console.log(Number.isNaN(t)?"UNKNOWN":Date.now()-t>365*864e5?"STALE":"FRESH",m.fetchedAt)'fetchedAtolder than 12 months (STALE) or unreadable (UNKNOWN): warn the user to re-runcd "$HOME/Agent System" && node scripts/hig-fetch.mjs(zero tokens) and re-synthesize the digest (ownerdsg-director, as in<AS>/brain/ops/plans/2026-09-25-pipeline-refino-ui.md, item 2) before trusting it. If the round proceeds on the old digest, HIG-lens findings carry the tagdigest-stale. - Compose the ruler: the digest, applicability matrix included ·
design-principles.mdalways ·typography.md,color-systems.md,motion-language.md,layout-composition.md,web-interfaces.md·anti-patterns.mdbefore any verdict · identity source = the pack'sbrand.md, or, when it is missing or marked not defined, the inventory's existing tokens as the de-facto identity · overlays: thepipeline-luxoreferences when that overlay is active;<AS>/brain/design-library/principles/agent-system-design.mdonly when the target is one of the system's own surfaces. - Fill section 9 (Ruler) of the inventory: the file list, digest
fetchedAtand verdict, the identity source.
- Freshness check:
- Output: section 9 (Ruler) of
<AS>/brain/ops/handoffs/ui-inventory-<slug>.md. - Gate: none beyond the freshness warning (R3).
- Parallelism: none.
Stage 3 — Audit · 4 lenses in parallel (sonnet), then consolidation (dsg-critic · opus)
| Lens | Executor | Ruler it applies | Method | Optional accelerators |
technical | dev-qa · sonnet · high | a11y "antes", web-interfaces.md, anti-patterns.md | axe violations by impact; keyboard walk of each primary flow (order, visible focus, traps; stop before any submit that writes); designed states; touch and focus floors | impeccable:audit, design:accessibility-review |
heuristic | dsg-ui · sonnet · high | Nielsen's ten heuristics, cognitive load, design-principles.md | each primary flow walked on the "antes" shots and the inventory's states | impeccable:critique, design:design-critique |
hig | dsg-critic · sonnet (model override) | apple-hig-web.md checklist, web-applicable items only | per in-scope screen, PASS/FAIL per applicable item; each FAIL becomes a finding | none |
aesthetic | dsg-critic · sonnet (model override) | the role file's eight dimensions against the identity source; a mood report only if the pack has one | "antes" shots at 390/768/1440, density judged for the task, not by landing-page standards; verdict APPROVE / REVISE / REJECT on the current state | none |
- Inputs: the inventory (Ruler included),
<AS>/brain/ops/reports/shots/<slug>/antes/, the lens's ruler files, template<AS>/brain/knowledge/templates/ui-audit.md. - Procedure: each lens writes
<AS>/brain/ops/handoffs/ui-audit-<slug>-<lens>.mdusing the template's Findings table (lens-local idsT-,H-,G-,A-) and a keep list; with nothing to report, it writes "none" plus what was checked. Thendsg-critic(opus, roster effort) consolidates: merges duplicates (keeping every lens id), assigns final idsUI-01…, grades severity, tags one dimension per finding, sorts, sets an owner stage per finding (4rules ·5build ·5-motion·barrier·next-round), moves identity-impact items to Barrier with a recommendation, and excerpts the aesthetic verdict. - Severity: P0 blocks a task or violates WCAG A · P1 hurts task completion or WCAG AA · P2 consistency or polish · P3 nice-to-have. Order: severity first, then the dimension hurt, in this order: clarity · trust · consistency · accessibility · task completion.
- Output: four lens files and
<AS>/brain/ops/reports/ui-audit-<slug>.md. - Gate: the main session checks R4; the consolidator reworks (max 2 loops). Audit-only runs jump to stage 7 here.
- Parallelism: the four lens contracts go out in one message; consolidation starts after all four return.
Stage 4 — Interface rules · dsg-ui (sonnet · high)
- Inputs:
ui-audit-<slug>.md, the inventory (tokens and Ruler), the digest, principles,<AS>/brain/design-library/patterns/, the pack'sbrand.mdandvoice.md(microcopy), template<AS>/brain/knowledge/templates/ui-rules.md. In this pipeline the audit plus the digest replacebrief-design-<slug>.mdasdsg-ui's mandatory input. - REJECT branch: only when the aesthetic lens returned REJECT,
dsg-director(opus · xhigh) first writes<AS>/brain/ops/handoffs/brief-design-<slug>.md: a product-UI direction inside the identity guard (Typography Direction and Motion Language Direction mandatory; shot list and image prompts marked n/a).dsg-uithen reads it too. - Procedure
- Start from the existing tokens; change a value only where a finding requires it, and give every value a Source (
brand.mdsection, inventory token, digest item, principles section, finding id). - Fill every template section: type, spacing, color and surfaces (light and dark when supported, contrast pairs with ratios), radius and elevation, icons, the states matrix for every in-scope component, interaction patterns with exact microcopy strings, motion (durations, one curve, reduced motion, motion moments), responsive rules at 390/768/1440.
- Identity-impact changes (font family, radius register, accent hue, marks) are never rules: list them as pending user decisions with a recommendation.
- Close with the implementation order: tokens, then shared components, then screens by primary-flow priority, each step naming the finding ids it closes.
- Start from the existing tokens; change a value only where a finding requires it, and give every value a Source (
- Output:
<AS>/brain/ops/handoffs/ui-rules-<slug>.md(plusbrief-design-<slug>.mdon the REJECT branch). - Gate: the main session checks R5 (every value traced, no identity-impact change inside the rules); gaps go back to
dsg-ui(max 2 loops). - Parallelism: none; on the REJECT branch the director runs before
dsg-ui.
Stage 5 — Implementation · dev-builder (Opus 5.5 · high)
Routed to model: opus (roster default is sonnet) because it lands in production repos whose test suites must stay green.
- Inputs:
ui-rules-<slug>.md(and the brief, if any),ui-audit-<slug>.md, the inventory (commands, baseline suite result),<AS>/brain/design-library/patterns/. - Workspace: branch
refino-ui-<ddmm>in<repo>. If<repo>holds uncommitted work, use a git worktree of that branch placed outside every repo's tracked tree; never stash, reset or switch someone else's work. Copy the git-ignored files needed to run (env files,.vercel/project.json,.impeccable.md) without committing them. Commit locally in logical steps; no push, no merge. - Procedure: follow the rules' implementation order (tokens, shared components, screens in scope). Every touched view covers loading, empty and error states, keyboard and visible focus, contrast, and 390/768/1440 without horizontal scroll.
impeccable:polish,impeccable:harden,impeccable:adaptandimpeccable:typesetserve only as internal checklists when present. Self-check before handoff: build, typecheck or lint, and the existing suite (or its locally runnable part) against the inventory's baseline. - Motion:
dsg-motion(sonnet · high) runs afterdev-builder, in the same workspace, only whenui-ruleslists motion moments; it touches only those and writes<AS>/brain/ops/handoffs/motion-<slug>.md. - Output: commits on
refino-ui-<ddmm>;<AS>/brain/ops/handoffs/build-<slug>.mdwith workspace path, branch, commits, files changed, finding ids closed, deviations, known gaps and self-check results. - Gate: stage 6.
- Parallelism: sequential. Tokens and shared components precede the screens that consume them, and motion follows the build.
Stage 6 — Double gate + preview
- Inputs:
build-<slug>.md(andmotion-<slug>.md),ui-rules-<slug>.md,ui-audit-<slug>.md, the inventory (flows, commands, session command, baseline suite result),<AS>/brain/ops/reports/shots/<slug>/antes/,<AS>/brain/knowledge/checklists/ui-refino.md. - Procedure, in order:
- Serve: the main session serves
<workspace>once in the background (build and start commands from the inventory, production build preferred, a free port): that is<base-depois>. It re-serves after every fix loop. Agents never start a second server. When the product cannot run locally, thedev-opscontract runs first and<base-depois>is the preview URL (a preview is reversible; production is not). - 6.0 Evidence ·
ops-utility(haiku · low): re-issue<state-depois>with the inventory's session command, capture with the same routes and flags as stage 1 under the labeldepois(plusdepois-darkwhenantes-dark/exists), and build the contact sheetcompare.htmlwithout--embed(Rules, item 6). - 6a Functional gate ·
dev-qa(sonnet · high), in parallel with 6b: build, existing suite, smoke of each primary flow, keyboard path per flow with visible focus, the a11y scan with--label depois(0 critical or serious on<routes>, compared with "antes"), contrast, designed states, no horizontal scroll at 390/768/1440, reduced motion, and the diff against the scope guard. Verdict PASS / PASS-WITH-WARNINGS / BLOCK over R6–R13. - 6b Aesthetic gate ·
dsg-critic(opus · xhigh): "depois" against "antes" (PNG pairs, indexcompare.html), the digest checklist on in-scope screens, the eight dimensions, identity intact. Verdict APPROVE / REVISE / REJECT (R14, R5). - Loops: BLOCK goes to
dev-builder(ordsg-motion). REVISE goes todsg-uifor a rule gap or todev-builderfor an implementation gap, with named asks. REJECT goes todsg-director, thendsg-ui, thendev-builder. Every loop re-runs 6.0 and the failed gate. - 6c Preview ·
dev-ops(sonnet · medium): after PASS (or PASS-WITH-WARNINGS) and APPROVE, one preview deploy of<workspace>using the project's own convention (its.vercel/link,CLAUDE.mdor latestREPORT-*; the core'sVERCEL_TOKENonly for projects on the core's account), URL verified (R15). Production deploy and merge are never part of this chain.
- Serve: the main session serves
- Output:
<AS>/brain/ops/reports/shots/<slug>/depois/(screenshots from 6.0, a11y files from 6a) and<AS>/brain/ops/reports/shots/<slug>/compare.html;<AS>/brain/ops/reports/qa-<slug>.md;<AS>/brain/ops/reports/design-<slug>.md;<AS>/brain/ops/reports/deploy-<slug>.mdwith the preview URL. - Gate:
dev-qaPASS (or PASS-WITH-WARNINGS) anddsg-criticAPPROVE, max 2 loops per gate, then escalate to the user with the blocker stated plainly. A BLOCK stopsdev-ops. - Parallelism: 6.0, then 6a and 6b in one message, then 6c.
Stage 7 — Report · main session
- Inputs: the plan, every handoff and report of this chain,
compare.html, the preview URL, the diff. - Procedure: review pass, with every plan item checked against its evidence and every
ui-refino.mditem PASS, N/A with a reason, or deferred with a reason. Write the round report in PT-BR from~/.claude/templates/report-rodada.md(5 blocks) plus the annex Anexo — Arquivos alterados · Melhorias principais · O que foi verificado · Limitações, linkingcompare.htmland the preview. Block 2 walks each primary flow on the preview at 390/768/1440 with expected results. Block 3 carries the barrier: identity decisions with recommendations, production deploy and merge approval, deferred findings,inferredflows to confirm. Thencpthe report to the project folder and confirm the plan copy is current. - Output:
<AS>/brain/ops/reports/round-<slug>.md,<project>/REPORT-REFINO-UI-<ddmm>.md, and<project>/PLANO-REFINO-UI-<ddmm>.md(written at planning). - Gate: final review against
ui-refino.md(R16–R18). - Parallelism: none.
Contract blocks
Paste into the delegation prompt with every placeholder expanded (<AS> becomes the absolute root). Stages with parallel agents carry one contract per agent (docs/task-contract.md: one responsibility per contract). R* ids refer to <AS>/brain/knowledge/checklists/ui-refino.md.
C1 — stage 1 · dev-qa
## Task Contract — Refino UI · 1 · inventory + baseline · <slug>
**Agent:** dev-qa · sonnet · high (role file `<AS>/.claude/agents/dev-qa.md`)
**Objective:** Map the interface of `<project>` and capture its "antes" baseline, so every later stage works from recorded evidence.
**Project pack:** `<AS>/brain/projects/<pack>/` (none: users and flows come from repo docs, marked `inferred`)
**Depends on:** the approved plan `<AS>/brain/ops/plans/<YYYY-MM-DD>-refino-ui-<slug>.md`
**Inputs:**
- Template `<AS>/brain/knowledge/templates/ui-inventory.md`; the plan's `<routes>` and primary flows.
- Pack `brand.md`, `icp.md`, `status.md`; `<project>` source, `package.json`, configs, repo docs, latest `REPORT-*`.
**Scope (allowed):**
- Read `<project>`; run its install, build and start commands and its E2E auth setup (or a throwaway login script in `<scratch>/refino-ui-<slug>/` that reads test credentials from env, never hardcoded).
- `<base-antes>` = a local production build of `<default-branch>` when it runs with the env files present, else the live production URL. Write `<state-antes>` = `<scratch>/refino-ui-<slug>/state-antes.json`.
- Run: `cd "$HOME/Agent System" && node scripts/screenshot.mjs --url <base-antes> --routes "<routes>" --out brain/ops/reports/shots/<slug> --label antes --storage-state <state-antes> --reduced-motion`, then `cd "$HOME/Agent System" && node scripts/a11y-scan.mjs --url <base-antes> --routes "<routes>" --label antes --out brain/ops/reports/shots/<slug> --storage-state <state-antes>`; add a screenshot run with `--color-scheme dark --label antes-dark` when a dark scheme exists; drop `--storage-state` when no route needs a session.
- Write `<project>/.impeccable.md` (Design Context from the pack) only if the impeccable plugin is present, the file is absent and the pack fills Users and Brand Personality. Never run `impeccable teach`.
**Out of scope (forbidden):**
- Editing source, committing, pushing, deploying; submitting any form that writes data; writing credentials or session contents anywhere; recommendations (they belong to the audit).
**Expected output:**
- `<AS>/brain/ops/handoffs/ui-inventory-<slug>.md`, template sections 1–8 (section 9 belongs to the main session).
- `<AS>/brain/ops/reports/shots/<slug>/antes/`: a PNG per route at 390/768/1440, `manifest.json`, `a11y-report.md`, `a11y-summary.json`, per-page JSON (plus `antes-dark/`).
**Success criteria:**
- R1 and R2 PASS; every `ok:false` capture retried once, then recorded under Risks; the session command recorded verbatim.
**Gate:** main session (R1–R2), max 2 loops.C2 — stage 2 · main session
## Task Contract — Refino UI · 2 · ruler · <slug>
**Agent:** main session (no delegation, zero cost)
**Objective:** Fix the measuring stick every later stage applies and record how fresh it is.
**Project pack:** `<AS>/brain/projects/<pack>/`
**Depends on:** C1
**Inputs:**
- `<AS>/brain/design-library/principles/INDEX.md`, `<AS>/brain/design-library/principles/apple-hig-web.md`, `<AS>/brain/design-library/references/apple-hig/manifest.json`, the pack's `brand.md`, the inventory.
**Scope (allowed):**
- Run the freshness check (stage 2); fill section 9 (Ruler) of the inventory.
**Out of scope (forbidden):**
- Editing the digest or principles; re-synthesizing the digest without a `dsg-director` contract.
**Expected output:**
- Section 9 (Ruler) of `<AS>/brain/ops/handoffs/ui-inventory-<slug>.md`: files, digest `fetchedAt` + FRESH / STALE / UNKNOWN, identity source (`brand.md` or the de-facto tokens).
**Success criteria:**
- R3 PASS; STALE or UNKNOWN reported to the user with the refresh command.
**Gate:** none.C3 — stage 3 · one lens (issue four, one per lens, in one message)
## Task Contract — Refino UI · 3 · <lens> lens · <slug>
**Agent:** <executor from the stage-3 lens table> (role file `<AS>/.claude/agents/<agent>.md`; the `hig` and `aesthetic` lenses run `dsg-critic` with `model: sonnet`)
**Objective:** Audit the in-scope screens through the <lens> lens only, every finding backed by evidence and a reference.
**Project pack:** `<AS>/brain/projects/<pack>/`
**Depends on:** C1, C2
**Inputs:**
- `<AS>/brain/ops/handoffs/ui-inventory-<slug>.md` (Ruler included), `<AS>/brain/ops/reports/shots/<slug>/antes/`.
- The lens's ruler files under `<AS>/brain/design-library/principles/` (lens table); template `<AS>/brain/knowledge/templates/ui-audit.md` (definitions at its top).
**Scope (allowed):**
- Read the inputs and `<project>` source. `dev-qa` and `dsg-critic` may take extra captures of `<base-antes>` (focus, hover, open menus) without submitting writes.
- The lens's optional accelerators, when present and callable: advisory input, re-expressed in the template's format with evidence.
**Out of scope (forbidden):**
- Other lenses' ground; fixes, rules or code; deciding identity questions (tag them `identity-impact`); writing any file but the output.
**Expected output:**
- `<AS>/brain/ops/handoffs/ui-audit-<slug>-<lens>.md`: Method, Findings (ids `T-` / `H-` / `G-` / `A-`), keep list; "none" plus what was checked when there is nothing to report. The aesthetic lens adds its verdict (APPROVE / REVISE / REJECT) on the current state.
**Success criteria:**
- Every finding carries screen or component, severity and dimension per the template's definitions, evidence (shot path or axe rule at a route) and a HIG or principle reference.
**Gate:** C3-consolidation.C3-consolidation — stage 3 · dsg-critic
## Task Contract — Refino UI · 3 · audit consolidation · <slug>
**Agent:** dsg-critic · opus · xhigh (role file `<AS>/.claude/agents/dsg-critic.md`)
**Objective:** Merge the four lens files into one prioritized audit, with identity decisions separated as barrier items.
**Project pack:** `<AS>/brain/projects/<pack>/`
**Depends on:** the four C3 lens contracts
**Inputs:**
- `<AS>/brain/ops/handoffs/ui-audit-<slug>-technical.md`, `<AS>/brain/ops/handoffs/ui-audit-<slug>-heuristic.md`, `<AS>/brain/ops/handoffs/ui-audit-<slug>-hig.md`, `<AS>/brain/ops/handoffs/ui-audit-<slug>-aesthetic.md`; `<AS>/brain/ops/handoffs/ui-inventory-<slug>.md`; template `<AS>/brain/knowledge/templates/ui-audit.md`.
**Scope (allowed):**
- Read the inputs and the evidence; merge, re-grade and order findings.
**Out of scope (forbidden):**
- New findings without evidence; fixes or rules; editing the lens files.
**Expected output:**
- `<AS>/brain/ops/reports/ui-audit-<slug>.md`: every template section; ids `UI-01…` tracing to lens ids; an owner stage per finding (`4` · `5` · `5-motion` · `barrier` · `next-round`).
**Success criteria:**
- R4 PASS; order = severity, then clarity · trust · consistency · accessibility · task completion; no identity-impact item in the fix list.
**Gate:** main session (R4), max 2 loops.C4-direction — stage 4 · dsg-director (aesthetic REJECT only)
## Task Contract — Refino UI · 4 · direction after REJECT · <slug>
**Agent:** dsg-director · opus · xhigh (role file `<AS>/.claude/agents/dsg-director.md`)
**Objective:** Re-direct the product UI where the aesthetic lens rejected the current state, without leaving the project's identity.
**Project pack:** `<AS>/brain/projects/<pack>/`
**Depends on:** C3-consolidation with aesthetic verdict REJECT
**Inputs:**
- `<AS>/brain/ops/reports/ui-audit-<slug>.md`, `<AS>/brain/ops/handoffs/ui-inventory-<slug>.md`, `<AS>/brain/design-library/principles/apple-hig-web.md` and the other principles in that folder, the pack's `brand.md`.
**Scope (allowed):**
- One brief in the role file's format, scoped to product UI.
**Out of scope (forbidden):**
- Identity changes (families, accent hue, radius register, marks): propose them as barrier items. Tokens or component specs (`dsg-ui`). Image prompts and shot lists (mark n/a).
**Expected output:**
- `<AS>/brain/ops/handoffs/brief-design-<slug>.md` with Typography Direction and Motion Language Direction.
**Success criteria:**
- Every direction cites a finding and stays inside the identity guard.
**Gate:** main session review before C4-rules starts.C4-rules — stage 4 · dsg-ui
## Task Contract — Refino UI · 4 · interface rules · <slug>
**Agent:** dsg-ui · sonnet · high (role file `<AS>/.claude/agents/dsg-ui.md`)
**Objective:** Turn the audit into interface rules that close its findings while preserving the product's identity.
**Project pack:** `<AS>/brain/projects/<pack>/` (`brand.md`, `voice.md`)
**Depends on:** C3-consolidation (and C4-direction after a REJECT)
**Inputs:**
- `<AS>/brain/ops/reports/ui-audit-<slug>.md`; `<AS>/brain/ops/handoffs/ui-inventory-<slug>.md` (tokens, Ruler); `<AS>/brain/design-library/principles/apple-hig-web.md` and the other principles in that folder; `<AS>/brain/design-library/patterns/`; template `<AS>/brain/knowledge/templates/ui-rules.md`; `<AS>/brain/ops/handoffs/brief-design-<slug>.md` if it exists.
- Pipeline rule: here the audit plus the digest replace the director brief as your mandatory input.
**Scope (allowed):**
- Write the rules file only.
**Out of scope (forbidden):**
- Application source; identity-impact changes written as rules (list them as pending user decisions with a recommendation); values without a Source.
**Expected output:**
- `<AS>/brain/ops/handoffs/ui-rules-<slug>.md`: every template section, every value with Source and Change, the implementation order naming the finding ids each step closes.
**Success criteria:**
- R5 PASS; every P0/P1 with owner stage `4` or `5` is covered by a rule or an implementation step.
**Gate:** main session (R5), max 2 loops.C5-build — stage 5 · dev-builder
## Task Contract — Refino UI · 5 · implementation · <slug>
**Agent:** dev-builder · opus (Opus 5.5 override) · high (role file `<AS>/.claude/agents/dev-builder.md`)
**Objective:** Implement `ui-rules-<slug>.md` in `<workspace>` so the in-scope findings close with behavior unchanged and the existing suite green.
**Project pack:** `<AS>/brain/projects/<pack>/`
**Depends on:** C4-rules approved
**Inputs:**
- `<AS>/brain/ops/handoffs/ui-rules-<slug>.md`, `<AS>/brain/ops/reports/ui-audit-<slug>.md`, `<AS>/brain/ops/handoffs/ui-inventory-<slug>.md` (commands, baseline suite result), `<AS>/brain/design-library/patterns/`.
**Scope (allowed):**
- Branch `refino-ui-<ddmm>` in `<repo>`, or a git worktree of it when `<repo>` holds uncommitted work. Copy git-ignored run files (env, `.vercel/project.json`, `.impeccable.md`) without committing them.
- Files named in the rules' implementation order: tokens, then shared components, then screens in scope. Loading, empty and error states, keyboard and visible focus, contrast, and 390/768/1440 without horizontal scroll on every touched view.
- Local commits in logical steps; `impeccable:polish` / `harden` / `adapt` / `typeset` as internal checklists when present.
**Out of scope (forbidden):**
- Behavior, feature, API or data-model changes; copy beyond the rules' microcopy table; identity changes; push, merge, deploy; stash, reset or switching work that is not yours.
**Expected output:**
- Commits on `refino-ui-<ddmm>`; `<AS>/brain/ops/handoffs/build-<slug>.md`: workspace path, branch, commits, files changed, finding ids closed, deviations, known gaps, self-check results.
**Success criteria:**
- Build, typecheck or lint and the existing suite pass, or fail exactly as the recorded baseline (listed); every P0/P1 with owner stage `5` closed or reported as a gap with a reason.
**Gate:** stage 6 (dev-qa + dsg-critic).C5-motion — stage 5 · dsg-motion (only when motion moments are listed)
## Task Contract — Refino UI · 5 · motion moments · <slug>
**Agent:** dsg-motion · sonnet · high (role file `<AS>/.claude/agents/dsg-motion.md`)
**Objective:** Implement only the motion moments listed in `ui-rules-<slug>.md`, native-first, each with a reduced-motion fallback.
**Project pack:** `<AS>/brain/projects/<pack>/`
**Depends on:** C5-build (same workspace)
**Inputs:**
- The Motion section of `<AS>/brain/ops/handoffs/ui-rules-<slug>.md`, `<AS>/brain/ops/handoffs/build-<slug>.md`, `<AS>/brain/design-library/principles/motion-language.md`, `<AS>/brain/design-library/patterns/`.
**Scope (allowed):**
- The files those moments touch, in `<workspace>` on `refino-ui-<ddmm>`; local commits.
**Out of scope (forbidden):**
- New moments; a JS dependency where a native primitive covers the case; layout or copy changes; push, merge, deploy.
**Expected output:**
- `<AS>/brain/ops/handoffs/motion-<slug>.md`: files touched, primitive chosen and why, reduced-motion behavior.
**Success criteria:**
- The rules' single curve and durations used; `prefers-reduced-motion` honored.
**Gate:** stage 6.C6-evidence — stage 6.0 · ops-utility
## Task Contract — Refino UI · 6 · "depois" evidence · <slug>
**Agent:** ops-utility · haiku · low (role file `<AS>/.claude/agents/ops-utility.md`)
**Objective:** Capture the "depois" evidence of `<base-depois>` exactly as the baseline was captured, and build the contact sheet.
**Project pack:** none (mechanical chore)
**Depends on:** C5-build (and C5-motion), `<base-depois>` served by the main session
**Inputs:**
- The session command recorded in `<AS>/brain/ops/handoffs/ui-inventory-<slug>.md`, `<routes>`, `<base-depois>`, `<AS>/brain/ops/reports/shots/<slug>/antes/manifest.json`.
**Scope (allowed):**
- Issue `<state-depois>` = `<scratch>/refino-ui-<slug>/state-depois.json` with the recorded session command.
- Run: `cd "$HOME/Agent System" && node scripts/screenshot.mjs --url <base-depois> --routes "<routes>" --out brain/ops/reports/shots/<slug> --label depois --storage-state <state-depois> --reduced-motion` (again with `--color-scheme dark --label depois-dark` when `antes-dark/` exists).
- Run: `cd "$HOME/Agent System" && node scripts/shots-compare.mjs --dir brain/ops/reports/shots/<slug> --before antes --after depois --out brain/ops/reports/shots/<slug>/compare.html` (again with `--before antes-dark --after depois-dark --out brain/ops/reports/shots/<slug>/compare-dark.html` when both exist).
**Out of scope (forbidden):**
- Any other command; `--embed`; judgments; more than one retry per failed capture.
**Expected output:**
- `<AS>/brain/ops/reports/shots/<slug>/depois/` and `compare.html`; a completion note listing any `ok:false` entry.
**Success criteria:**
- Same routes and viewports as `antes/`; every capture ok or listed.
**Gate:** none (feeds C6-qa and C6-design).C6-qa — stage 6a · dev-qa
## Task Contract — Refino UI · 6 · functional gate · <slug>
**Agent:** dev-qa · sonnet · high (role file `<AS>/.claude/agents/dev-qa.md`)
**Objective:** Prove the refined interface works and meets the accessibility floor, or block it with reproducible reasons.
**Project pack:** `<AS>/brain/projects/<pack>/`
**Depends on:** C6-evidence
**Inputs:**
- `<AS>/brain/ops/handoffs/build-<slug>.md` (and `<AS>/brain/ops/handoffs/motion-<slug>.md` when it exists), `<AS>/brain/ops/handoffs/ui-inventory-<slug>.md` (flows, commands, baseline suite result), `<AS>/brain/ops/handoffs/ui-rules-<slug>.md`, `<AS>/brain/ops/reports/shots/<slug>/`, `<base-depois>`, `<state-depois>`, `<AS>/brain/knowledge/checklists/ui-refino.md`.
**Scope (allowed):**
- Build, typecheck or lint and the existing suite in `<workspace>`; Playwright smoke and keyboard walks of each primary flow on `<base-depois>` (full completion only on test data or the project's E2E fixtures, otherwise stop at the final submit).
- Run: `cd "$HOME/Agent System" && node scripts/a11y-scan.mjs --url <base-depois> --routes "<routes>" --label depois --out brain/ops/reports/shots/<slug> --storage-state <state-depois>`.
- Read the diff: `git -C "<repo>" diff <default-branch>...refino-ui-<ddmm>`.
**Out of scope (forbidden):**
- Fixing anything; aesthetic judgment (`dsg-critic`); writes against production data.
**Expected output:**
- `<AS>/brain/ops/reports/qa-<slug>.md`: verdict PASS / PASS-WITH-WARNINGS / BLOCK; R6–R13 each PASS or FAIL with evidence; axe counts "antes" against "depois"; failures with repro steps and an owning agent (`dev-builder`, `dsg-motion` or `dsg-ui`); loop count.
**Success criteria:**
- R6–R13 each judged with evidence; a BLOCK names the owner of every failure.
**Gate:** this is the functional gate. Max 2 loops, then escalate.C6-design — stage 6b · dsg-critic
## Task Contract — Refino UI · 6 · aesthetic gate · <slug>
**Agent:** dsg-critic · opus · xhigh (role file `<AS>/.claude/agents/dsg-critic.md`)
**Objective:** Decide whether the refined interface belongs on the shelf: better than "antes", HIG-conformant where the digest applies to the web, identity intact.
**Project pack:** `<AS>/brain/projects/<pack>/`
**Depends on:** C6-evidence
**Inputs:**
- `<AS>/brain/ops/reports/shots/<slug>/antes/` and `depois/` (index `compare.html`), `<AS>/brain/ops/reports/ui-audit-<slug>.md`, `<AS>/brain/ops/handoffs/ui-rules-<slug>.md`, `<AS>/brain/ops/handoffs/build-<slug>.md`, `<AS>/brain/design-library/principles/apple-hig-web.md` and the other principles in that folder, the pack's `brand.md`.
**Scope (allowed):**
- Read-only; extra captures of `<base-depois>` (states, focus) when a verdict needs them.
**Out of scope (forbidden):**
- Editing code or rules; functional verdicts (`dev-qa`).
**Expected output:**
- `<AS>/brain/ops/reports/design-<slug>.md`: verdict APPROVE / REVISE / REJECT, the eight dimensions, the digest checklist on in-scope screens, the identity check (R5), named asks with an owner (`dsg-ui` for a rule gap, `dev-builder` for an implementation gap, `dsg-director` on REJECT), loop count.
**Success criteria:**
- R14 judged; every ask names a screen and a finding or rule.
**Gate:** this is the aesthetic gate. Max 2 loops, then escalate.C6-preview — stage 6c · dev-ops
## Task Contract — Refino UI · 6 · preview · <slug>
**Agent:** dev-ops · sonnet · medium (role file `<AS>/.claude/agents/dev-ops.md`)
**Objective:** Publish `<workspace>` as a Vercel preview for human review.
**Project pack:** `<AS>/brain/projects/<pack>/`
**Depends on:** `<AS>/brain/ops/reports/qa-<slug>.md` PASS (or PASS-WITH-WARNINGS) and `<AS>/brain/ops/reports/design-<slug>.md` APPROVE; runs before the gates only when the product cannot run locally
**Inputs:**
- Both verdicts; `<AS>/brain/ops/handoffs/ui-inventory-<slug>.md` (Vercel project, env var names); the project's deploy convention (`.vercel/`, `CLAUDE.md`, latest `REPORT-*`).
**Scope (allowed):**
- One preview deploy of `<workspace>` to the project's own Vercel project; URL verification.
**Out of scope (forbidden):**
- `--prod`, promoting, aliasing production domains, merging, pushing to the default branch; the core's `VERCEL_TOKEN` for a project that lives on another account.
**Expected output:**
- `<AS>/brain/ops/reports/deploy-<slug>.md` with the preview URL and how it was verified.
**Success criteria:**
- R15 PASS.
**Gate:** none. Production needs the user's explicit approval.C7 — stage 7 · main session
## Task Contract — Refino UI · 7 · round report · <slug>
**Agent:** main session (review and report, no delegation)
**Objective:** Close the round with the doctrine's report and hand the user the preview, the evidence and the decisions.
**Project pack:** `<AS>/brain/projects/<pack>/`
**Depends on:** stage 6 closed or escalated (audit-only: C3-consolidation)
**Inputs:**
- The plan, every handoff and report of this chain, `compare.html`, the preview URL, the diff.
**Scope (allowed):**
- Write the round report; `cp` it to `<project>`; refresh the plan copy if it drifted.
**Out of scope (forbidden):**
- Production deploy, merge, new work.
**Expected output:**
- `<AS>/brain/ops/reports/round-<slug>.md` in PT-BR from `~/.claude/templates/report-rodada.md` (5 blocks) plus the annex "Anexo — Arquivos alterados · Melhorias principais · O que foi verificado · Limitações"; `<project>/REPORT-REFINO-UI-<ddmm>.md`; `<project>/PLANO-REFINO-UI-<ddmm>.md` current.
**Success criteria:**
- R16–R18 PASS; every plan item marked feito / parcial / não feito with evidence.
**Gate:** final review against `ui-refino.md`.Rules
- Executor resolution. An agent named here that exists in the session's roster is delegated by name, with the
modeloverride where the chain says so. Otherwise spawngeneral-purposewith the role file'smodel(or the stage override) and open the prompt with: "Read<AS>/.claude/agents/<name>.mdfirst: it is your role contract (mission, workflow, output format, boundaries)." Effort cannot be set on a spawn; the role file's effort applies only when delegated by name. Never substitute a legacy look-alike (qa-agent,dev-agent,designer-agent,visual-qa-agent) for a core agent. - Absolute paths. Contracts carry expanded absolute paths only (
<AS>becomes$HOME/Agent System). A barebrain/…path never reaches an executor, because in a client repo it resolves to a different tree. Scripts run from the core (cd "$HOME/Agent System" && node scripts/…), so their relative--outlands in the core. - Freshness. The plan and stage 2 check the digest's
fetchedAt. Older than 12 months or unreadable: warn and refresh (node scripts/hig-fetch.mjs, then re-synthesis bydsg-director) before trusting it. Proceeding anyway tags HIG findingsdigest-stale. - Identity guard. Apple is the quality benchmark, not the brand. Every token value in
ui-rulestraces to the pack'sbrand.md, or, when that is not defined, to the inventory's existing tokens; non-identity values (scale steps, contrast floors, durations) may trace to the digest or principles. Font-family swaps, radius-register changes, accent-hue changes, marks and the product's voice are never decided by agents: they become barrier items with a recommendation. No Apple imitation: SF Pro and SF Symbols are licensed for Apple platforms only, so never self-host them or load them with@font-faceon the web (asystem-uistack is fine); no pattern the digest's applicability matrix marks as not web. - Scope guard (stage 5 and every loop). No behavior change, no new feature, no API or data-model change, no copy beyond the UX microcopy a finding requires (PT-BR with correct diacritics, the pack's voice). Dedicated branch or worktree only; the default branch, production and the merge stay human decisions. Order: tokens, shared components, screens in scope; always loading, empty and error states, keyboard and focus, contrast, responsive at 390/768/1440.
- Evidence and privacy. "antes" and "depois" come from comparable origins: local builds of
<default-branch>and of<workspace>(preferred), or production and the preview. Differences caused by data or environment are listed as limitations. Storage states are origin-bound: issue one per origin with the inventory's command, keep them outside every repo, never print their contents. Evidence can carry customer data (screenshots, axe node HTML): capture with a test account over test data whenever the product allows it, never submit writes against production, and keep the contact sheet inside the report and the preview. PNGs underreports/shots/are git-ignored in the core whilecompare.htmlis tracked, so the tracked sheet is built without--embed; an embedded copy, when needed, goes to<scratch>. - Optional accelerators, never dependencies.
impeccable:audit,impeccable:critique,impeccable:polish,impeccable:harden,impeccable:adapt,impeccable:typeset,design:accessibility-reviewanddesign:design-critiqueare used only when present in the session and only by executors whose toolset includes the Skill tool (ageneral-purposespawn has it; a roster agent with a restricted toolset applies its own ruler). Their output is advisory: re-expressed in this pipeline's templates with evidence, and bound by the identity and scope guards (their push toward a bold new direction does not apply here). The chain completes with none of them installed. - Gates and loops. Max 2 revision loops per gate; a fix that breaks another item still counts. On the third failure, escalate to the user with the blocker stated plainly. The main session arbitrates and reviews; it never does a loop's work itself.
- Preview before approval. Visual work is presented on a Vercel preview URL, never only locally. Production deploy and the merge into the default branch require the user's explicit approval, requested in the round report.
Handoffs
Every stage passes state forward as a file; a fresh session resumes the chain from the latest one instead of replaying the conversation. Paths are under <AS>/brain/ops/ unless marked <project>.
| Artifact | Path | Written by | Read by |
| Plan (+ copy) | plans/<YYYY-MM-DD>-refino-ui-<slug>.md, <project>/PLANO-REFINO-UI-<ddmm>.md | main session | all |
| Inventory + Ruler | handoffs/ui-inventory-<slug>.md | dev-qa; main session (Ruler) | every stage |
| Baseline evidence | reports/shots/<slug>/antes/ | dev-qa | lenses, dsg-critic, ops-utility |
| Lens files | handoffs/ui-audit-<slug>-{technical,heuristic,hig,aesthetic}.md | lens executors | consolidator |
| Audit | reports/ui-audit-<slug>.md | dsg-critic (opus) | dsg-director, dsg-ui, dev-builder, gates, main session |
| Direction brief (REJECT only) | handoffs/brief-design-<slug>.md | dsg-director | dsg-ui, dsg-critic |
| Interface rules | handoffs/ui-rules-<slug>.md | dsg-ui | dev-builder, dsg-motion, dev-qa, dsg-critic |
| Build / motion | handoffs/build-<slug>.md, handoffs/motion-<slug>.md | dev-builder, dsg-motion | gates, main session |
| After evidence | reports/shots/<slug>/depois/, compare.html | ops-utility; dev-qa (a11y) | gates, report |
| Verdicts | reports/qa-<slug>.md, reports/design-<slug>.md | dev-qa, dsg-critic | dev-ops, main session |
| Preview | reports/deploy-<slug>.md | dev-ops | main session |
| Round report (+ copy) | reports/round-<slug>.md, <project>/REPORT-REFINO-UI-<ddmm>.md | main session | user |
Done when
reports/qa-<slug>.mdis PASS (or PASS-WITH-WARNINGS, each warning carried into the report) andreports/design-<slug>.mdis APPROVE, each within 2 loops or with the escalation recorded;reports/deploy-<slug>.mdshows a verified preview URL;reports/round-<slug>.mdand<project>/REPORT-REFINO-UI-<ddmm>.mdexist with the annex, the test script and the barrier requests;- every item of
<AS>/brain/knowledge/checklists/ui-refino.mdis PASS, N/A with a reason, or (R16 only) deferred with a reason.
Audit-only runs are done when R1–R4 pass and the round report delivers the prioritized fix list and the barrier. Paths above are under <AS>/brain/ops/.
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.

