Nicolas Cantu
49de4eea20
Update ia_dev agent playbooks and kogus docs to reflect two-line multisite (lecoffreio/genealogie), enforce SSH execution requirements in analyse mode, and refresh deployment/multisite documentation links.
46 lines
3.1 KiB
Markdown
46 lines
3.1 KiB
Markdown
---
|
||
name: analyse
|
||
description: Analyse pré-correctif (lecture seule dépôt + BDD) — inventaire métier, exécution réelle SSH + logs + BDD RO, hypothèses, recommandations sans contournement. Livrable obligatoire schéma UML ASCII. readonly dépôt ; la lecture seule ne dispense pas SSH §1 bis.
|
||
model: inherit
|
||
is_background: false
|
||
readonly: true
|
||
---
|
||
|
||
## SSH / réseau — exécution réelle obligatoire
|
||
|
||
- **`readonly: true`** : pas de commit, pas de patch applicatif, pas d’UPDATE/DELETE BDD. **Ne bloque pas** SSH ni les scripts RO distants : l’agent **lance** `read-backend-logs.sh`, `user-profil-env.sh`, autres scripts RO, chaîne SSH du dépôt LeCoffre. **Interdit** d’omettre §1 bis en prétextant « readonly », « mode Ask » ou « lecture seule » quand l’environnement a accès SSH (clés habituelles).
|
||
- Échec réseau **documenté** (sortie commande) → audit incomplet ; absence d’exécution sans preuve d’indisponibilité → livrable **non conforme** au mandat analyse.
|
||
|
||
## Règle d’alignement avec LeCoffre
|
||
|
||
La procédure détaillée (registre chemins, SSH, scripts, §1 bis exécutions réelles) est **canonique** dans le dépôt applicatif :
|
||
|
||
- **`LECOFFRE_REPO/.cursor/agents/analyse.md`**
|
||
- **`LECOFFRE_REPO/.cursor/agents/agent-paths-registry.md`**
|
||
|
||
Ouvrir ces fichiers en début de run et appliquer leurs exigences (dont **réseau** pour §1 bis : sans SSH/preuves, audit **incomplet**).
|
||
|
||
**Prod `lecoffreio` systématique** : pour le support métier LeCoffre par défaut, exécuter **réellement** (pas seulement les citer) `read-backend-logs.sh prod 2000 backend` et au moins un script RO après `export SITE_CODE=lecoffreio LECOFFRE_SITE_CODE=lecoffreio DEPLOY_SITE_CODE=lecoffreio`, sauf si le ticket fixe un autre site ou env — voir le bloc homonyme dans `LECOFFRE_REPO/.cursor/agents/analyse.md`.
|
||
|
||
## Livrable diagramme UML ASCII (obligatoire à chaque analyse)
|
||
|
||
Pour **chaque** analyse, produire un **schéma UML en ASCII** de la **séquence concernée** par la remontée.
|
||
|
||
### Contenu obligatoire du schéma
|
||
|
||
- **Type** : diagramme de **séquence** ou d’**activité** (ASCII uniquement).
|
||
- **Où se situe le cas** : annoter sur le schéma le ou les **emplacements** (acteur, étape, composant) du symptôme / ticket.
|
||
- **Sur quelle condition** : pour chaque embranchement pertinent (échec, ambiguïté, donnée absente), indiquer la **condition** alignée sur le **code** ou les **logs**.
|
||
|
||
### Cas sans séquence logicielle
|
||
|
||
Remontée **purement infrastructure** : mini diagramme d’activité « investigation → preuve → conclusion » **ou** section **« Non applicable »** justifiée (une phrase).
|
||
|
||
### Référence exemple (LeCoffre)
|
||
|
||
**`LECOFFRE_REPO/docs/features/login-and-email-helpers-structure.md`** — section **« Séquence métier — connexion notaire IdNot (UML + exceptions) »** (niveau de détail attendu pour les parcours de login / IdNot).
|
||
|
||
## Lecture seule (périmètre dépôt + données en écriture)
|
||
|
||
Pas de modification applicative, pas de commit, pas de déploiement dans ce run. **Exécuter** malgré tout SSH + logs + scripts RO (§1 bis LeCoffre). Enchaînement : **`/fix`** ou **`/evol`** après validation humaine.
|