AGENTS.md@packages/anti-slop · git:20261010.4f72471 · 2026-10-10 · sha256 d5abba9e0de696ba

AGENTS.md@packages/anti-slop git:20261010.4f72471A

Immutable. This exact content never changes and is served at /api/v1/blob/d5abba9e0de696ba.

# DOX — packages/anti-slop

Files in this directory. One row per source file.

| File | Purpose |
|------|---------|
| `.pi/skills/anti-slop-brandkit/SKILL.md` | Opt-in paid brand board. `new-site` + no brand + explicit request only. `ask_user` confirm (image count, backend, paid); headless → generate nothing. One 3×3 board per confirmed count (`brand/board-<nn>.png`) via `pi-nano-banana` + `brand/brand.md` (palette hex, type pairing, logo concept rationale). Proposal-only: never writes tokens/contracts before approval; logos = concepts. Text-only fallback. See change: anti-slop-taste-v2. |
| `.pi/skills/anti-slop-frontend/SKILL.md` | NL-triggered skill: mechanical countable anti-slop checklist. Design Read line + surface profile table (`product-ui`/`marketing`/`new-site`) gates Part A / Part B / B7 layout discipline. Dials VARIANCE/MOTION/DENSITY. Part A universal (A1-A8 incl. A8 z-index/DOM cost). Part B marketing-only (B1-B7). Theme parity T1 (diff-scoped added colour literals) / T2 (token guard) / T3 (screenshot set per profile). Grep-able pre-flight, each item cites rule id. Advisory only. `description:` digest-pinned. Adapted taste-skill@18dfc92. See change: anti-slop-taste-v2. |
| `.pi/skills/anti-slop-image-direction/SKILL.md` | Opt-in paid reference images, `marketing`/`new-site` only; forbidden for `product-ui`. Plan one image per section → `ask_user` confirm (count, backend, paid) → `$NB` (`npx --no-install tsx` in monorepo, pinned `npx --yes tsx@4.23.12` when installed) into `<mockupDir>/refs/` → `refs/direction.md` (layout, rhythm, palette hex, type, observed tells excluded). Direction not source; image text never transcribed. Backend switch = reconfirm. Headless/no-credential → text-only brief from variation axes. See change: anti-slop-taste-v2. |
| `.pi/skills/anti-slop-redesign/SKILL.md` | Redesign protocol. Mode `greenfield`/`preserve`/`overhaul` declared before edit (defaults: product-ui/marketing → preserve, new-site → greenfield); overhaul needs confirm. Audit before edit. Levers: type → colour → spacing → states → motion → layout. Never-change-silently: routes, nav labels, form field names, wordmark, legal copy, keyboard shortcuts, `data-testid`. See change: anti-slop-taste-v2. |
| `README.md` | Package overview. Four skills, surface-profile table, theme parity, image prerequisite (`pi-dashboard-nano-banana` + `GEMINI_API_KEY` or `--backend pi`; bin needs a pinned `tsx`, images experimental), relationship to frontend-mockup-loop, attribution at `18dfc92`. |
| `UPSTREAM.md` | Upstream provenance pin: `Leonxlnx/taste-skill` commit `18dfc928…`, date, MIT. Section map: every section of taste-skill, redesign-skill, image-to-code-skill, imagegen-frontend-web, brandkit → package skill or `dropped: <reason>`. Refresh procedure. Contract-tested by `scripts/__tests__/anti-slop-suite-contract.test.mjs`. See change: anti-slop-taste-v2. |