--- name: chemin-dore description: "Chemin doré de Contoso Banque pour livrer un changement dans un dépôt de la plateforme (contoso-paiements-api, contoso-paiements-web ou tout dépôt avec le sujet « contoso ») : cadrage depuis l'issue, plan, branche, tests, pull request avec preuves, sans jamais contourner les règles." --- # Chemin doré Contoso Applique ces étapes, dans l'ordre, pour toute évolution de code dans un dépôt Contoso. ## 1. Cadrer 1. Lis l'issue et ses critères d'acceptation. Si un critère est ambigu, pose la question avant de coder. 2. Liste les dépôts touchés. Quand l'API et l'interface sont concernées, fixe d'abord le **contrat d'API** (chemin, paramètres, réponse JSON) et utilise-le à l'identique des deux côtés. 3. Propose un plan court (3 à 6 étapes) avec les fichiers prévus et les tests à ajouter. ## 2. Coder - Branche : `feat/-` (exemple : `feat/1-plafond-par-segment`). - Respecte `.github/copilot-instructions.md` du dépôt. En particulier : - montants en **entiers en centimes**, jamais de nombre à virgule flottante pour de l'argent ; - requêtes SQL paramétrées uniquement ; - aucune nouvelle dépendance sans validation humaine ; - aucun secret ni donnée personnelle réelle, même dans les tests. - Écris ou adapte les tests en même temps que le code : cas nominal, limite exacte, refus. ## 3. Vérifier | Dépôt | Tests | | --- | --- | | `contoso-paiements-api` | `python -m unittest discover -s tests -t . -v` | | `contoso-paiements-web` | `node --test` | Tous les tests doivent passer localement avant d'ouvrir la PR. Si l'interface change, lance `node src/serveur.mjs` et vérifie l'écran (capture pour la PR). ## 4. Livrer 1. Commits courts, au présent, en français (exemple : `Ajoute le plafond par segment`). 2. Ouvre la PR avec le modèle du dépôt, `Closes #N`, et la section **Preuves** remplie : commande de test et résultat, nouveaux tests, capture si l'interface change. 3. Une PR par dépôt ; mentionne la PR liée de l'autre dépôt. ## 5. Ne jamais - fusionner soi-même, utiliser `gh pr merge --admin`, `--no-verify` ou un push forcé ; - modifier les règles de protection, les workflows CI ou les hooks de garde-fous sans validation humaine ; - marquer une case de la section Preuves sans l'avoir vérifiée. Les garde-fous du dépôt (`.github/hooks/garde-fous.json`) refusent ou soumettent à validation humaine ces actions : si un outil est refusé, explique pourquoi et propose une alternative conforme au lieu de contourner. ## Après la PR Utilise la skill `dossier-de-preuves` pour vérifier que la PR est prête : checks, revue Copilot, code scanning, règles de la branche.