Contribuer

Comment contribuer au développement de maconfai.

Mise en place de l'environnement

Pour contribuer à maconfai, commencez par cloner le repository et installer les dépendances :

git clone https://github.com/vbarrai/maconfai
cd maconfai
pnpm install

Commandes de développement

Le projet utilise pnpm comme gestionnaire de paquets. Voici les commandes principales :

# Lancer le CLI en mode développement
pnpm run dev

# Lancer les tests en mode watch
pnpm test

# Exécuter les tests une seule fois
npx vitest run

# Vérification TypeScript
pnpm typecheck

# Linter
pnpm lint

# Détection de code inutilisé
pnpm knip

# Formatage du code
pnpm format

Conventions de code

Le projet suit ces conventions : • TypeScript strict avec modules ESM • Formatage via Prettier (exécuté automatiquement) • Linting via oxlint • Tests avec Vitest — un test par fichier, inline snapshots privilégiés • Couverture actuelle : 73%

Créer une skill

Pour créer une nouvelle skill distribuable via maconfai : 1. Créez un répertoire skills/ dans votre repository 2. Ajoutez un sous-répertoire par skill 3. Placez un fichier SKILL.md dans chaque sous-répertoire 4. Le fichier SKILL.md contient les instructions que l'agent suivra Votre skill est alors installable par quiconque via :

# Structure d'un repository de skills
mon-repo/
└── skills/
    ├── skill-debug/
    │   └── SKILL.md
    ├── skill-review/
    │   ├── SKILL.md
    │   └── templates/
    └── skill-deploy/
        └── SKILL.md

# Installation par un utilisateur
npx maconfai install votre-user/mon-repo

Liens utiles

• Repository GitHub : github.com/vbarrai/maconfai • npm : npmjs.com/package/maconfai • Issues : github.com/vbarrai/maconfai/issues • Licence : MIT

Architecture