Reprise d'un code existant

point d'entrée et routage

Point d'entrée principal d'Ulk — orchestre le roster d'agents pour n'importe quel projet. Utiliser pour « démarrer un projet » / « on reprend » / « tâche suivante » / « status » / « audit ». Toujours passer par Bruce d'abord, jamais directement par un sous-agent.

/ulk:bruce

audit technique, dix axes

Audite un projet entier sans rien présupposer de sa stack — la détecte, relève la structure et les conventions, puis chiffre le résultat en scores, violations et recommandations. Utiliser sur un dépôt qu'on ne connaît pas, ou avant d'en reprendre un. Pas pour un point de contrôle de séance (peon).

/ulk:recenseuse

cartographie du projet par stack

Cartographie un projet dans la stack qu'il utilise — Astro, Next.js, Nuxt, SPIP, Laravel, SwiftUI — en inventoriant composants, routes, squelettes ou Views, puis en relevant les problèmes de performance, d'hydratation et d'architecture. Détecte la stack seul, ou l'accepte en argument ("analyze next", "analyze spip", "analyze laravel"). Déléguer quand il faut savoir ce qu'il y a dans un codebase avant d'y toucher — reprise d'un projet hérité, arrivée sur une base inconnue, préparation d'une migration. Pas pour juger la qualité du code (recenseuse, scaphandriere), pour un projet SwiftUI qu'il faut noter contre la guidance Apple (woz), ni pour écrire la spec d'un projet neuf (greffiere).

/ulk:controleuse

reconstitue la documentation

Reconstitue la documentation d'un codebase ou rétro-conçoit des prompts IA — génère docs/rewrite/ (spec, doc technique, architecture). Utiliser pour « legacy non documenté » / « que fait ce code » / « reverse ce prompt ».

/ulk:restauratrice

tests unitaires avant de toucher

Écrit et configure des tests unitaires — Jest, Vitest ou le framework natif du projet — sur des fonctions, composants, hooks et utilitaires, avec les rapports de couverture et le câblage CI. Déléguer quand il manque des tests sur de la logique isolable, ou après l'ajout d'une fonctionnalité non couverte. Pas pour les parcours utilisateur de bout en bout dans un navigateur (funambule) ni pour corriger des tests qui échouent déjà (ravaudeuse).

/ulk:calibreuse

inventaire des restes

Fouille un dépôt et en exhume ce qui a été laissé derrière — tickets abandonnés, branches stales, fichiers orphelins, TODO fossilisés, dépendances mortes — compilé en rapport. Déléguer avant un grand rangement, à la reprise d'un projet laissé en friche, ou quand personne ne sait plus ce qui sert encore. Glaneuse, raton laveur de Seattle atteint de short spine syndrome, rapporte son butin ; il ne jette rien lui-même. Pas pour un audit de qualité du code (recenseuse) ni pour la release (appareilleuse).

/ulk:glaneuse

repère ce qui ne tient qu'au projet

Audite ce qui, dans un projet, ne tient qu'à lui — secrets, couplages, dépendances, architecture — puis transplante vers un autre projet les modules qui s'en détachent. Trois modes : audit (défaut), greffe, base. Utiliser pour un passage en open-source, un fork propre, une refonte sur base saine.

/ulk:greffeuse

mesure et réduit la complexité

Cartographie la complexité d'un codebase — fichiers trop longs, duplication, abstractions mortes, dépendances inutiles — puis applique les simplifications via /simplify, fichier par fichier, comportement inchangé. Utiliser sur une base qu'on connaît déjà et qu'on veut alléger. Pas pour l'audit complet d'un projet (recenseuse).

/ulk:scaphandriere

bus factor et dynamiques humaines

Audite les dynamiques organisationnelles et humaines dans le code — bus factor, gouvernance, prisme du genre, exclusion, désengagement. Utiliser pour « revue organisationnelle » / « audit humain » / « bus factor ». Pas pour l'audit technique (recenseuse).

/ulk:arpenteuse

valeurs et secrets en dur

Détecte et corrige les données en dur — secrets / clés API, URLs/IPs spécifiques à un environnement, nombres magiques, PII / fausses données. Rapporte fichier:ligne avec sévérité + correctif assisté par IA (migration .env, constantes nommées). Utiliser pour « audit hardcode » / « données en dur » / « valeurs hardcodées ». Pas pour l'audit OWASP approfondi (serruriere).

/ulk:demineuse