Design Briefs

Un design brief est un ensemble de fichiers de référence HTML et CSS que vous téléversez pour que l'outil de génération de thèmes (Claude via MCP, ou tout assistant à qui vous remettez le brief) voie exactement le rendu que vous voulez. Les briefs sont en lecture seule : ils ne touchent pas votre site tant qu'un thème généré ne les utilise pas.

Le workflow

Téléversez le brief (depuis le panneau Generate Theme de l'écran Themes ou depuis le panneau d'upload Themes partagé).
Créez une ébauche de thème : nommez le theme, attachez le brief (et optionnellement une courte phrase « design intent »), et Chinaski produit à la fois les fichiers starter clonés et un prompt prêt à copier.
Remettez le prompt à votre assistant : le prompt nomme l'ID du brief et indique au lecteur exactement quels appels d'outil récupèrent chaque fichier du brief, afin que Claude (ou un autre client MCP) puisse lire votre design de référence avant d'écrire les fichiers du theme.
Itérez : re-téléversez ou supprimez des briefs à tout moment ; les briefs n'ont aucun effet sur le site vivant.

Téléverser un brief

Depuis le panneau Generate de l'écran Themes, ou depuis l'écran dédié Design Briefs, vous téléversez :

un unique fichier .html ou .css, ou
une archive .zip de tels fichiers (conservée à plat ; les fichiers dans des sous-répertoires sont écartés)

Règles que l'upload applique :

Taille : 3 Mo par upload au maximum (la vérification côté navigateur évite les surprises d'emblée).
Types de fichiers : .html, .css et .zip uniquement. Dans un zip, seuls les fichiers .html/.css sont conservés ; les autres formats et extensions inconnues sont ignorés.
Nombre : au plus 20 fichiers par zip.
Au moins un HTML : un brief doit contenir au moins un fichier .html ; les uploads sans sont rejetés avec une erreur.
Motif de nom de fichier : lettres minuscules, chiffres, underscore, tiret, point, avec une extension .html ou .css. Les entrées de répertoire dans un zip sont jetées (aplaties) si bien qu'aucun contenu de path-traversal n'est extrait.

Étiquetez d'abord votre brief (par exemple « Kitchen Sink ») de sorte que la liste et le menu déroulant Generate soient faciles à utiliser. Les briefs sans étiquette s'affichent comme « (untitled) ».

Où vivent les briefs

Chaque brief reçoit un UUID et son propre répertoire : uploads/design-briefs/<uuid>/.
Les écrans listent les briefs avec Label, Files count, Uploaded (UTC), et un bouton Delete sur chaque ligne (avec une confirmation de suppression irréversible).
La page Design Briefs et le sélecteur de fichiers de Themes appliquent tous deux la même limite de 3 Mo avant l'upload.

Depuis où les briefs sont lus

Les fichiers de référence sont relus par trois canaux :

Les outils MCP pour Claude et tout autre client MCP : list_design_briefs (id, label, horodatage uploaded-at, nombre de fichiers), list_design_brief_files et read_design_brief_file (consommant le HTML/CSS brut du brief comme texte simple).
L'API REST (clés API à permission de lecture) : /api/themes/design-briefs pour la liste, la liste de fichiers du brief, et le contenu brut d'un fichier.
Le prompt du panneau Generate : le prompt de création de thème dit à votre IA d'appeler l'outil d'aide listé avec l'ID du brief pour lire tous les fichiers de référence avant d'écrire le code des templates.

Suppression

Supprimer un brief retire à la fois la ligne de métadonnées et ses fichiers, après une confirmation explicite (« Delete this design brief and its files? This cannot be undone. »).

Ce que les briefs ne peuvent pas faire

Les briefs sont du pur matériau de référence : Chinaski n'appelle jamais lui-même une IA. Le panneau Generate renvoie un prompt prêt à copier à exécuter dans votre propre assistant ; ce prompt pointe vers les fichiers du brief via leurs IDs, et votre assistant les récupère via les outils MCP ou l'API en lecture seule.