kankwa/AGENTS.md
Gautier Stefanini 3bab4553b2 feat(design): livrer les lots G8 VIS-00 à VIS-04
Refonte visuelle du produit jusqu'au pilote fonctionnel. Aucune route, API,
permission, étape métier ni limite Premium n'est modifiée.

VIS-00 — anomalies transverses : header et bandeau cookies contenus à 320/390 px,
Kal sorti du terracotta Hub, couleurs brutes remplacées par les tokens.

VIS-01 — tokens arrêtés dans tailwind.config.ts et index.css (sept rôles
typographiques, neutres par rôle, espacements, conteneurs, rayons, élévations,
durées), verrouillés par designTokens.test.ts et démontrés par /style-tile
(noindex, hors sitemap et pré-rendu). Bricolage Grotesque auto-hébergée.

VIS-02 — primitives partagées : btn-quiet/btn-icon, card-notice/interactive/
summary/configuration, badges sémantiques, Field et Badge ; Modal, EmptyState,
MetaChip, ConfirmModal, ProgressBar et ResourceCard migrés aux tokens.

VIS-03 — shells : shellVariant.ts devient la source unique du contexte public /
workspace, une racine de service dépendant aussi de la session. Rail de
collaboration, saisie de code et pages éditoriales factorisés. Anneau de focus
posé une seule fois, btn-primary au cran 700 pour tenir AA.

VIS-04 — Hub pilote : ModuleGroup et ServiceToolTile portent l'assemblage et le
choix d'outil, le démarrage d'un Hub vide devient de l'aide contextuelle, une
seule action dominante par colonne, le type d'événement passe en métadonnée
(emojis retirés des catalogues, EVENT_TYPE_ICONS supprimé) et les formulaires Hub
prennent des libellés persistants. Le champ de partage reçoit un nom accessible.

Validations : check:i18n vert, TypeScript 0 erreur, 119 Vitest (28 fichiers),
Playwright 27 passed, build Docker complet (60 pages SSG, check:marketing et
check:prerender conformes). Chunk initial 148 163 -> 148 690 o gzip pour tout G8.

Le checkpoint « Pilote » reste ouvert : VIS-05 à VIS-07 attendent la revue Hub
desktop et mobile du propriétaire.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-12 17:10:22 +00:00

2.8 KiB

Kankwa — instructions partagées Codex / Claude Code

Ce fichier est le point d'entrée de Codex. Claude Code utilise CLAUDE.md. Les deux agents doivent appliquer les mêmes sources de vérité :

  1. lire CLAUDE.md pour le contexte technique et les invariants du projet ;
  2. consulter par défaut /home/miaw/.claude/projects/-home-miaw-kankwa/memory/MEMORY.md, puis uniquement les mémoires thématiques utiles au chantier ;
  3. lire docs/ROADMAP.md avant de commencer un chantier lié à l'audit ;
  4. consulter docs/audits/2026-08-code-produit.md pour le diagnostic et les preuves ;
  5. pour tout chantier visuel, lire docs/audits/2026-08-style-visuel-produit.md puis appliquer docs/DESIGN_SYSTEM.md ;
  6. suivre docs/AI_COLLABORATION.md pour les passations et mises à jour de statut.

Règle de suivi

  • Le code et les migrations font foi sur le comportement réel.
  • La mémoire .claude apporte le contexte historique ; en cas de divergence, le code et les documents versionnés les plus récents prévalent.
  • docs/ROADMAP.md est la source unique pour l'avancement de l'audit.
  • Le jalon G8 suit toute refonte visuelle ; G4/G6 restent une référence à préserver, pas un périmètre à réécrire.
  • Depuis VIS-01, les tokens de design sont arrêtés dans frontend/tailwind.config.ts et frontend/src/index.css, verrouillés par frontend/src/shared/config/designTokens.test.ts et démontrés par la route interne /style-tile. Absorber un besoin répété dans un token existant ; en ajouter un suppose de modifier docs/DESIGN_SYSTEM.md et ce test dans la même modification.
  • Depuis VIS-03, frontend/src/shared/config/shellVariant.ts est la source unique du contexte de shell (public / workspace) : Navbar, bandeau de confidentialité et Footer en dérivent leur conteneur. Une racine de service dépend en plus de la session, ServiceRoute y rendant la vitrine ou le tableau de bord.
  • Depuis VIS-04, l'assemblage d'un Hub passe par ModuleGroup (groupe de modules d'un même service) et ServiceToolTile (choix d'un outil) ; une colonne d'assemblage ne porte qu'une action principale et le démarrage d'un Hub vide est de l'aide contextuelle, jamais un aplat de service. Les lots de migration suivants réutilisent ces composants au lieu de recomposer un groupe.
  • Ne jamais marquer un item DONE sans satisfaire ses critères d'acceptation et inscrire une preuve vérifiable dans la roadmap (tests, commit, PR ou fichiers).
  • Mettre à jour la documentation dans la même modification que le code concerné.
  • Ne jamais copier de secret ou le contenu de .env dans la documentation, les prompts, les logs ou les commits.

Priorité actuelle

Tant que le jalon G0 — sécurité critique de docs/ROADMAP.md n'est pas validé, les correctifs P0 priment sur la refonte marketing, le SEO et les nouvelles fonctionnalités.