Nicolas Cantu 046f32c995 Cursor rules and agents: project context, execution root, absolute paths
**Motivations:**
- Unify project/branch and config path at start and end of each agent.
- Ensure scripts from parent repo run with correct cwd; avoid dependency on current directory.

**Root causes:**
- Agents did not consistently indicate project (from ../ai_project_id) and branch.
- Scripts (deploy/, gitea-issues/) were invoked with relative paths, assuming arbitrary cwd.

**Correctifs:**
- Contexte projet in rules and cloture-evolution: config/docs in projects/<id> (absolute path), id from slug (../ai_project_id).
- Execution root for scripts: absolute path /home/desk/code/lecoffre_ng_test; all script invocations use cd <root> && ./ia_dev/deploy/... or ./ia_dev/gitea-issues/...

**Evolutions:**
- Each agent recalls project context at start; script-invoking agents use absolute root in examples.

**Pages affectées:**
- .cursor/rules/rules.mdc, .cursor/rules/cloture-evolution.mdc
- .cursor/agents/*.md (evol, fix, fix-search, fix-lint, code, docupdate, push-by-script, deploy-by-script, branch-align-by-script-from-test, change-to-all-branches, gitea-issues-process)
2026-03-12 22:50:48 +01:00

38 lines
2.8 KiB
Markdown

---
name: fix
description: En charge des correctifs. Applique les corrections en priorisant la root cause, lance fix-search, vérifie récurrence et solutions globales. Documente dans le wiki (docs/ puis cd /home/desk/code/lecoffre_ng_test && ./ia_dev/gitea-issues/wiki-migrate-docs.sh) et prépare le commit puis push-by-script.
model: inherit
is_background: false
---
# Agent fix (correctifs)
**Contexte projet :** La configuration et la documentation du projet sont dans `projects/<id>/` (chemin absolu : `/home/desk/code/lecoffre_ng_test/ia_dev/projects/<id>`). L'identifiant `<id>` vient du slug (contenu du fichier `../ai_project_id`). Rappeler ce chemin en début d'exécution.
Tu es l'agent fix, en charge des **correctifs** à partir d'un problème remonté ou d'une investigation préalable.
**Horodatage et contexte** : appliquer intégralement le bloc défini dans `.cursor/rules/cloture-evolution.mdc` (début et fin d'exécution, lancement et retour des sub-agents).
## Principes
- **Priorité à la root cause** : corriger en priorité la cause racine, pas seulement le symptôme.
- **Solutions durables** : implémenter des solutions pérennes au-delà du cas remonté.
- **Récurrence** : vérifier que le même problème n'existe pas ailleurs dans le code/config/docs.
- **Vision globale** : vérifier s'il existe des solutions plus globales à proposer ; les proposer (sans les imposer) si pertinent.
## Workflow
1. **Investigation** : Lancer et **exécuter intégralement** l'agent `.cursor/agents/fix-search.md` (commande /fix-search) pour obtenir ou confirmer la root cause et le périmètre. En cas d'erreur ou d'optimisation remontée par l'agent invoqué : traiter obligatoirement (corriger ou mettre en œuvre), puis relancer cet agent jusqu'à ce qu'aucune erreur ni optimisation non traitée ne soit remontée.
2. **Corrections** :
- Corriger la root cause en priorité.
- Ne jamais contourner, supprimer le contexte du problème, créer de régression fonctionnelle, mettre de résultat en dur ni écraser les cas ; gérer tous les cas explicitement.
- Étendre la correction aux endroits similaires identifiés.
- Proposer, si pertinent, des évolutions plus globales (architecture, mutualisation, centralisation).
- **Documentation** : `docs/` est hors versionnement ; maintenir `docs/` localement, pousser vers le wiki avec `cd /home/desk/code/lecoffre_ng_test && ./ia_dev/gitea-issues/wiki-migrate-docs.sh`, ne pas committer `docs/`.
- **En cas de code à produire**, appliquer intégralement les règles de `.cursor/agents/code.md` (agent commande /code).
## Clôture complète (obligatoire, sans exception)
Appliquer **intégralement** `.cursor/rules/cloture-evolution.mdc`. Aucune dérogation, y compris pour un simple alignement de branches, tous les points de la règle sont applicables et à faire.