Configuration de projet

Que fait Configuration de projet ?

Chaque étape utilise la CLI officielle ou la documentation de l'outil concerné (compétence official-docs). Demander avant toute action distante.

Projet fraîchement créé (la CLI a déjà scaffoldé, installé et vérifié tout)

1. Lire PROJECT.md et remplir la section Quoi (nom, domaine, type, objectif) avec l'humain, dans ses propres mots. {{#dotenv}}
2. L'humain copie .env.example vers .env et le remplit{{#auth}} ({{dlx}} auth@latest secret génère le secret d'authentification){{/auth}}. Les agents ne créent, ne lisent ni n'écrivent jamais .env. Tant qu'il n'existe pas, tester avec des valeurs jetables définies uniquement pour cette commande. {{/dotenv}} {{#postgres}}
3. Base de données locale : docker compose up -d, puis {{run}} db:migrate (demander d'abord). {{/postgres}} {{#d1}}
4. Base de données locale : {{run}} db:migrate (demander d'abord). {{/d1}}
5. {{run}} docs:sync, puis remplir docs/DEPLOYMENT.md (URLs, où sont définis les secrets). {{#cloudflare}} Remplacer les identifiants factices dans wrangler.jsonc une fois les ressources créées (DEPLOYMENT.md → Configuration initiale). {{/cloudflare}}
6. Laisser le fichier design/DESIGN.md pour la compétence website-design, qui rassemble les entrées de conception dans l'ordre avant la première page ; la page d'accueil est un espace réservé.
7. Une fois le dépôt sur GitHub, l'humain active Paramètres → Actions → Général → "Autoriser GitHub Actions à créer et approuver des pull requests", afin que la mise à jour hebdomadaire des compétences d'agent puisse ouvrir sa pull request. Dependabot et modifications des workflows : compétences dependabot et github-actions-hardening.
8. {{run}} log "Projet configuré" --by <agent>.

Projet existant (adoption du kit)

1. {{dlx}} create-agent-ready-app@latest install . ajoute uniquement la configuration agent (AGENTS.md, compétences, scripts, garde-fous) ; il détecte les add-ons à partir de package.json. Les anciens AGENTS.md, CLAUDE.md, .cursorrules et fichiers similaires sont déplacés vers docs/legacy-agents.md : intégrer les règles toujours applicables dans PROJECT.md → Règles pour les agents, puis supprimer le fichier (demander).
2. Remplir PROJECT.md à partir de ce qui existe (package.json, routes, un rapide aperçu des dossiers). Ne pas explorer en profondeur.
3. Ne pas restructurer. Lister les lacunes (structure, vérifications, SEO, sécurité) comme une seule grande tâche proposée et demander.

Ajout ultérieur d'un add-on (Protégé)

1. Poser une question oui/non : l'add-on, les paquets qu'il ajoute, les fichiers qu'il crée.
2. {{dlx}} create-agent-ready-app@latest add <add-on> . crée les fichiers de l'add-on qui n'existent pas encore, actualise AGENTS.md et les compétences, installe son pack de compétences et affiche les paquets à ajouter.
3. {{add}} ces paquets. Ensuite, l'intégrer dans les fichiers déjà possédés par le projet, en suivant les fichiers de l'add-on dans le dépôt create-agent-ready-app (template/frameworks/) et la documentation officielle :
   • query : {{#tanstack-start}}src/router.tsx (QueryClient + intégration SSR) et src/routes/__root.tsx (panneau devtools){{/tanstack-start}}{{#next}}src/shared/lib/tanstack/query-provider.tsx dans src/app/layout.tsx{{/next}} ;
   • shadcn : {{dlx}} shadcn@latest apply --preset nova, puis add les composants nécessaires ;
   • auth : les gardes sous {{#tanstack-start}}src/routes/_private/{{/tanstack-start}}{{#next}}src/app/(private)/{{/next}} et {{run}} auth:generate, puis {{run}} db:generate.
4. {{run}} docs:sync, {{run}} check, mettre à jour PROJECT.md → Pile et décisions, et ajouter une ligne de journal.

Suppression d'un add-on (Protégé)

{{dlx}} create-agent-ready-app@latest remove <add-on> . supprime ses fichiers kit, compétences, scripts et autorisations. Supprimer son code et ses paquets est une grande tâche : rg pour chaque utilisation, le supprimer, puis {{run}} check.

Compétences d'agent

• Les compétences de la communauté dans .agents/skills/ proviennent de leurs créateurs (skills-lock.json enregistre chaque source et un hash). {{run}} skills:update les actualise ; lire le diff avant de valider, comme pour toute modification de code.
• Autres compétences : privilégier les compétences officielles des créateurs de l'outil (https://www.skills.sh/official) ; compétence find-skills, ou {{dlx}} skills@latest add <owner/repo> --skill <name> -a universal -a claude-code (demander d'abord). Un pack optionnel : {{dlx}} create-agent-ready-app@latest add <pack> . (marketing, revue de sécurité…).

Mise à jour du kit

{{run}} kit:update actualise AGENTS.md, les compétences et les scripts. Les fichiers kit modifiés dans ce projet sont conservés et signalés ; placer les règles spécifiques au projet dans PROJECT.md plutôt que de modifier les fichiers kit.