Que fait Blindspot Audit ?
Objectif
Trouver l'écart entre la carte mentale du projet que possède l'utilisateur et le territoire réel du projet. Transformer les inconnues inconnues en inconnues connues concrètes que l'utilisateur peut inspecter, répondre, tester ou reporter intentionnellement.
Le contexte d'un projet est auto-sélectionné : le propriétaire ne peut écrire que ce qu'il sait déjà, donc chaque README, TODO et plan encode la carte qu'il a dans sa tête - et une IA qui travaille à partir de ces fichiers hérite des mêmes angles morts. Cet audit importe délibérément des cadres de référence de l'EXTÉRIEUR du projet pour mesurer cet écart.
Cette compétence n'est pas une liste de contrôle générique. Elle doit identifier ce qui est inhabituellement important pour ce projet spécifique, à ce stade spécifique, avec des preuves issues du dépôt ou des artefacts fournis. L'audit réussit lorsque le propriétaire dit « Je ne savais même pas que je devais penser à ça » au moins une fois - ET se sent plus calme après, car il sait maintenant aussi ce qu'il peut ignorer en toute sécurité.
Modèle Central
Classer les constats avec le cadre des quatre inconnues :
- Connues connues : ce que le prompt, la documentation, le code ou les plans énoncent déjà.
- Inconnues connues : questions ouvertes déjà visibles dans la documentation, les TODOs, les plans, les commentaires ou le libellé de l'utilisateur.
- Connues inconnues : choses que l'utilisateur reconnaîtrait si on les lui montrait, mais qu'il n'a pas encore verbalisées ou écrites.
- Inconnues inconnues : concepts manquants, contraintes cachées ou questions non posées que la forme du projet sous-entend.
Le cadre est important car la prescription diffère : une inconnue connue a besoin d'une ligne de liste de contrôle, pas d'un cours magistral ; une inconnue inconnue a besoin d'une courte explication et de la première étape la moins coûteuse. Un bon résultat ne prétend pas à la certitude. Il expose des candidats et donne la prochaine vérification la moins coûteuse.
Règles de Base
Elles existent car le mode d'échec de cette compétence n'est pas « manquer un angle mort » - c'est devenir une liste de contrôle générique agaçante qu'on ignore.
- Les documents de suivi du projet sont un filtre, pas une source de constats. Tout ce qui est déjà dans le README / TODO / feuille de route / liste de contrôle / liste de tickets est une INCONNUE CONNUE. Ne le signalez jamais comme une découverte. (Données de terrain : ce filtre réduit généralement la liste des candidats de plus de la moitié et c'est la principale raison pour laquelle les propriétaires font confiance au rapport.)
- Limitez les principaux constats à 3-7, classés par impact x probabilité que le propriétaire soit vraiment inconscient. Le surplus va dans une courte « Liste de surveillance à faible signal » ou dans le registre - jamais dans la liste principale.
- L'absence seule n'est pas un constat. « Vous n'avez pas de X » ne compte que si vous pouvez énoncer la conséquence concrète pour CE projet et la première étape la moins coûteuse pour y remédier.
- Incluez toujours les deux sections de confiance : « Vérifié et bien couvert » et « À ignorer pour l'instant » (chaque ignorer avec un déclencheur de revérification explicite). Elles évitent l'anxiété et les re-analyses, et elles sont ainsi comment le propriétaire apprend que le rapport peut être fiable.
- Nuancez les domaines réglementés. Pour les constats juridiques, fiscaux ou réglementaires, énoncez ce que vous avez trouvé et sa source, puis dites clairement qu'un professionnel doit le confirmer. Vous êtes un éclaireur, pas un avocat ou un comptable.
Modes
rapide: lire la documentation et l'inventaire du projet, retourner les principaux angles morts.approfondi: inspecter les chemins de code représentatifs, les tests, les configurations et la documentation avant de classer les constats.entretien: poser une question à la fois lorsque la réponse changerait l'architecture, le flux de travail, le périmètre ou le risque.post-implémentation: comparer un changement terminé, des notes, des diffs et des tests pour trouver les inconnues restantes.planification: avant l'implémentation, remonter les décisions susceptibles de modifier les modèles de données, les interfaces, les flux UX, les opérations ou la vérification.
Déduisez le mode du libellé de l'utilisateur. Si l'utilisateur demande à l'exécuter maintenant, ne posez pas de questions sur le mode à moins que la limite de l'audit soit impossible à déduire.
Démarrage Rapide
- Identifier la racine du projet et la limite d'audit.
- Exécuter l'outil d'inventaire lorsqu'un projet avec système de fichiers est disponible. Le script se trouve dans le dossier de cette compétence - le résoudre par rapport à ce SKILL.md :
python <dossier-de-cette-compétence>/scripts/project_inventory.py <racine-du-projet> --format md
Utiliser --include-generated uniquement lorsque les sorties d'exécution, les rapports générés, les journaux ou les artefacts mis en cache font partie de la question d'audit.
- Lire uniquement les références pertinentes :
references/archetypes.md: choisir le type de projet et les angles morts attendus.references/lenses.md: dériver et appliquer les lentilles d'audit.references/host-surfaces.md: adapter les questions et les sorties à Claude Code, Codex, OpenCode, CLI ou aux surfaces de chat uniquement.references/ledger-lifecycle.md: découvrir, créer, router ou mettre à jour un registre d'angles morts durable.references/report-template.md: formater le résultat.
- Découvrir ou initialiser le registre d'angles morts :
- Si un registre antérieur existe, le lire avant de chercher (les règles de diff-run s'appliquent - voir Registre Et Runs Diff).
- Si aucun registre n'existe et que l'hôte peut écrire des fichiers, créer
BLINDSPOT_LEDGER.mddans le meilleur emplacement de documentation local du projet, sauf si l'utilisateur a demandé une sortie en lecture seule / chat uniquement. - Si aucun registre n'existe et que l'hôte ne peut pas écrire de fichiers, inclure le chemin proposé et la première entrée du registre dans le rapport.
- Inspecter les fichiers de preuve les plus forts de l'inventaire : README/AGENTS, plans, configurations de paquets, points d'entrée de l'application, configurations de test, CI, exemples d'environnement, schémas, prompts, fichiers d'agent/compétence et documentation d'exécution.
- Exécuter l'analyse externe à œil neuf (voir Flux de travail étape 5) lorsque l'hôte a un accès web.
- Classer les constats, interviewer le propriétaire si possible, produire le rapport et mettre à jour le registre.
Politique de Surface Hôte
Le cœur de l'audit doit fonctionner de la même manière sur Claude Code, Codex, OpenCode, CLI et chat simple. Seul le style d'interaction change. Voir references/host-surfaces.md pour les détails par hôte.
- Hôtes capables de choix (Claude Code
AskUserQuestion, OpenCodequestion) : lorsqu'une décision modifie l'architecture, le flux de travail, le périmètre ou le risque - et pour l'entretien de sensibilisation du propriétaire - poser une question courte à 2-3 options et enregistrer l'option sélectionnée dans le rapport ou le registre. - Hôtes Codex ou chat uniquement : ne pas bloquer sur les questions non critiques. Continuer avec l'hypothèse réversible la plus sûre, la marquer comme une hypothèse et inclure un « Paquet de décision » avec les options que l'utilisateur devra choisir plus tard.
- Hôtes sans accès web : sauter l'analyse externe à œil neuf, le dire explicitement dans le rapport et marquer les domaines sensibles au temps (réglementation, politique de plateforme, tarification) comme non vérifiés plutôt que de les affirmer à partir des connaissances d'entraînement.
- Hôtes capables d'écrire des fichiers : pour les audits de projet, créer ou mettre à jour un registre par défaut, sauf si l'utilisateur a demandé une sortie en lecture seule / chat uniquement. Mentionner le chemin et la modification de routage dans le rapport.
- Hôtes en lecture seule ou à partage public : retourner un rapport portable avec des commandes/vérifications que l'utilisateur peut exécuter.
Ne demander immédiatement que lorsque continuer serait risqué, destructeur, coûteux ou susceptible de produire des résultats trompeurs.
Registre Et Runs Diff
Première exécution :
- Choisir le meilleur emplacement durable pour
BLINDSPOT_LEDGER.mden utilisantreferences/ledger-lifecycle.md. - Créer le registre à partir de
templates/BLINDSPOT_LEDGER.mdlorsque les écritures de fichiers sont appropriées. - Ajouter le registre à la surface de routage la plus proche, comme un README opérationnel, un index de documentation ou un pointeur de passation, lorsque ce fichier de routage existe déjà.
- Enregistrer le périmètre d'audit, le mode, les limites de preuve et les premiers constats.
Lorsqu'un projet a déjà un registre d'angles morts :
- Traiter le registre comme une entrée, pas comme une vérité. Re-vérifier les constats à fort impact ou obsolètes par rapport au code/à la documentation actuelle.
- Classer la sortie comme
nouveau,modifié,confirmé,rétrogradé,résoluounécessite-décision. - Ne pas répéter les éléments en attente inchangés, sauf s'ils bloquent l'objectif actuel. C'est ce qui rend les runs répétés agréables comme un progrès plutôt que comme une rengaine.
- Si le registre est nouveau mais n'est pas routé depuis un index, une passation ou un README opérationnel, signaler cela comme un angle mort de découvrabilité.
- Préserver le langage de statut local du registre et ses identifiants lors de sa mise à jour.
Les bons registres rendent les audits futurs moins chers. Les mauvais registres deviennent un autre document caché, donc toujours vérifier la découvrabilité.
Hygiène de Recherche
Utiliser des recherches délimitées. Les audits d'angles morts touchent souvent de vastes dépôts, et les fichiers générés bruyants peuvent créer une fausse confiance ou gaspiller du contexte.
Exclusions par défaut pour rg et outils similaires, sauf si l'audit cible explicitement ces zones :
!.git/**
!node_modules/**
!.venv/**
!dist/**
!build/**
!runtime/**
!external_repos/**
!vendor/**
!docs/archive/**
!docs/research/**
!docs/sources/**
!data/external/raw/**
Privilégier les chemins ciblés et les exclusions --glob plutôt que des analyses couvrant tout le dépôt. Si une analyse large retourne d'énormes fichiers générés, arrêter et relancer avec une limite plus stricte avant d'utiliser le résultat.
Flux de Travail
1. Définir La Carte
Énoncer l'objectif apparent de l'utilisateur, le type de projet, sa maturité et votre limite d'audit en 2 à 4 lignes. Marquer les hypothèses explicitement. Inclure un profil du propriétaire :
- Seul ou en équipe ? Dans quoi le propriétaire est-il clairement expert, et - plus utile - dans quoi n'est-il PAS expert ? Les angles morts se concentrent dans les domaines non experts du propriétaire, donc pondérer ces lentilles en conséquence.
- Passe-temps ou commercial ? Privé ou public ? L'intention commerciale ou publique active les lentilles juridiques, fiscales et de marché qui seraient du pur bruit pour un projet de passe-temps privé. Si l'intention n'est pas lisible dans les fichiers, demander avant d'analyser (une question courte) - deviner faux sur l'intention gaspille tout l'audit.
2. Rassembler Les Preuves
Utiliser l'outil d'inventaire plus des lectures ciblées. Lire d'abord les surfaces de conscience de soi du projet (README, TODO, feuille de route, listes de contrôle, documents de conception, synopsis/plan) - elles sont à la fois votre meilleure source de profil et votre filtre de bruit (Règle de Base 1). Privilégier les preuves plutôt que la spéculation large. Marquer les preuves comme :
- observé : directement présent dans les fichiers ou sorties.
- absent : artefact attendu non trouvé dans le périmètre inspecté.
- inféré : probable d'après la structure, la dénomination ou les conventions.
- question : nécessite confirmation de l'utilisateur ou du propriétaire du domaine.
3. Classer Le Territoire
Choisir un ou plusieurs archétypes dans references/archetypes.md. Ne pas forcer le projet dans une catégorie s'il est hybride.
4. Appliquer Les Lentilles
N'appliquer que les lentilles qui correspondent au stade du projet. Un prototype n'a pas besoin de conformité entreprise, mais il peut encore avoir besoin de limites de perte de données, de gestion des secrets ou de récupérabilité.
5. Analyse Externe À Œil Neuf
Lorsque l'hôte a un accès web, faire une recherche limitée dans le temps sur deux questions :
- Qu'est-ce que les projets sains de cette catégorie traitent comme équipement standard en ce moment ?
- Qu'est-ce qui a changé dans les 6 à 12 derniers mois - réglementation, politique de plateforme, conventions de marché ou de genre, outils - que les documents de ce projet ne pourraient absolument pas contenir ?
La question 2 est disproportionnellement précieuse : les changements dépendants du temps sont structurellement invisibles à la fois pour le dépôt et pour la mémoire du propriétaire. (Données de terrain : lors des premières exécutions, les constats les plus importants - une loi sur l'étiquetage du contenu IA entrant en vigueur le mois suivant, une acquisition de fournisseur de paiement qui invalidait un plan documenté - provenaient tous de cette étape.) Citer les sources pour tout ce qui est trouvé ici. Sans accès web, sauter et divulguer (voir Politique de Surface Hôte).
6. Convertir Les Angles Morts En Vérifications
Pour chaque constat, inclure :
- ce qui manque peut-être.
- pourquoi cela est important pour ce projet.
- preuve.
- prochaine vérification la moins coûteuse.
- propriétaire ou surface de décision probable.
- priorité : maintenant, ensuite, plus tard, ou surveiller.
- confiance : élevée, moyenne, faible.
Supprimer les candidats qui apparaissent dans les documents de suivi du projet (Règle de Base 1), garder les 3 à 7 premiers et déplacer le reste vers la liste de surveillance ou le registre.
7. Interviewer Le Propriétaire
Présenter les constats, puis demander lesquels le propriétaire connaissait déjà (une question à sélection multiple fonctionne bien sur les hôtes capables de choix). Classer chaque constat :
| Sensibilisation | Signification | Prescription |
|---|---|---|
inconnue_inconnue | Le propriétaire ne savait pas | Expliquer pourquoi c'est important ici + première étape la moins coûteuse |
inconnue_connue | Le propriétaire savait, mais ce n'est écrit nulle part | La correction est la documentation, pas l'implémentation - l'ajouter dans leurs documents de suivi pour que les agents et les futures sessions puissent le voir |
report_délibéré | Le propriétaire l'a considéré et a choisi de ne pas le faire | Déplacer dans la liste des ignorés AVEC la raison et un déclencheur de revérification |
(Données de terrain : lors des premières exécutions, environ la moitié des principaux constats se sont avérés être des inconnues_connues - de véritables lacunes dans le dépôt, mais pas dans la tête du propriétaire. La distinction change complètement le suivi.)
Sur les hôtes qui ne peuvent pas demander, marquer chaque valeur de sensibilisation comme non_confirmé, intégrer les questions d'entretien dans le rapport et placer les décisions ouvertes dans un « Paquet de décision ».
8. Garder La Sortie Utile
Commencer par les angles morts au signal le plus fort. Inclure toujours les deux sections de confiance (Règle de Base 4). Rédiger le rapport et la prose du registre dans la langue que le propriétaire utilise dans la conversation ; garder les identifiants, le statut et les valeurs de sensibilisation en anglais pour que les réexécutions restent différentiables entre les sessions et les langues. Formater selon references/report-template.md.
Garde-fous
- Ne pas présenter les bonnes pratiques génériques comme des constats à moins que les preuves du projet ne les rendent pertinentes.
- Ne pas re-signaler les éléments qui existent déjà dans le registre ou les documents de suivi du projet.
- Ne pas exiger de processus lourd pour les expériences personnelles ou les prototypes précoces.
- Ne pas apporter de modifications de code à moins que l'utilisateur ne demande explicitement une correction.
- Ne pas prétendre que quelque chose est cassé uniquement parce qu'un fichier est absent ; dire ce que l'absence suggère et comment le confirmer.
- Traiter l'absence de CI, de tests, de documentation de version ou de fichiers de déploiement comme un angle mort uniquement lorsque le projet revendique une livraison reproductible, une passation partagée ou une fiabilité de type production. Les notes personnelles et les prototypes précoces peuvent ne pas en avoir besoin.
- Ne pas submerger l'utilisateur de tous les risques possibles. Classer par adéquation au projet, rayon d'explosion, réversibilité et probabilité.
- Lorsque l'utilisateur n'est pas expert dans le domaine, inclure de courtes notes pédagogiques pour les angles morts inconnus.
- Lorsqu'un constat dépend du comportement actuel d'une plateforme externe, vérifier avec la documentation officielle ou une recherche actuelle avant de le traiter comme un fait ; sans accès web, le présenter comme non vérifié avec une explication.
- Conserver la sortie résumée pour les hôtes à contexte limité. Utiliser le registre pour les détails complets.
Références
Cette compétence est destinée à fonctionner avec des fichiers de référence dans le dossier de la compétence. Consulter le fichier approprié pour obtenir des conseils détaillés sur un aspect spécifique de l'audit.
Licence
MIT