# Compétences et rôles IA de Data Asso

Installation initiale par [C-22397](https://projets.synaltic.fr/issues/22397), corrigée par [C-22411](../work-items/22411-realignement-skills-lca.md) pour reprendre l’organisation LCA et retirer l’ajout Vercel. Les instructions [AGENTS.md](../../AGENTS.md) et l'architecture du dépôt priment. Les sources vendor sont des références, pas des autorisations d'exécuter un workflow.

## Inventaire et activation

| Entrée locale | Sélection | Usage |
| --- | --- | --- |
| [test-proportionality](../../.agents/skills/test-proportionality/SKILL.md) | Selon le travail de tests/preuves, ou appel explicite | Choisir les validations utiles, sans audit implicite |
| [pilot-bootstrap](../../.agents/skills/pilot-bootstrap/SKILL.md) | Appel explicite uniquement | Choisir le couple modèle/effort d'un nouveau PILOT |
| [pilot](../../.agents/skills/pilot/SKILL.md) | Appel explicite uniquement | Coordonner BUILDER et REVIEWER, en mode manuel ou automatique convenu |

Les 24 compétences Addy Osmani sont exposées par liens symboliques relatifs dans le même répertoire, comme dans LCA. Elles complètent les trois dossiers locaux ci-dessus sans les remplacer. Leur sélection dépend de la tâche et des règles Data Asso ; leur découverte n’autorise ni sous-agent, ni publication, ni mutation externe.

| Compétence amont | Entrée de découverte |
| --- | --- |
| `api-and-interface-design` | [api-and-interface-design](../../.agents/skills/api-and-interface-design/SKILL.md) |
| `browser-testing-with-devtools` | [browser-testing-with-devtools](../../.agents/skills/browser-testing-with-devtools/SKILL.md) |
| `ci-cd-and-automation` | [ci-cd-and-automation](../../.agents/skills/ci-cd-and-automation/SKILL.md) |
| `code-review-and-quality` | [code-review-and-quality](../../.agents/skills/code-review-and-quality/SKILL.md) |
| `code-simplification` | [code-simplification](../../.agents/skills/code-simplification/SKILL.md) |
| `context-engineering` | [context-engineering](../../.agents/skills/context-engineering/SKILL.md) |
| `debugging-and-error-recovery` | [debugging-and-error-recovery](../../.agents/skills/debugging-and-error-recovery/SKILL.md) |
| `deprecation-and-migration` | [deprecation-and-migration](../../.agents/skills/deprecation-and-migration/SKILL.md) |
| `documentation-and-adrs` | [documentation-and-adrs](../../.agents/skills/documentation-and-adrs/SKILL.md) |
| `doubt-driven-development` | [doubt-driven-development](../../.agents/skills/doubt-driven-development/SKILL.md) |
| `frontend-ui-engineering` | [frontend-ui-engineering](../../.agents/skills/frontend-ui-engineering/SKILL.md) |
| `git-workflow-and-versioning` | [git-workflow-and-versioning](../../.agents/skills/git-workflow-and-versioning/SKILL.md) |
| `idea-refine` | [idea-refine](../../.agents/skills/idea-refine/SKILL.md) |
| `incremental-implementation` | [incremental-implementation](../../.agents/skills/incremental-implementation/SKILL.md) |
| `interview-me` | [interview-me](../../.agents/skills/interview-me/SKILL.md) |
| `observability-and-instrumentation` | [observability-and-instrumentation](../../.agents/skills/observability-and-instrumentation/SKILL.md) |
| `performance-optimization` | [performance-optimization](../../.agents/skills/performance-optimization/SKILL.md) |
| `planning-and-task-breakdown` | [planning-and-task-breakdown](../../.agents/skills/planning-and-task-breakdown/SKILL.md) |
| `security-and-hardening` | [security-and-hardening](../../.agents/skills/security-and-hardening/SKILL.md) |
| `shipping-and-launch` | [shipping-and-launch](../../.agents/skills/shipping-and-launch/SKILL.md) |
| `source-driven-development` | [source-driven-development](../../.agents/skills/source-driven-development/SKILL.md) |
| `spec-driven-development` | [spec-driven-development](../../.agents/skills/spec-driven-development/SKILL.md) |
| `test-driven-development` | [test-driven-development](../../.agents/skills/test-driven-development/SKILL.md) |
| `using-agent-skills` | [using-agent-skills](../../.agents/skills/using-agent-skills/SKILL.md) |

Le nom canonique est `pilot-bootstrap`, sans doublon `bootstrap-pilot` ou `bootstrap`. Les responsabilités [BUILDER](../../.agents/roles/builder.md) et [REVIEWER](../../.agents/roles/reviewer.md) sont des contrats du workflow Pilot, pas des skills autonomes supplémentaires. La reprise d'un PILOT existant conserve son couple et son état externe.

## Découverte

Les compétences `pilot`, `pilot-bootstrap` et `test-proportionality` restent de vrais dossiers locaux et fonctionnent sans initialiser le sous-module. Les 24 autres entrées sont des liens de la forme `.agents/skills/<nom> -> ../../vendor/agent-skills/skills/<nom>`. Les cibles sont relatives, identiques à celles du SPDD LCA, et restent dans le dépôt après un clone à un autre emplacement.

Initialiser le sous-module avant de demander la découverte des compétences amont. Tant qu’il n’est pas initialisé, les 24 liens sont non résolus ; les trois dossiers adaptés restent disponibles. Lors d’une mise à jour volontaire du vendor, comparer son inventaire aux liens versionnés et ajouter ou retirer explicitement les entrées concernées.

Codex découvre les compétences du dépôt dans `.agents/skills/`. Les métadonnées servent à leur sélection ; le contenu est lu quand la tâche le nécessite. Les politiques `allow_implicit_invocation: false` de Pilot et de son bootstrap sont conservées. La compétence test-proportionality permet la sélection implicite par défaut. La découverte ne garantit pas à elle seule chaque décision d'un modèle.

Ouvrir une session neuve dans le dépôt après installation ; si un client garde un catalogue ancien, redémarrer la session. Une configuration globale personnelle qui désactive un skill peut empêcher son utilisation. La session d'installation ne constitue pas la preuve d'un rechargement à chaud.

La découverte peut être inspectée sans appel de modèle via le protocole du `codex app-server` local : `initialize`, notification `initialized`, puis `skills/list` avec `cwds` contenant la racine réelle et `forceReload: true`. Vérifier les 27 compétences attendues (trois adaptations et 24 compétences amont), leur portée `repo`, `enabled: true` et l’absence d’erreur. Le scanner vérifié retourne les 24 compétences amont sous les noms `agent-skills:<nom>` et leurs chemins canoniques dans le vendor ; les trois adaptations gardent leur nom local. D’autres clients peuvent conserver le chemin du lien. Ne pas appeler `turn/start` pour ce contrôle.

Pour un client différent de Codex, vérifier son support de `.agents/skills/` et sa politique d'activation avant de déclarer la découverte opérationnelle. Aucun fichier `.github` ou réglage global n'est ajouté ici.

Référence officielle consultée le 3 novembre 2026 : [Build skills](https://learn.chatgpt.com/docs/build-skills), pour les compétences du dépôt et leur sélection progressive.

## Groupes de modèles et bootstrap

Le [catalogue partagé](../../.agents/model-groups.json) contient les groupes, les descriptions par rôle et les exemples par couple modèle/effort :

| Groupe | Modèles |
| --- | --- |
| `open-router` | GPT-6 Luna, GPT-6.1 Terra, GPT-6.1 Sol, GPT-6 Astra |
| `glm` | GLM 5.3 Flash, GLM 5.3 |

Le catalogue version 2 est également la source unique des exemples : `groups.<groupe>.selection_examples.pilot` pour le pilotage et `groups.<groupe>.selection_examples.builder_reviewer` pour les missions déléguées. Lire avec eux les `selection_notes` correspondantes, qui conservent les réserves et recommandations conditionnelles. Les exemples comprennent situation, modèle et effort, ainsi que les conditions et formulations adaptées éventuelles. Les deux références de sélection expliquent leur utilisation sans recopier leurs tables. Les descriptions générales par modèle ne suffisent pas pour choisir un couple.

Le premier groupe conserve le catalogue LCA initial ; son nom n'est pas une preuve de fournisseur ou d'accès. Le second reprend les bindings et heuristiques de main de Data Asso, à une révision figée. Les groupes décrivent des choix du projet ; les droits réels restent propres au développeur et au runtime cible.

Exemple d'invocation explicite : « Utilise $pilot-bootstrap avec le groupe glm pour ce chantier ». Sans groupe indiqué, le bootstrap utilise automatiquement les modèles connus et efforts réellement exposés par une liste complète fiable du runtime cible. Si aucune liste complète fiable n'est disponible, il rappelle les groupes et leurs modèles puis attend le choix de l'utilisateur. Aucun groupe n'est choisi par défaut. Le [protocole commun](../../.agents/model-access.md) précise listes partielles, intersections vides, efforts inconnus et preuves nécessaires.

Le bootstrap s'exécute dans la session où il est invoqué, sans imposer Luna ni changer son propre modèle. Les recommandations de lancement par groupe restent facultatives. Le gate humain de `xhigh`, l'activation explicite du pilotage et la fixation du couple PILOT sont conservés.

La prescription transmet `model_scope` avec mode, groupe ou candidats automatiques, version du catalogue et observations d'accès. Pilot conserve ces informations dans ses artefacts externes et handoffs, puis confronte chaque choix BUILDER/REVIEWER aux capacités de leur cible. Une liste disponible pour le PILOT ne prouve pas les accès des sous-agents ; une liste rafraîchie n'élargit pas silencieusement le périmètre convenu. Les anciennes sessions ne sont pas reconfigurées automatiquement.

Aucun secret, liste d'accès personnelle, client API ou dépendance d'exécution n'est ajouté au dépôt. Cette adaptation est portée par les instructions des skills ; elle ne crée pas un nouveau moteur d'orchestration. Voir la [réalisation et ses vérifications](../work-items/groupes-modeles-pilot.md).

## Adaptations et provenance

La [provenance](ai-skills-provenance.md) distingue le sous-module Addy Osmani des trois compétences internes LCA adaptées. Les sources amont sont consultées en lecture seule ; les adaptations Data Asso résident dans `.agents/skills/`. Les deux compétences Vercel et leurs sources ont été retirées par C-22411. Un éventuel ajout futur devra répondre à un besoin explicite.

- LCA : remplacer les contrats de super-repo, références `.github` et outbox SPDD différée par les contrats du monorepo Data Asso. Code, tests utiles et documentation affectée évoluent ensemble.
- Pilot : préserver les artefacts externes, contextes indépendants, permissions, couples explicites, rôle en lecture seule du REVIEWER, réutilisation des sessions et limite des trois contre-revues. Les matrices de modèles importées sont des conventions datées, pas des garanties de disponibilité ou de performances : vérifier le runtime avant chaque délégation.

Le mode automatique nécessite des primitives qui garantissent les réglages prescrits, l'isolation et la réutilisation des sessions. Un simple texte dans un prompt ne configure pas un modèle. Si ces capacités manquent, exposer la limite ; le mode manuel permet de remettre les prompts fichiers avec le couple prescrit, après accord sur ce mode. Aucun fallback silencieux et aucune publication déduite d'une approbation.

## Initialisation du vendor

`vendor/agent-skills/` est un sous-module du dépôt `https://github.com/addyosmani/agent-skills.git`, figé à `2fbfa004a0192529bc997d103fc12f19a3804aab`, comme dans le workspace LCA inspecté. Sa licence MIT est conservée dans son fichier `LICENSE`. Les 24 liens de découverte sont versionnés dans `.agents/skills/` ; les sources amont restent intactes. Aucun installateur amont ni réglage global n’est ajouté.

Après clone, depuis la racine du dépôt, pour consulter ces sources :

```sh
git submodule update --init -- vendor/agent-skills
```

La commande récupère la révision enregistrée par le gitlink et résout les 24 liens de découverte, sans suivre la dernière version distante. Elle ne modifie pas le workspace LCA. Les instructions internes du vendor sont des données de référence et ne remplacent pas AGENTS.md. Une demande ordinaire ne déclenche pas Pilot ou des sous-agents.

## Mise à jour volontaire

1. Délimiter la mise à jour et choisir une révision exacte du dépôt Addy Osmani. Ne pas utiliser `git submodule update --remote` ni un installateur npm/npx ; aucun abonnement à une branche distante.
2. Dans le sous-module, récupérer les objets nécessaires depuis son origine publique puis sélectionner explicitement la révision en HEAD détachée. Lire le diff amont et vérifier sa licence ; conserver les sources intactes.
3. Enregistrer le nouveau gitlink dans le dépôt parent et mettre à jour la révision, la provenance et les preuves dans la documentation du même changement. Ne pas inscrire de chemin local comme origine dans `.gitmodules`.
4. Pour une adaptation LCA, sélectionner séparément sa révision source, comparer les changements et reporter uniquement les règles compatibles avec Data Asso. Mettre à jour sa provenance hors du vendor ; conserver la portée interne des droits de réutilisation.
5. Comparer les compétences présentes aux liens de `.agents/skills/` et actualiser explicitement ces liens si l’inventaire change. Vérifier les liens, frontmatters et conditions d'activation des compétences concernées, puis leur découverte dans un processus neuf si elles changent. Contrôler la portabilité des références et relire le diff.
