@supersoniks/concorde 4.9.2 → 4.9.4

package/README.md

@@ -28,7 +28,7 @@ yarn ai-init
 node node_modules/@supersoniks/concorde/scripts/ai-init.mjs
 ```
 
-Installe `.cursor/skills`, `.cursor/rules`, `.aiassistant/rules` et `AGENTS.md`. Voir [ai/README.md](ai/README.md).
+Installe `.cursor/skills`, `.cursor/rules`, `.aiassistant/rules`. `AGENTS.md` n’est créé que s’il est absent ; un fichier projet existant (sans marker Concorde) est laissé intact. Voir [ai/README.md](ai/README.md).
 
 ## 📁 Structure du projet
 
@@ -158,8 +158,8 @@ Le dépôt GitHub est un **export filtré** depuis GitLab (librairie uniquement
 Voir [CONTRIBUTING.md](CONTRIBUTING.md).
 
 **Résumé** :
-- **Équipe interne** : branche + Merge Request sur GitLab.
-- **Contributeurs externes** : issues sur [GitHub](https://github.com/supersoniks/concorde/issues) ; les PR directes sur le miroir GitHub ne sont pas mergées (le code est intégré via GitLab).
+- **Équipe interne** : branche + Merge Request sur GitLab interne.
+- **Contributeurs externes** : Un jour peut-être.
 
 ## 📄 Licence
 

package/ai/README.md

@@ -10,12 +10,36 @@ node node_modules/@supersoniks/concorde/scripts/ai-init.mjs
 
 Options :
 
-- `--overlay <dir>` — couche additionnelle (ex. kit starter)
-- `--merge-agents` — fusionne avec un `AGENTS.md` existant
+- `--overlay <dir>` — couche additionnelle (ex. kit starter) ; lit aussi `AGENTS.starter.md`
+- `--skip-agents` — n’écrit jamais `AGENTS.md` (skills / rules seulement)
+- `--merge-agents` — opt-in : conserve le préambule projet et ajoute / rafraîchit le bloc Concorde
+- `--force-agents` — opt-in : **remplace** tout `AGENTS.md` (destructif)
 - `--cursor-only` / `--jetbrains-only`
 
 Depuis le dépôt Concorde (dev) : `yarn ai-init`
 
+## Politique `AGENTS.md` (non invasive)
+
+| Situation | Comportement par défaut |
+|-----------|-------------------------|
+| Pas de `AGENTS.md` | Création du guide Concorde |
+| Fichier avec `<!-- concorde-ai -->` | Rafraîchit la zone gérée seulement |
+| Fichier **sans** marker (notes projet) | **Laissé intact** — skills / rules suffisent |
+| `--merge-agents` | Préambule projet + bloc Concorde après le marker |
+| `--force-agents` | Remplacement complet |
+| `--skip-agents` | Jamais d’écriture `AGENTS.md` |
+
+```text
+[optional project preamble — short, project-only]
+<!-- concorde-ai -->
+<package ai/AGENTS.md>
+[--- + overlay AGENTS.starter.md]
+```
+
+- Tout **après** `<!-- concorde-ai -->` est **régénéré** à chaque run (pas d’empilement).
+- Ne pas recopier le guide Concorde dans le préambule : notes projet → `overlay/AGENTS.starter.md`.
+- Si le préambule duplique `ai/AGENTS.md`, `ai-init` le **allège / drop** et affiche un warning.
+
 ## Contenu
 
 | Dossier | Cible |
@@ -23,8 +47,14 @@ Depuis le dépôt Concorde (dev) : `yarn ai-init`
 | `skills/` | `.cursor/skills/` (concorde, imports, scope, theme, menu) |
 | `cursor/rules/` | `.cursor/rules/` |
 | `jetbrains/rules/` | `.aiassistant/rules/` |
-| `AGENTS.md` | racine du projet |
+| `AGENTS.md` | racine du projet **seulement** si absent, déjà marqué, ou via `--merge-agents` / `--force-agents` |
 
 ## Template starter
 
 Le package `create-concorde-ts-starter` ajoute un overlay via `yarn ai:sync`.
+
+## Tests
+
+```bash
+node --test scripts/ai-init.test.mjs
+```

package/build-infos.json

@@ -1 +1 @@
-{"date":1783418291}
+{"date":1785400304}