Communitygithub.com

zhaidewei/garder-ou-balayer

Gardez-le, réparez-le, archivez-le ou balayez-le — une compétence d'agent reposant sur les preuves.

Qu'est-ce que garder-ou-balayer ?

Cette compétence d'agent permet d'auditer un actif clairement délimité pour décider de son sort : conserver, réparer, archiver ou supprimer. Elle est utile pour les développeurs et les équipes qui doivent gérer des artefacts logiciels, de la documentation ou des ressources systèmes en s'appuyant sur des preuves tangibles plutôt que des suppositions. Compatible avec les plateformes d'agents comme Claude Code, Cursor ou Codex, elle suit un workflow structuré en six étapes : bornage de l'actif, inventaire en lecture seule, test de la contre-factuelle de suppression, classification du rôle, choix d'une disposition, et exécution uniquement dans le cadre de l'autorité donnée. L'agent ne doit jamais effectuer de suppression sans une méthode de récupération nommée et une vérification post-suppression. Un arbre de décision en Mermaid guide l'analyse en fonction de la suffisance des preuves, de l'impact de la suppression et de l'existence d'une obligation de conservation.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add zhaidewei/keep-or-sweep

Demander à votre IA préférée

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

Documentation

Garder ou Balayer

Auditez un actif clairement délimité. Ne transformez pas cela en un exercice de déduplication ou de recherche de source canonique à l'échelle du patrimoine.

Workflow

  1. Bornage de l'actif. Nommez la cible exacte, le propriétaire ou l'autorité, les opérations autorisées et le périmètre d'impact. Si la demande contient plusieurs actifs indépendants, sélectionnez une cible claire pour cet audit et listez les autres comme hors périmètre. Ne continuez pas à travers la liste dans le même audit.
  2. Inventaire en lecture seule. Trouvez les consommateurs, appelants, déclencheurs, dépendances, entrées, sorties, contrats, copies générées, historique, obligations de conservation et utilisation à l'exécution. Recherchez les noms et les comportements ; l'utilisation dynamique et les permissions indisponibles restent inconnues.
  3. Test de la contre-factuelle de suppression. Indiquez quel comportement observable de l'utilisateur ou de l'agent s'aggraverait si l'actif disparaissait. Une correspondance de nom ou une forme similaire ne prouve pas la redondance.
  4. Classification de son rôle. Une source de vérité, une projection et un adaptateur sont des rôles, pas des verdicts. Pour une projection, vérifiez la valeur spécifique au consommateur, la cohérence avec sa source, la régénération ou la synchronisation, et un mécanisme de maintenance avec un propriétaire, un déclencheur, une détection de dérive et un chemin de réparation.
  5. Choisir exactement une disposition.
    • Garder : il a une valeur prouvée et un mécanisme de maintenance crédible.
    • Réparer ou remplacer : il a des utilisateurs prouvés mais son mécanisme actuel n'est pas fiable.
    • Archiver : l'utilisation en direct est absente, mais il existe une obligation légale, historique, d'audit ou contractuelle de conservation.
    • Supprimer : aucun comportement observable ne s'aggrave et aucune obligation de conservation ne s'applique. Ceci est une recommandation ; cela n'autorise pas l'exécution.
    • Suspendre : les preuves, les permissions, l'autorisation, la récupérabilité ou l'analyse des risques irréversibles sont insuffisantes.
  6. Exécuter uniquement dans le cadre de l'autorité. Un audit en lecture seule n'implique jamais la permission de supprimer, écraser, muter un état distant ou effectuer un changement irréversible. Avant la suppression, nommez la méthode de récupération. Après la suppression, vérifiez les consommateurs attendus et rapportez tout ce qui n'est pas encore prouvé.

Arbre de décision

flowchart TD
    A["Bornage d'un actif<br/>et inventaire en lecture seule"] --> B{"Preuves suffisantes ?"}
    B -- "Non" --> P["Suspendre et nommer<br/>les preuves manquantes"]
    B -- "Oui" --> C{"La suppression aggraverait-elle<br/>un comportement observable ?"}
    C -- "Inconnu" --> P
    C -- "Non" --> D{"Obligation de conservation ?"}
    D -- "Oui" --> R["Archiver"]
    D -- "Non" --> X["Recommander la suppression"]
    C -- "Oui" --> F{"Mécanisme de maintenance<br/>crédible ?"}
    F -- "Oui" --> K["Garder"]
    F -- "Non" --> N["Réparer ou remplacer"]

Des consommateurs inconnus, des appels dynamiques, un accès manquant et des preuves absentes ne signifient pas que l'actif est inutilisé. En cas d'incertitude, suspendez et identifiez la plus petite vérification suivante qui pourrait changer la disposition.

Skills associés