Vérificateur de Complétude de Module

Ce qu'il fait

Cette compétence agit comme une porte de qualité pour les modules logiciels, garantissant qu'aucun module n'est considéré comme « terminé » sans une documentation appropriée. Elle vérifie l'existence et la qualité des fichiers essentiels tels que README.md et DESIGN.md, empêchant la « dette documentaire » qui survient lorsque de nouvelles fonctionnalités sont implémentées sans guides mis à jour.

Quand l'utiliser

Utilisez cette compétence dans les scénarios suivants :

• Lors de la création d'un nouveau module pour bloquer la livraison tant que la documentation n'est pas présente.
• Lors du refactoring d'un module pour s'assurer que la documentation reflète les changements de périmètre.
• Lors de la réception d'un module d'un autre développeur pour vérifier sa maintenabilité.
• Comme vérification finale avant de soumettre une pull request impliquant de nouveaux modules.

Ce qui est inclus

• Scripts : Inclut module_scanner.js pour l'analyse automatisée des répertoires et la génération de rapports (sortie JSON pour l'intégration CI).
• Instructions : Fournit des critères détaillés pour ce qui constitue un README valide (perspective externe) et un document DESIGN (perspective architecturale interne), incluant des checklists pour les objectifs de conception et les compromis.

Agents compatibles

Conçu pour les agents de codage à haute capacité comme Claude Code, Codex, Gemini CLI et OpenClaw ayant accès aux outils de système de fichiers et à l'exécution shell.