agentleFS
yannick-bottinoyannick-bottino/consulting-claude-skills/skills/project-lint/SKILL.md

project-lint

Skill0 starsChanged 56 days agoMITView on GitHub

Use when auditing an existing project folder for structural compliance with project-init guidelines (pilote de session + substrat de mémoire 3 couches). Trigger phrases: "vérifie le dossier projet", "le dossier est-il conforme", "audit projet", "check project setup", "lint projet", "est-ce que la structure est correcte", onboarding d'un nouveau membre sur un projet existant, ou après des modifications structurelles du dossier.

The file

Files
SKILL.md

project-lint

Objectif

Vérifier la conformité d'un dossier projet (créé via project-init), lister les écarts avec niveaux de sévérité, proposer les corrections, les appliquer après confirmation.

Ne pas modifier /project-init ni /project-memory -- ce skill est leur complément ponctuel d'audit.

Périmètre : ce lint vérifie la conformité du setup (les bons fichiers sont là, bien formés). La santé interne du substrat (dérive d'index, intégrité Cold, frontmatters) est du ressort de lint_memory (dans project-memory). Ce skill délègue la partie profonde à lint_memory plutôt que de la réimplémenter.

Phase 1 — Checks structurels

Exécuter les vérifications suivantes :

#VérificationCritèreSévérité si KO
1CLAUDE.md présentFichier à la racinecritique
2CLAUDE.md ≤ 200 lignesCible : 200 lignes maxmajeur (201-300L) / critique (>300L)
3_memory/ présentDossier substrat à la racinecritique
4Sous-dossiers substrat_memory/Décisions/, _memory/Synthèses/, _memory/Logs/ présentscritique
5_memory/context.md présentFichier de métadonnées missionmajeur
6_memory/CLAUDE.md présentRègles de routage du substratmajeur
7Index présents_memory/_Index.md + un _Index.md par sous-dossiermajeur
8claude_tasks/TODO.md présentFichier dans claude_tasks/critique
9Pas de MEMORY.md résiduelSi un MEMORY.md plat existe à la racine → vestige de l'ancien setup à migrer vers le substratmajeur
10Section Équipe dans CLAUDE.mdTable | Username | Prénom | présente avec ≥1 ligne rempliemajeur
11Sections TODO.mdTODO / IN PROGRESS / DONE présentesmajeur
12Attributions + @owner TODO.mdTâches portant `[date@auteur]et un@owner`mineur

Check 9 (MEMORY.md résiduel) : le nouveau setup remplace le MEMORY.md plat par le substrat 3 couches. Un MEMORY.md présent signale un dossier initialisé avec l'ancien cowork-init. Proposer la migration de son contenu vers Décisions/ (décisions actées) / Synthèses/ (réflexions) avant suppression. Ne jamais supprimer son contenu sans l'avoir reversé.

Phase 1bis — Santé du substrat (délégation)

Si _memory/ est présent et structurellement valide, lancer lint_memory quick (skill project-memory) et intégrer son rapport (dérive d'index auto-corrigée, conformité frontmatter, intégrité Cold, liens cassés) à la sortie de la Phase 2.

Phase 2 — Rapport d'écarts

Produire exactement ce format :

## Rapport de conformité — [nom du dossier]

✅ Conforme (X/12 vérifications structurelles)
🩺 Santé substrat : [résumé lint_memory : index OK/corrigés, N frontmatters à revoir...]
⚠️  Écarts détectés :

1. [critique] CLAUDE.md absent
   → Action : créer le setup via /project-init
2. [majeur] MEMORY.md résiduel détecté (ancien setup)
   → Action : migrer son contenu vers _memory/ (Décisions / Synthèses) puis supprimer
3. [mineur] 3 tâches TODO.md sans @owner
   → Lignes concernées : 12, 18, 24

Niveaux :

  • critique — fonctionnement projet bloqué
  • majeur — fonctionnement dégradé
  • mineur — non-conformité cosmétique

Phase 3 — Apply fixes

Les messages entre guillemets ci-dessous sont des prompts à adresser à l'utilisateur.

  1. Lister les actions concrètes avec fichiers et lignes concernées
  2. Demander confirmation globale : "Je vais appliquer X corrections. Confirmes ?"
  3. N'appliquer qu'après confirmation explicite
  4. Appliquer atomiquement (une action = un fichier modifié)
  5. Confirmer chaque modification : "✅ [action effectuée]"

Cas CLAUDE.md > 200 lignes : Ne pas modifier CLAUDE.md directement. Proposer à la place :

"CLAUDE.md fait X lignes (cible : 200). Veux-tu que je lance /instructions-audit pour un audit de gouvernance et un refactor ?"

Attendre confirmation. Si oui, lancer /instructions-audit.

Cas MEMORY.md résiduel : Ne jamais supprimer le MEMORY.md sans avoir reversé son contenu. Proposer :

"MEMORY.md (ancien setup) contient N entrées. Je peux migrer les décisions actées vers _memory/Décisions/ et les réflexions vers _memory/Synthèses/ via project-memory, puis supprimer le fichier. Confirmes ?"

Cas dérive d'index / substrat : Déléguer à lint_memory (qui auto-corrige la dérive d'index de façon déterministe et signale le reste). Ne pas réécrire les fichiers du substrat à la main depuis ce skill.

Erreurs fréquentes

  • Appliquer des fixes sur CLAUDE.md > 200 lignes directement : toujours déléguer à /instructions-audit.
  • Supprimer un MEMORY.md résiduel sans migrer son contenu : la migration précède toujours la suppression.
  • Réimplémenter le check de substrat : déléguer à lint_memory, ne pas dupliquer.
  • Lancer le lint sur le mauvais dossier : vérifier que le dossier cible est bien un projet (créé via /project-init), pas un référentiel de skills ou un dossier quelconque.
  • Confirmer un apply global sans relire la liste : si des écarts critique sont présents, les signaler explicitement avant de demander confirmation globale.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.