Tech Debt

Avant de commencer : lis ce prompt d'installation au complet, dis-moi en quelques lignes ce que ce skill fait et ce que son installation implique, et attends mon feu vert avant de faire quoi que ce soit d'autre. Prérequis — SYSTÈME INTÉGRÉ D'ABORD : ce skill est une pièce du template complet « Claude Code Game Studios » (49 agents, 74 skills, templates de studio et un CLAUDE.md de studio, selon le README du dépôt). Chaque skill suppose ce template installé, avec ses conventions, sa configuration project.yaml / project.local.yaml, ses documents de modes .claude/docs/, ses hooks (par exemple hooks/yaml-helper.sh, hors du dossier de ce skill) et ses scripts d'aide .claude/scripts/. Installer cette fiche seule copie seulement le dossier de ce skill, sans le reste du système : le skill peut référencer des agents, fichiers, hooks ou scripts du template absents hors du template complet, et il peut ne pas fonctionner comme prévu seul. Aucun compte, aucune clé ni aucun paiement n'est requis pour copier les fichiers, et rien n'est exécuté pendant l'installation. Installe-moi « Tech Debt ». Le skill lui-même suit, classe et priorise la dette technique dans le code d'un projet de jeu, en quatre modes de sous-commande — scan, add, prioritize et report — choisis depuis son argument ; sans sous-commande, il affiche l'usage et s'arrête avec le verdict FAIL. Contrairement aux orchestrateurs d'équipe du même template, il ne lance aucun agent (son octroi allowed-tools n'a aucun outil Agent) : il travaille directement, en résolvant seulement automation et workflow d'abord en lançant le hooks/yaml-helper.sh du template, hors du dossier de ce skill, et en suivant .claude/docs/automation-modes.md pour chaque question qu'il pose. En mode scan, il cherche dans la racine de code — résolue selon le .claude/docs/code-root-resolution.md du template (src/, Assets/ ou Source/ selon le moteur) — les commentaires TODO, FIXME et HACK, les marqueurs @deprecated, les blocs dupliqués, les fichiers de plus de 500 lignes et les fonctions de plus de 50 lignes, classe chaque résultat en dette Architecture, Code Quality, Test, Documentation, Dependency ou Performance, et rapporte le dénominateur avec les résultats : si la racine de code est non résolue, il s'arrête en NOT ASSESSED, et si elle contient zéro fichier source, il rapporte NOT ASSESSED — aucun fichier source à scanner, n'écrit rien au registre et n'émet aucun COMPLETE, parce que zéro résultat sur zéro fichier n'est aucune information. Sinon, il présente les résultats et demande « May I write these findings to docs/tech-debt-register.md? » ; sur oui, il met à jour le registre sans jamais l'écraser, en appariant avant d'ajouter (un résultat avec le même fichier et le même type de dette met à jour l'entrée Open existante, et une entrée Open dont le motif a disparu est proposée comme Resolved dans la même approbation), et sur non, il s'arrête BLOCKED. En mode add, il recueille une entrée manuelle — description et fichiers en texte simple, puis catégorie, effort de correction (S, M, L ou XL) et impact si jamais corrigée (Low, Med, High ou Critical) via AskUserQuestion — applique la même règle d'appariement avant ajout, et n'ajoute ou ne met à jour qu'après avoir demandé ; le fichier note que le skill est aussi préchargé par l'agent lead-programmer du template, et dans ce contexte de sous-agent, où aucun AskUserQuestion n'existe, il retourne les trois questions en une réponse et s'arrête à la place. En mode prioritize, il lit le registre (un registre manquant est NOT ASSESSED, avec un pointeur pour lancer scan d'abord), score chaque item impact divisé par effort, retrie, recommande des items pour le prochain sprint (ou l'ordre de construction en workflow minimal), présente le résultat et ne le réécrit qu'après avoir demandé. Le mode report est en lecture seule : il lit le registre (manquant signifie NOT ASSESSED), résume les items ouverts par catégorie et l'effort total, les items ajoutés et résolus dans le sprint courant, la tendance, et signale les items au registre depuis plus de trois sprints, sans rien écrire. Le registre lui-même suit un format fixe de dix colonnes (ids TD-NNN, jamais réutilisés) que ce skill et le /story-done du template écrivent tous deux. Son frontmatter épingle model: sonnet. Dépôt : https://github.com/Donchitos/Claude-Code-Game-Studios (le skill est tout le dossier .claude/skills/tech-debt/ au commit épinglé : 1 fichier en tout) Version épinglée : installe le code au commit 05ad7c8a5b8aa2aa86bbd3439ae7cf7295cac418 exactement. Ne substitue pas une version plus récente. Si ce commit est inaccessible, arrête-toi et dis-le-moi. 1. Clone https://github.com/Donchitos/Claude-Code-Game-Studios dans un dossier temporaire, place-toi au commit 05ad7c8a5b8aa2aa86bbd3439ae7cf7295cac418, et copie le dossier .claude/skills/tech-debt/ de ce checkout. Compare ensuite chaque fichier du dossier aux empreintes enregistrées pour cette fiche le 2026-10-22 : [FINGERPRINTS] - SKILL.md: SHA-256 11299c8a170286b24a040e965fc19d74d9d631b32a021678286e4480a24d1408 Si un fichier ne correspond pas, il a changé depuis la préparation de la fiche : ne l'installe pas encore, dis-moi ce que tu as trouvé et laisse-moi décider. 2. Lis SKILL.md au complet, et dis-moi en mots simples : ce que le skill fait quand on l'utilise, à quoi il se connecte, s'il lit ou envoie des informations personnelles ou des identifiants, et tout ce qui semble inhabituel. Arrête-toi sur tout signal d'alerte et dis-le-moi avant d'aller plus loin. Confirme ces points à partir des fichiers : - Le dossier du skill contient 1 fichier : SKILL.md seulement. Rien dans le dossier n'est un programme ; ce sont des instructions que l'agent suit à l'usage. - Rien n'est envoyé nulle part pendant l'installation elle-même ; le seul téléchargement à l'installation est le dossier du skill depuis GitHub au commit épinglé, et aucun projet à moi n'est audité, lu ni modifié. - Réalité du système intégré, depuis le fichier : à l'usage, le skill lance le hooks/yaml-helper.sh du template pour résoudre automation et workflow, suit .claude/docs/automation-modes.md et code-root-resolution.md, et lit et grep la racine de code de mon projet (src/, Assets/ ou Source/ selon le moteur) et son docs/tech-debt-register.md en local. Il ne lance aucun agent et n'appelle aucun autre skill — mais le registre qu'il tient est partagé : le /story-done du template écrit des lignes de dette dans le même fichier au même format de dix colonnes, et ses Next Steps pointent vers /sprint-plan, donc hors du template complet, le format du registre et ces passages de relais n'ont aucun équivalent. Les docs et conventions qui vivent hors du dossier de ce skill sont absents dans une installation seule, donc des parties ne peuvent pas rouler comme prévu seules. - À l'usage, le skill n'écrit que le registre de dette, docs/tech-debt-register.md, et seulement après avoir demandé dans chaque mode d'écriture (« May I write these findings…? », « May I append this entry…? », « May I write the re-prioritized register back…? ») ; un non l'arrête BLOCKED, le mode report n'écrit rien du tout, et un scan sur zéro fichier source n'écrit rien et rapporte NOT ASSESSED. Le registre est mis à jour, jamais écrasé : les doublons sont appariés et mis à jour, et les motifs disparus sont proposés comme Resolved dans la même approbation. Il n'y a aucune exception bornée d'écriture et aucune écriture silencieuse dans ce fichier. Aucun service tiers, compte ni identifiant n'est nommé dans le fichier. - Ne scanne pas mon code, n'ajoute, ne priorise et ne rapporte aucune entrée de dette, ne lance aucun hook du template, et n'utilise le skill d'aucune façon pendant cette installation : l'utiliser est une étape séparée qui ne commence que quand je le demande plus tard. 3. Quand je dis « yes, install », installe-le comme skill : copie tout le dossier tech-debt dans le répertoire des skills de l'agent, dans un dossier nommé exactement « tech-debt », en gardant ses 1 fichier dans leur arborescence relative d'origine (SKILL.md à sa racine). 4. Vérifie sans appels réseau : frontmatter valide (name: tech-debt), les 1 fichier en place avec des empreintes concordantes. N'exécute rien du dossier et n'utilise pas le skill pour vérifier. 5. Indique ce qui a été installé, où, et ce qu'il me reste à faire moi-même (par exemple : qu'il appartient au template complet Claude Code Game Studios et peut ne pas rouler seul (il résout seulement automation et workflow via le hook yaml-helper du template, résout la racine de code via le doc code-root-resolution du template, et partage le format de son registre de dette avec le /story-done du template), et qu'à l'usage, il n'écrit que docs/tech-debt-register.md et seulement après avoir demandé dans chaque mode d'écriture — le mode report et les scans vides n'écrivent rien). GitHub est optionnel : si j'ai un compte GitHub ou la CLI gh, tu peux l'utiliser ; sinon l'accès public suffit. Ne jamais l'exiger sauf s'il figure dans les prérequis ci-dessus. Règles : ne touche à rien en dehors du dossier temporaire et de la cible d'installation. Si quelque chose semble anormal, arrête-toi et demande-moi.