CommunityRédaction et éditiongithub.com

Blindspot Audit

Une compétence portable pour agent IA qui identifie les angles morts d’un projet, les inconnues inconnues, les risques cachés et les décisions manquantes, avec un registre durable pour des audits répétés sous Claude Code, Codex et OpenCode.

Qu'est-ce que Blindspot Audit ?

Blindspot Audit est une compétence pour agents IA (comme Claude Code, Codex ou OpenCode) conçue pour révéler les écarts entre la carte mentale du propriétaire d’un projet et la réalité du projet. Elle utilise un cadre de classification en quatre types d’inconnues (connues connues, inconnues connues, etc.) pour transformer les angles morts en éléments concrets à inspecter, tester ou reporter délibérément. La compétence suit des règles strictes pour éviter les listes de contrôle génériques : elle plafonne les résultats à 3-7 points, vérifie la couverture réelle des risques, et inclut systématiquement des sections de confiance comme « Vérifié et bien couvert » ou « À ignorer pour l'instant ». Elle intègre un registre durable (ledger) qui garde la mémoire des audits précédents, ce qui permet des analyses différentielles efficaces et évite de répéter les mêmes constats. Utile pour tout développeur ou équipe souhaitant découvrir ce qu’ils ne savent pas qu’ils ignorent, elle s’adapte à différents modes (rapide, approfondi, entretien) et surfaces d’hébergement (avec ou sans accès web, lecture seule, etc.).

Compatible avec✓Claude Code✓Codex CLI~Cursor✓OpenCode
npx skills add MJL-ren/blindspot-audit

Installed? Explore more Rédaction et édition skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

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.

  1. 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.)
  2. 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.
  3. 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.
  4. 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.
  5. 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

  1. Identifier la racine du projet et la limite d'audit.
  2. 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.

  1. 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.
  2. 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.md dans 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.
  3. 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.
  4. Exécuter l'analyse externe à œil neuf (voir Flux de travail étape 5) lorsque l'hôte a un accès web.
  5. 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, OpenCode question) : 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 :

  1. Choisir le meilleur emplacement durable pour BLINDSPOT_LEDGER.md en utilisant references/ledger-lifecycle.md.
  2. Créer le registre à partir de templates/BLINDSPOT_LEDGER.md lorsque les écritures de fichiers sont appropriées.
  3. 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à.
  4. 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 :

  1. 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.
  2. Classer la sortie comme nouveau, modifié, confirmé, rétrogradé, résolu ou nécessite-décision.
  3. 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.
  4. 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é.
  5. 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 :

  1. Qu'est-ce que les projets sains de cette catégorie traitent comme équipement standard en ce moment ?
  2. 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 :

SensibilisationSignificationPrescription
inconnue_inconnueLe propriétaire ne savait pasExpliquer pourquoi c'est important ici + première étape la moins coûteuse
inconnue_connueLe propriétaire savait, mais ce n'est écrit nulle partLa 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 faireDé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

Skills associés