agentleFS
moronireismoronireis/agent-system-partners/.claude/skills/pipeline-refino-ui/SKILL.md

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.

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
  1. Very specific:

    Not a reason to skip: a luxury-tier pack.

    line 41
  2. Distinctive:

    Run the stage-2 freshness check now (zero cost): a stale digest becomes a plan item, not a mid-run stop.

    line 48
  3. Distinctive:

    Stop for GO. After GO, run the chain to the barrier and stop only for the irreversible actions in Rules, item 9.

    line 50
  4. Very specific:

    REJECT branch: only when the aesthetic lens returned REJECT, dsg-director (opus · xhigh) first writes …

    line 121
  5. Very specific:

    Start from the existing tokens.

    line 123
  6. Very specific:

    Every stage passes state forward as a file.

    line 561
  7. Very specific:

    every item of <AS>/brain/knowledge/checklists/ui-refino.md is PASS, N/A with a reason, or (R16 only) deferred with a reason.

    line 583

≈ “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.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

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

TokenMeaning
<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-typography runs before dsg-ui inside the existing families (stage 4), and its calibration lenses join the aesthetic lens (stage 3) and the dsg-critic gate (stage 6).

Plan first (before stage 1)

The main session plans under the director doctrine; nothing below runs before the user's GO.

  1. Load <AS>/brain/projects/<pack>/ (brand.md, icp.md, voice.md, status.md) and skim <project>: framework, route list, package.json scripts, latest PLANO-* / REPORT-*.
  2. Run the stage-2 freshness check now (zero cost): a stale digest becomes a plan item, not a mid-run stop.
  3. Write the plan in PT-BR from ~/.claude/templates/plano-rodada.md to <AS>/brain/ops/plans/<YYYY-MM-DD>-refino-ui-<slug>.md and 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 with claude-usage --estimate <usd>.
  4. Stop for GO. After GO, run the chain to the barrier and stop only for the irreversible actions in Rules, item 9.

Chain

#StageOwner · model · effortOutput (under <AS>/brain/ops/)Gate
1Inventory + baselinedev-qa · sonnet · highhandoffs/ui-inventory-<slug>.md, reports/shots/<slug>/antes/main session: R1–R2
2Rulermain session, no agent, zero costsection 9 (Ruler) of the inventoryfreshness warning: R3
3Audit4 lenses in parallel on sonnet (dev-qa, dsg-ui, dsg-critic ×2), then dsg-critic · opus · xhigh consolidateshandoffs/ui-audit-<slug>-<lens>.md ×4, reports/ui-audit-<slug>.mdmain session: R4
4Interface rulesdsg-ui · sonnet · high; dsg-director · opus · xhigh first, only on an aesthetic REJECThandoffs/ui-rules-<slug>.md (+ handoffs/brief-design-<slug>.md)main session: R5
5Implementationdev-builder · opus (Opus 5.5 override) · high; dsg-motion · sonnet · high only for listed motion momentscommits on refino-ui-<ddmm>, handoffs/build-<slug>.md (+ handoffs/motion-<slug>.md)stage 6
6Double gate + previewops-utility · haiku · low (evidence), then dev-qa · sonnet · high and dsg-critic · opus · xhigh in parallel, then dev-ops · sonnet · mediumreports/shots/<slug>/depois/, compare.html, reports/qa-<slug>.md, reports/design-<slug>.md, reports/deploy-<slug>.mdPASS + APPROVE, max 2 loops each: R6–R15
7Reportmain sessionreports/round-<slug>.md, <project>/REPORT-REFINO-UI-<ddmm>.mdfinal 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
    1. 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.json scripts, auth model, latest known suite result.
    2. 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 marked inferred.
    3. <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.
    4. Capture from the core (drop --storage-state when no route needs a session):
      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
      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>
      A dark scheme exists: repeat the screenshot with --color-scheme dark --label antes-dark. Each ok:false entry in manifest.json is retried once, then recorded under Risks.
    5. Optional accelerator: when the impeccable plugin 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 run impeccable teach (it stops to ask the user). Otherwise skip silently.
    6. Fill the template (sections 1–8).
  • 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.md and its corpus manifest <AS>/brain/design-library/references/apple-hig/manifest.json; the pack's brand.md.
  • Procedure
    1. 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)'
      fetchedAt older than 12 months (STALE) or unreadable (UNKNOWN): warn the user to re-run cd "$HOME/Agent System" && node scripts/hig-fetch.mjs (zero tokens) and re-synthesize the digest (owner dsg-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 tag digest-stale.
    2. Compose the ruler: the digest, applicability matrix included · design-principles.md always · typography.md, color-systems.md, motion-language.md, layout-composition.md, web-interfaces.md · anti-patterns.md before any verdict · identity source = the pack's brand.md, or, when it is missing or marked not defined, the inventory's existing tokens as the de-facto identity · overlays: the pipeline-luxo references when that overlay is active; <AS>/brain/design-library/principles/agent-system-design.md only when the target is one of the system's own surfaces.
    3. Fill section 9 (Ruler) of the inventory: the file list, digest fetchedAt and verdict, the identity source.
  • 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)

LensExecutorRuler it appliesMethodOptional accelerators
technicaldev-qa · sonnet · higha11y "antes", web-interfaces.md, anti-patterns.mdaxe violations by impact; keyboard walk of each primary flow (order, visible focus, traps; stop before any submit that writes); designed states; touch and focus floorsimpeccable:audit, design:accessibility-review
heuristicdsg-ui · sonnet · highNielsen's ten heuristics, cognitive load, design-principles.mdeach primary flow walked on the "antes" shots and the inventory's statesimpeccable:critique, design:design-critique
higdsg-critic · sonnet (model override)apple-hig-web.md checklist, web-applicable items onlyper in-scope screen, PASS/FAIL per applicable item; each FAIL becomes a findingnone
aestheticdsg-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 statenone
  • 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>.md using the template's Findings table (lens-local ids T-, H-, G-, A-) and a keep list; with nothing to report, it writes "none" plus what was checked. Then dsg-critic (opus, roster effort) consolidates: merges duplicates (keeping every lens id), assigns final ids UI-01…, grades severity, tags one dimension per finding, sorts, sets an owner stage per finding (4 rules · 5 build · 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's brand.md and voice.md (microcopy), template <AS>/brain/knowledge/templates/ui-rules.md. In this pipeline the audit plus the digest replace brief-design-<slug>.md as dsg-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-ui then reads it too.
  • Procedure
    1. Start from the existing tokens; change a value only where a finding requires it, and give every value a Source (brand.md section, inventory token, digest item, principles section, finding id).
    2. 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.
    3. Identity-impact changes (font family, radius register, accent hue, marks) are never rules: list them as pending user decisions with a recommendation.
    4. Close with the implementation order: tokens, then shared components, then screens by primary-flow priority, each step naming the finding ids it closes.
  • Output: <AS>/brain/ops/handoffs/ui-rules-<slug>.md (plus brief-design-<slug>.md on 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:adapt and impeccable:typeset serve 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 after dev-builder, in the same workspace, only when ui-rules lists 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>.md with 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 (and motion-<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, the dev-ops contract 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 label depois (plus depois-dark when antes-dark/ exists), and build the contact sheet compare.html without --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, index compare.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 (or dsg-motion). REVISE goes to dsg-ui for a rule gap or to dev-builder for an implementation gap, with named asks. REJECT goes to dsg-director, then dsg-ui, then dev-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.md or latest REPORT-*; the core's VERCEL_TOKEN only for projects on the core's account), URL verified (R15). Production deploy and merge are never part of this chain.
  • 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>.md with the preview URL.
  • Gate: dev-qa PASS (or PASS-WITH-WARNINGS) and dsg-critic APPROVE, max 2 loops per gate, then escalate to the user with the blocker stated plainly. A BLOCK stops dev-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.md item 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, linking compare.html and 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, inferred flows to confirm. Then cp the 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

  1. Executor resolution. An agent named here that exists in the session's roster is delegated by name, with the model override where the chain says so. Otherwise spawn general-purpose with the role file's model (or the stage override) and open the prompt with: "Read <AS>/.claude/agents/<name>.md first: 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.
  2. Absolute paths. Contracts carry expanded absolute paths only (<AS> becomes $HOME/Agent System). A bare brain/… 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 --out lands in the core.
  3. 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 by dsg-director) before trusting it. Proceeding anyway tags HIG findings digest-stale.
  4. Identity guard. Apple is the quality benchmark, not the brand. Every token value in ui-rules traces to the pack's brand.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-face on the web (a system-ui stack is fine); no pattern the digest's applicability matrix marks as not web.
  5. 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.
  6. 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 under reports/shots/ are git-ignored in the core while compare.html is tracked, so the tracked sheet is built without --embed; an embedded copy, when needed, goes to <scratch>.
  7. Optional accelerators, never dependencies. impeccable:audit, impeccable:critique, impeccable:polish, impeccable:harden, impeccable:adapt, impeccable:typeset, design:accessibility-review and design:design-critique are used only when present in the session and only by executors whose toolset includes the Skill tool (a general-purpose spawn 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.
  8. 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.
  9. 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>.

ArtifactPathWritten byRead by
Plan (+ copy)plans/<YYYY-MM-DD>-refino-ui-<slug>.md, <project>/PLANO-REFINO-UI-<ddmm>.mdmain sessionall
Inventory + Rulerhandoffs/ui-inventory-<slug>.mddev-qa; main session (Ruler)every stage
Baseline evidencereports/shots/<slug>/antes/dev-qalenses, dsg-critic, ops-utility
Lens fileshandoffs/ui-audit-<slug>-{technical,heuristic,hig,aesthetic}.mdlens executorsconsolidator
Auditreports/ui-audit-<slug>.mddsg-critic (opus)dsg-director, dsg-ui, dev-builder, gates, main session
Direction brief (REJECT only)handoffs/brief-design-<slug>.mddsg-directordsg-ui, dsg-critic
Interface ruleshandoffs/ui-rules-<slug>.mddsg-uidev-builder, dsg-motion, dev-qa, dsg-critic
Build / motionhandoffs/build-<slug>.md, handoffs/motion-<slug>.mddev-builder, dsg-motiongates, main session
After evidencereports/shots/<slug>/depois/, compare.htmlops-utility; dev-qa (a11y)gates, report
Verdictsreports/qa-<slug>.md, reports/design-<slug>.mddev-qa, dsg-criticdev-ops, main session
Previewreports/deploy-<slug>.mddev-opsmain session
Round report (+ copy)reports/round-<slug>.md, <project>/REPORT-REFINO-UI-<ddmm>.mdmain sessionuser

Done when

  • reports/qa-<slug>.md is PASS (or PASS-WITH-WARNINGS, each warning carried into the report) and reports/design-<slug>.md is APPROVE, each within 2 loops or with the escalation recorded;
  • reports/deploy-<slug>.md shows a verified preview URL;
  • reports/round-<slug>.md and <project>/REPORT-REFINO-UI-<ddmm>.md exist with the annex, the test script and the barrier requests;
  • every item of <AS>/brain/knowledge/checklists/ui-refino.md is 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/.

Download now (ZIP)

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
What did you use it for? e.g. Reviewing pull requests in a Rails app

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.