AradhanaID/agent-skills

Détermine où placer les fichiers frontend dans ce dépôt. À utiliser lors de la création ou du déplacement d'un fichier.

Qu'est-ce que agent-skills ?

Cette compétence (skill) oriente les agents IA sur la structure des fichiers frontend d'un dépôt : conventions de dossiers, conventions de nommage et détection des fichiers mal placés. Elle est conçue pour fonctionner avec des assistants comme Claude Code, Cursor ou Codex. Son utilité principale est de garantir que les fichiers sont placés de manière cohérente et conforme aux règles du projet, réduisant ainsi la confusion et les erreurs de structure. Le fonctionnement repose sur trois étapes : identifier la nature du fichier (composant, hook, utilitaire, test, etc.), le placer selon les règles définies dans le fichier reference.md (qui est la source unique de vérité), et vérifier que son nommage est cohérent avec les fichiers voisins. La règle clé est qu'un composant ne se déplace jamais seul : il est toujours accompagné de ses fichiers de test, d'histoire et de styles. En cas de conflit entre deux règles, la règle la plus spécifique l'emporte, et le conflit est signalé pour correction.

Compatible avec~Claude Code~Codex CLI~Cursor

npx skills add https://github.com/AradhanaID/agent-skills/tree/HEAD/skills/structure

Documentation

Structure

Cette compétence oriente l'emplacement du code frontend : conventions de dossiers, conventions de nommage et ce qui indique qu'un fichier est mal placé. Les conventions évoluent avec la base de code, la liste faisant autorité se trouve dans reference.md — lisez-la avant de placer un fichier.

Étapes

Demandez ce qu'est le fichier, pas où il va. Composant, hook, utilitaire, test, asset, configuration. Le type détermine le placement ; le type est un mot-clé pour les conventions dans reference.md. Terminé quand : le type est indiqué en un mot.
Placez selon les règles, des unités entières à la fois. Un composant se déplace avec son test, son histoire et ses styles — jamais le composant seul. Terminé quand : le placement correspond textuellement aux règles ; toute dérogation de nommage est listée à la fin de l'exécution avec une justification.
Confirmez le nommage par rapport aux voisins. Le nom correspond aux fichiers frères et à la convention générale : singulier/pluriel, séparation par points, casse. Terminé quand : la liste d'un répertoire se lit uniformément ; rien ne nécessite un renommage pour s'intégrer.

Référence

reference.md — les règles de placement et les conventions de nommage. Mettez-le à jour lorsque la structure du dépôt se stabilise ; c'est la source unique de vérité, et les conventions énoncées ailleurs sont des approximations de ce fichier.
Lorsque deux règles semblent en conflit, la règle la plus spécifique l'emporte, et le conflit est signalé afin que les règles puissent être corrigées.