Agf Design Discipline

Disciplina di design UI anti-slop AI: Design Read, tre dial, blacklist AI-tells, pre-flight

di pcliangx · pcliangx/AppGenesisForge

Promosso ★ 9.2/10

Agf Design Discipline — Disciplina di design UI anti-slop AI: Design Read, tre dial, blacklist AI-tells, pre-flight

Cosa fa

Uno strato di giudizio di design per produrre UI di prodotto shadcn/ui + Tailwind: richiede una dichiarazione "Design Read" di una riga, imposta i dial VARIANCE/MOTION/DENSITY, e applica una blacklist di "AI tells" (gradienti indaco/viola, Inter, nero/bianco puro, tre carte uguali, icone emoji, nomi finti, stati happy-path-only) con override per regola e un pre-flight meccanicamente verificabile. Si attiva quando si scrive una specifica di design o un prototipo HTML statico, si costruisce UI da un design, o si giudica se un'interfaccia appare generata dall'AI. Presuppone un progetto in stile AGF con un file token DESIGN.md e stack shadcn/Tailwind.

Rapporto di test

Individuato SKILL.md in .claude/skills/agf-design-discipline/; il frontmatter viene analizzato con nome+descrizione. Controllati 3 file referenziati tramite fetch raw — agf-design-precheck.sh, docs/adr/013-design-discipline-layer.md, docs/design/DESIGN.md — tutti HTTP 200; nessun odore di sicurezza (script bash consultivo, exit 0, nessuna rete/esfiltrazione). Creati due sezioni utente HTML e eseguito il precheck della skill: il baseline (il mio default riflessivo) ha segnalato 5 categorie (min-h-screen, font-family Inter, da-indaco/a-viola + gradiente bg-purple, grid-cols-3 carte uguali, icone emoji); la versione conforme alla skill ha segnalato 0 e inoltre riportato una riga Design Read, dial VARIANCE/MOTION/DENSITY=4/2/high, colori referenziati da token, una lista densa divide-y invece di 3 carte uguali, icone lucide, e stati completi di caricamento/vuoto/errore invece di solo happy-path.

Testato il: 2026-07-21 · Claude Code 2.x (agent harness)

Installazione

git clone --depth 1 https://github.com/pcliangx/AppGenesisForge.git /tmp/agf-design-discipline-src
mkdir -p ~/.claude/skills
cp -R /tmp/agf-design-discipline-src/.claude/skills/agf-design-discipline ~/.claude/skills/agf-design-discipline
# Optional mechanical pre-check script (SKILL.md §5 references it):
#   cp /tmp/agf-design-discipline-src/.claude/scripts/agf-design-precheck.sh ~/.claude/scripts/
#   usage: bash agf-design-precheck.sh <design-dir-or-file>   (advisory, exit 0)
# NOTE: SKILL.md links to project-internal files (docs/design/DESIGN.md token SSOT,
#   docs/adr/000 + 013, .claude/agents/uiux-designer.md) that only exist inside AGF.
#   The skill works standalone as design guidance but those cross-references will 404
#   outside the repo. No external CLI/API/MCP needed to apply the discipline itself.

Comandi e prompt di esempio

  • /agf-design-disciplineDisciplina di design UI anti-slop AI: Design Read, tre dial, blacklist AI-tells, pre-flight

Gli skill si attivano con richieste in linguaggio naturale, senza comandi da ricordare. Dopo l'installazione, prompt come questi lo attivano (in inglese):

  • Review this design spec against the AI Tells blacklist
  • Apply the aesthetic dials to this static prototype
  • Run the pre-flight check before building this UI