project-baseline
Un standard de vérification reproductible : 69 règles, chacune appuyée par une vérification qu'un exécuteur Node sans dépendance exécute sur un dépôt au repos. Les blocages font échouer l'intégration continue (sortie 1) ; les décisions qu'un script ne peut pas prendre sont résolues via un registre de validation daté. L'objectif principal : ne faites pas confiance à une promesse écrite — faites en sorte que quelque chose la vérifie.
La boîte à outils se trouve à côté de ce fichier : check.mjs (exécuteur), rules.json (les 69 règles), config.example.json, templates/, README.md (guide de démarrage), REFERENCE.md (référence complète : tableau des règles, catégories, schémas d'architecture, câblage CI) et GLOSSARY.md (définitions en langage clair des termes DevOps/chaîne d'approvisionnement).
Résolvez d'abord le répertoire de la compétence. $SKILL_DIR ci-dessous signifie le chemin absolu du répertoire qui contient ce SKILL.md — résolvez-le en un chemin concret avant d'exécuter une commande (ne passez pas la chaîne littérale $SKILL_DIR au shell). Il s'agit généralement de ~/.claude/skills/baseline. check.mjs charge rules.json depuis son propre répertoire, donc les deux doivent rester colocalisés ; invoquez toujours l'exécuteur par son chemin absolu (node "<abs>/check.mjs" …) plutôt que de le copier ailleurs. L'exécuteur a seulement besoin de Node ≥ 18 et git ; si node est manquant, dites-le à l'utilisateur plutôt que de deviner.
Quand elle est invoquée
Déterminez l'intention à partir des mots de l'utilisateur et choisissez un mode. Par défaut, utilisez score si non spécifié.
Mode : score (par défaut) — « exécuter baseline », « /baseline », « vérifier ce dépôt »
- Choisissez le dépôt cible : un chemin explicite dans la demande, sinon le répertoire de travail actuel. Confirmez qu'il ressemble à un dépôt (a un manifeste ou
.git). - Exécutez l'exécuteur (lisible par l'humain) :
node "$SKILL_DIR/check.mjs" --repo <cible>- Ajoutez
--no-execsi vous ne devez PAS exécuter la commande d'amorçage/test du dépôt (BUILD-05) — par exemple dépôt non fiable, pas le temps d'exécuter les tests, ou la commande n'est pas configurée. Privilégiez son exécution lorsque c'est sûr, car BUILD-05 est la vérification reine. - Ajoutez
--profile advancedsi l'utilisateur souhaite les règles expertes (SBOM, analyse de code, tests de mutation, intégrité des symboles, analyse des vulnérabilités des dépendances, seuil de couverture). Le profilservices'active automatiquement pourproject_type=service. - Ajoutez
--jsonlorsque vous souhaitez analyser les résultats par programme plutôt que d'afficher le tableau de bord.
- Ajoutez
- Présentez le résultat à l'utilisateur, en commençant par les blocages (ceux-ci font échouer l'IC), puis les avertissements méritant d'être corrigés. Regroupez par catégorie. Ne déversez pas les 69 lignes — résumez : % de préparation, nombre de blocages, et les ÉCHECs/avertissements notables spécifiques avec leur détail d'une ligne. Proposez de corriger ou d'échafauder.
Mode : init — « configurer baseline ici », « adopter le standard », « échafauder baseline »
- Copiez la boîte à outils dans le dépôt (suggérez
tools/baseline/), ou référencez-la sur place. - Échafaudez les artefacts, seulement s'ils sont manquants (ne jamais écraser sans demander) :
cp "$SKILL_DIR/config.example.json" <dépôt>/baseline.config.json cp "$SKILL_DIR/templates/CLAIMS.json" <dépôt>/docs/CLAIMS.json # seulement si le dépôt fait des revendications externes cp "$SKILL_DIR/templates/start-here.md" <dépôt>/docs/start-here.md # si aucun document d'état n'existe mkdir -p <dépôt>/.project-baseline && cp "$SKILL_DIR/templates/signoff.json" <dépôt>/.project-baseline/signoff.json - Modifiez
baseline.config.jsonen fonction de la réalité du dépôt : définissezproject_type,bootstrap_command(la commande d'installation+test sur checkout propre pour BUILD-05), etmakes_external_claims(false ignore les règles CLAIM-*). Les clés opt-in*_globs(fraîcheur/généré/fondation) restent vides jusqu'à ce que le dépôt adopte ces conventions. - Montrez-lui le câblage CI depuis
README.mdet faites du jobbaselineune vérification obligatoire (c'est la règle BUILD-06). - Exécutez un premier score.
Mode : fix — « corriger les échecs de baseline », « passer au vert »
- Notez d'abord. Pour chaque blocage/avertissement que l'utilisateur souhaite traiter, appliquez le champ
fixde la règle (lisez-le dansrules.json) sous forme de modifications concrètes au dépôt — ajoutez la licence manquante, épinglez l'action à un SHA, ajoutez le.envà.gitignoreet faites pivoter le secret, ajoutez le test négatif, etc. - Pour les règles
manual(validation), ne simulez pas une vérification — aidez l'utilisateur à faire le jugement (rayon d'explosion, passe d'art antérieur, coin/fossé) et enregistrez une entrée datée dans.project-baseline/signoff.json. - Re-notez pour confirmer.
Mode : explain — « que vérifie SEC-03 », « pourquoi CTX-05 a échoué »
Lisez la règle dans rules.json (chacune a title, rationale, fix, source et la check) et expliquez-la clairement, ainsi que ce que l'exécuteur a réellement cherché. Pour un jargon peu familier (SBOM, SLSA, provenance, registre de validation, …), GLOSSARY.md dans ce répertoire contient des définitions en langage clair.
Comment l'exécuteur décide (afin que vous puissiez interpréter les lignes de détail)
- RÉUSSI / ÉCHEC / AVERTISSEMENT / VALIDATION / IGNORÉ par règle. Seuls les ÉCHECs
blockerdéfinissent le code de sortie 1. - IGNORÉ signifie que la règle ne s'appliquait pas : mauvais
project_type(n/a pour <type>), un profil désactivé (profil 'advanced' désactivé), une fonctionnalité opt-in non adoptée, ou rien à vérifier. Un ignoré ne compte jamais contre la préparation. - Profils :
cores'exécute toujours ;services'exécute automatiquement lorsqueproject_type=service;advanceds'exécute uniquement avec--profile advancedouprofiles:["advanced"]dans la configuration. - Les revendications sont opt-in : CLAIM-* ne s'exécutent que si un registre de revendications existe ou si
makes_external_claims:trueest défini explicitement. Un dépôt sans registre de revendications n'est pas pénalisé. - La configuration se détecte automatiquement de manière sensée ;
baseline.config.jsonà la racine du dépôt remplace les valeurs. Les clés sont documentées dansconfig.example.json. - L'exécuteur est sans dépendance (Node ≥ 18 + git) et résistant aux crashs : une règle dont la vérification ne peut pas être évaluée passe en IGNORÉ, sans jamais faire échouer l'exécution.
Notes
- Ne présentez jamais un avertissement comme un blocage ou vice-versa — la sévérité est dans
rules.jsonet la sortie de l'exécuteur. - Privilégiez l'exécution réelle de BUILD-05 (omettez
--no-exec) lorsque le dépôt est fiable et que la commande d'amorçage est définie — une vérification reine verte est le signal le plus fort. - La justification complète, le tableau des règles, les descriptions des catégories, les schémas d'architecture et l'extrait CI se trouvent dans
REFERENCE.mdde ce répertoire — lisez-le si l'utilisateur souhaite plus de profondeur.