Brouillon à relire par Paul
Ce texte est un brouillon. Paul Périgault le relira et le réécrira avant publication.
À propos de l'auteur
Paul Périgault travaille en DevOps et DevSecOps. Il a conçu et écrit ce design system, qui sert de base au site paulperigault.fr.
Le code source est sur GitHub. Cette page ne donne ni formation, ni employeur, ni date : seuls les faits du dépôt sont écrits.
Liens
Ce que le design system montre de sa façon de travailler
Chaque point ci-dessous renvoie à un fichier du dépôt qui l'établit.
- Les règles sont écrites une fois, dans
AGENTS.md, puis vérifiées par la CI : fichier de 120 lignes au plus, fonction de 40 lignes au plus, aucune couleur brute. - Les choix sont datés. Le journal
docs/decisions-log.mdnote pour chaque décision l'alternative écartée et le retour arrière. Les décisions plus larges sont dansdocs/adr/. - Les limites sont dites. La décision D-021 note qu'un plancher d'INP en CI reste inexpliqué : elle le classe en « convention, pas preuve ».
- La sécurité fait partie du produit.
AGENTS.mdinterdit l'attributstyleen ligne pour tenir une CSP stricte, et la décision D-024 choisit des feuilles de style en fichiers plutôt queunsafe-inline. - La livraison est encadrée. Le
README.mddu dépôt indique que les publications passent par le workflowrelease(trusted publishing OIDC, provenance), jamais depuis un poste. - Le travail délégué est borné. Selon
AGENTS.md, une tâche liste les seuls fichiers qu'un agent peut écrire, et tout autre fichier modifié la fait échouer.
Contact
contact : [à compléter par Paul]