Agence en Solo
Pourquoi cela existe
Quand on demande un site web, un modèle produit le site le plus probable. Bannir ce look ne fait que le déplacer vers le suivant (crème + sérif + argile, noir + vert acide, sourcils en MAJUSCULES, flèches → sur les liens : les tells de la deuxième vague). Et « créatif » n’est pas la solution non plus : un site professionnel doit ressembler à ce qu’une agence exceptionnelle aurait créé, crédible et soigné, où tout s’accorde.
Ordre de priorité : 1) beau et adapté au client, 2) clair et crédible, 3) distinctif (qui ne fait pas AI). Éviter les tells AI est nécessaire mais pas suffisant : une page distinctive mais banale ou hors marque a échoué.
Cette compétence part donc de la marque que le client possède déjà, retire les choix les plus risqués au constructeur, et impose un standard de finition et de beauté de classe mondiale :
- La marque et ses assets d’abord, puis la stratégie : couleurs du logo, photos réelles, références, positionnement, preuves, idée de marque.
- Aléatoire réel, couleur verrouillée sur la marque : un script tire les leviers (composition, dispositif de marque, stratégie de palette, stratégie typographique). La couleur provient du logo du client quand il existe, sinon d’une bibliothèque de palettes organisée et vérifiée pour le contraste, jamais du goût du modèle.
- Un critique indépendant note cinq directions sur leur typicalité et leur force ; un script choisit parmi les fortes et atypiques.
- Un standard de fabrication (
craft.md) et une pièce maîtresse héroïque construite d’abord isolément. - Des vérifications indiscutables : lint à chaque édition, rendu mesuré, diff plan-vs-rendu, mémoire inter-projets, vérifications esthétiques du rendu, et un relecteur aveugle qui note d’abord la désirabilité et l’adéquation à la marque, puis la fabrication et la distinction.
En cas de conflit entre règles, cet ordre prévaut : le brief et les assets de marque du client > la beauté (craft.md Priorité, §2b) > la palette et les cartes tirées > la liste des tells. Une carte ou une règle d’évitement de tell ne justifie jamais un résultat plus laid ou hors marque.
$S = le dossier de cette compétence : le répertoire de base que Claude Code affiche au chargement (${CLAUDE_PLUGIN_ROOT}/skills/agency-of-one en tant que plugin ; .claude/skills/agency-of-one ou ~/.claude/skills/agency-of-one en copie directe). Exécutez les scripts depuis la racine du dépôt : node $S/scripts/<nom>.mjs. Le hook de session imprime le chemin absolu des scripts ; transmettez ce chemin absolu à chaque sous-agent (ils ne peuvent pas résoudre $S eux-mêmes). N’ouvrez jamais references/decks.json. Les cartes proviennent uniquement du script.
Mode
- Agence (par défaut) : professionnel, tourné vers l’entreprise, soigné. Lisez
references/agency.md. - Expressif (
--mode expressive) : uniquement lorsque le brief demande quelque chose d’expérimental, artistique, éditorial, de campagne ou d’événementiel. Il utilise des médias de référence non-web et des contraintes ; lisezreferences/process-notes.md.
Porte
DESIGN.mdexiste → suivez-le exactement ; passez à la Phase 3. Proposez des amendements ; ne dérivez jamais silencieusement. S’il ne contient pas de marqueur<!-- agency-of-one design v1.1 -->, il est antérieur à la couleur basée sur la marque : exécutezbrand-extract.mjs; si la palette entre en conflit avec les assets de marque (plan-diff signale le conflit), proposez un amendement des couleurs §4 à l’utilisateur avant de construire dessus.- Le brief impose une direction ou un guide de marque → le brief l’emporte, même s’il nomme un tell connu. Enregistrez-le (et ses exceptions dans §9) ; passez à la Phase 3.
- Sinon → Phases 1–2, même pour des pages « petites ».
Configuration unique par dépôt : npm i -D playwright && npx playwright install chromium (en tant que devDependency, pour que les npm i ultérieurs ne le suppriment pas).
Phase 1 : Assets, marque, stratégie (DESIGN.md §1)
- Assets réels : demandez d’abord (agency.md Étape 0). Logo, photos des personnes, faits biographiques, noms de clients ou une étude de cas, coordonnées et mentions légales, chiffres réels, captures d’écran du produit. Dans les relectures aveugles, la crédibilité et l’imagerie plafonnent à environ 6/10 sans eux, même avec un bon design. Les manquants deviennent des emplacements professionnels (agency.md Étape 5), et votre rapport commence par ce qu’il faut fournir.
- La marque que vous possédez déjà (agency.md Étape 0a). S’il y a un logo, un blason, un site existant ou des photos de personnes, exécutez
node $S/scripts/brand-extract.mjs(auto-détection, ou passez des chemins). Il écrit.design-review/brand.json; à partir de là,draw.mjsest verrouillé sur la marque automatiquement et plan-diff rejette toute palette qui perd la couleur du logo. Attendu : confirmez la couleur de marque extraite avec l’utilisateur en une ligne. Ne combattez jamais les propres couleurs de la marque. - Références (attendues) : demandez 2–3 sites que le client trouve beaux (tout secteur). Sauvegardez les captures d’écran dans
design-references/. Le relecteur les compare à ces références. Elles fixent le niveau de qualité, pas l’apparence. - Goût humain (attendu uniquement) : demandez une fois : « 2–3 marques ou objets que vous admirez, et un site concurrent que vous ne voulez pas ressembler. »
- Stratégie (mode Agence, agency.md Étape 1) : phrase de positionnement, la croyance unique, 5 codes de catégorie marqués garder/casser (casser ≥ 2), idée de marque, personnalité avec « mais pas », inventaire des preuves (n’inventez jamais de preuve).
- Inventaire des sujets : 8+ artefacts réels, lieux, matériaux et langue vernaculaire du monde du client (12+ en mode Expressif). En mode Agence, ils alimentent la direction de l’imagerie, le dispositif de marque et la rédaction, pas le costume.
- Rédigez la phrase héroïque et le libellé de l’action principale dans la voix de la marque. Vous pouvez les affiner après le tirage.
Phase 2 : Tirage → base → divergence → critique → choix → engagement
2a. Tirage. node $S/scripts/draw.mjs --project "<nom>" (mode Agence par défaut) distribue une référence qualité, un système de composition, un dispositif de marque, une stratégie de palette et une stratégie typographique. La couleur est verrouillée sur la marque automatiquement lorsque .design-review/brand.json existe (remplacez uniquement avec --no-brand "<raison>", par exemple un rebranding demandé par le client) ; sinon elle provient d’une bibliothèque de palettes organisée et vérifiée pour le contraste : des points de départ beaux, jamais des teintes aléatoires brutes. Collez-la dans DESIGN.md §2. Un veto avec une raison écrite : --redraw <emplacement>. Si une carte impose quelque chose de la liste des tells (par exemple une grille visible), c’est autorisé comme exception imposée par la carte : enregistrez-la dans §9 comme carte : <raison> et exécutez-la comme structure, pas comme décoration.
2b. Bases. Écrivez deux jumeaux : le jumeau AI (ce qu’un modèle ferait pour ce brief : polices, hexadécimaux, héroïque, sections) et, en mode Agence, le jumeau cliché d’agence (la version qui attire les récompenses). Vérifiez les deux par rapport à references/tells.md.
2c. Divergez. Écrivez 5 directions (A–E) dans .design-review/directions.md, avec un court résumé du brief et l’inventaire §1. Chaque direction reçoit une expression de l’idée de marque, comment chaque levier tiré est appliqué, la composition héroïque (un petit schéma ASCII), des classes de visages (pas encore de visages spécifiques), une esquisse de palette et le dispositif de marque. Ne les notez pas vous-même. Au moins 3 doivent différer dans l’architecture de la page, pas seulement dans la peau.
2d. Critique indépendant. Lancez le sous-agent direction-critic (agency-of-one:direction-critic en tant que plugin) et donnez-lui uniquement le chemin. Il renvoie la typicalité t et la force s pour chaque direction, plus un PICK_ARG.
2e. Choix. node $S/scripts/draw.mjs --pick "<PICK_ARG>". En mode Agence, il prend les directions les plus fortes (s ≥ 8, à 0,5 près de la meilleure), en excluant uniquement les clairement génériques (t ≥ 0,7). En mode Expressif, il favorise les atypiques. Le code de sortie 3 signifie qu’aucune n’est qualifiée : écrivez 3 nouvelles directions (greffez la STRONGEST_IDEA_TO_STEAL du critique) et relancez le critique. Construisez ce que le script choisit. Attendu : montrez le choix et le deuxième en une ligne chacun et laissez l’utilisateur outrepasser.
2e′. Compositions héroïques (la porte de la beauté). Avant de vous engager, construisez l’héroïque (pli + premier défilement, desktop et mobile) pour le choix et le deuxième en deux compositions statiques rapides avec des assets réels. Capturez les deux (screenshot.mjs --file comp-a.html comp-b.html), puis donnez à un nouveau design-reviewer uniquement les deux images du pli et du pli mobile, non étiquetées, et demandez un choix forcé : laquelle le client serait-il le plus fier d’envoyer, et pourquoi ? Construisez la gagnante. Si le relecteur juge les deux banales ou hors marque, refaites le tirage plutôt que de polir.
2f. Différence. Remplissez le tableau DESIGN.md §3 contre les deux jumeaux. Tout axe correspondant doit changer sauf si le brief l’exige. Test d’échange : le nom d’un concurrent conviendrait-il ? Si oui, puisez davantage dans §1.
2g. Jetons d’engagement. Complétez templates/DESIGN.md → DESIGN.md, y compris le bloc lisible par machine tokens que plan-diff lit.
- Typographie :
references/typography.md. Rendez votre sélection avecnode $S/scripts/type-specimen.mjset choisissez en regardant. Utilisez une seule échelle de rapports ; marquez les tailles d’affichage fluides commefluid. - Couleur : partez de la proposition brand.json (ou de la palette organisée) : marque textuelle, brandForText pour le texte sur fond clair, teintes foncées / claires, neutres teintés et encre (craft.md §4). Testez AA. Gardez la couleur du logo reconnaissable.
- Vérification des répétitions :
node $S/scripts/designlog.mjs check --project "<nom>" [--brand-locked] --display … --body … --ground … --accent … --layout … --medium "<composition ou support principal>". S’il signale REPEAT, changez les axes répétés.
Phase 3 : Construire selon le standard de fabrication
3a. Pièce maîtresse héroïque d’abord, isolément. Construisez uniquement l’héroïque (mode Agence : la composition tirée exécutée parfaitement ; mode Expressif : le mécanisme signature). Capturez-la (screenshot.mjs, avec --state pour les états interactifs) et itérez jusqu’à ce qu’elle obtienne ≥ 8 sur chaque axe de fabrication pertinent dans references/craft.md. Construisez le reste ensuite seulement.
3b. Construisez la page uniquement à partir des jetons (variables CSS / Tailwind v4 @theme), en suivant l’architecture agency.md Étape 3 ou le squelette Expressif. shadcn/Radix fournissent uniquement le comportement ; restylez chaque primitive. La rédaction est spécifique, en casse de phrase et dans la voix de la marque ; les preuves sont réelles ou placées dans des emplacements. Le hook de lint signale les tells à chaque édition, corrigez-les au fur et à mesure.
3c. Passage de finition. Parcourez references/craft.md §1–10 ligne par ligne : détails typographiques, audit de grille, rythme, couleur et contraste, imagerie et emplacements, mouvement et états, composition responsive à 1440/1024/768/390, rédaction modifiée (−30 %), finition technique. Ce passage est là où le « fait par une agence » apparaît. Ne le sautez pas.
Phase 4 : Vérifier (maximum 3 cycles, gardez le meilleur)
- Instantané d’abord : engagez (ou copiez) l’état actuel avant chaque cycle pour pouvoir revenir en arrière en cas de régression.
node $S/scripts/slop-lint.mjs: zéro erreur ; chaque avertissement corrigé ou justifié dans §9 +slop-lint.config.json.node $S/scripts/screenshot.mjs --url <url de dev> --routes / /about …(ou--file index.html about.html …pour du statique ; chaque page, pas seulement l’accueil)--state <nom>=click:<sélecteur>|hash:<#id>|scroll:<sélecteur>|hover:<sélecteur>pour chaque état signature. Regardez le pli, le pli mobile, scroll50 et les captures d’état.node $S/scripts/plan-diff.mjs: la couleur du logo est dans la palette, les polices prévues sont chargées, la palette est rendue, l’échelle appliquée, pas de fonds hors plan, et les vérifications esthétiques à desktop et 390px : aucun contenu invisible à cause d’animations ou masqué sans JS, pas d’avatars avec initiales, groupes de photos cohérents (recadrage, taille, arrière-plan), pas de texte multiligne centré, pas d’étiquettes en capitales, pas de barres de séparation, un en-tête de page conçu sur chaque page.- Relecture aveugle : le sous-agent
design-reviewer(agency-of-one:design-reviewer) reçoit uniquement l’URL ou le fichier, les routes et.design-review/. Il note d’abord la désirabilité et l’adéquation à la marque, puis la fabrication et la distinction, par rapport àdesign-references/si présent. SHIP exige désirabilité, adéquation à la marque et chaque axe de fabrication ≥ 8. Le verdict d’un site multi-pages est celui de sa page la plus faible. - Corrigez et re-rendez. Ne conservez une révision que si le relecteur lui donne un score supérieur au meilleur précédent. Arrêtez après 3 cycles et rapportez ce qui reste ouvert.
- Miroir : retirez une décoration qui ne sert pas l’idée de marque ; notez-la dans DESIGN.md §11.
- Journalisation :
node $S/scripts/designlog.mjs add --project "…" …mêmes drapeaux que check… --media "<résumé du tirage>" --signature "<dispositif / pièce maîtresse>"(--log <chemin>pour conserver le journal dans le dépôt). - Rapport : direction (une ligne), idée de marque, pièce maîtresse, résultats de lint/plan-diff/relecture avec scores de fabrication, exceptions ouvertes, chaque emplacement et hypothèse que le client doit remplir ou confirmer.
Fichiers de référence
| Fichier | Quand |
|---|---|
references/agency.md | Mode Agence : stratégie, système d’identité, architecture métier, emplacements, crédibilité |
references/craft.md | 3a, 3c, Phase 4 : standard de finition, alignement, système photo, en-têtes de page, notation |
references/patterns.md | 3b : recettes éprouvées pour les grilles de personnes, en-têtes de page, bandes de preuve, événements, dons, formulaires |
references/palettes.json | Bibliothèque de palettes organisée (lue par draw.mjs ; vous pouvez la parcourir) |
references/tells.md | 2b, 2f, Phase 4 : tells AI (génér. 1–3) avec signatures et sources |
references/typography.md | 2g : procédure de polices, sources, licences, échelles |
references/process-notes.md | Mode Expressif : interprétation des cartes ; exemples concrets |
templates/DESIGN.md | 2g |