docs(framework): fiabiliser les descriptions des skills sous troncature Codex

Problem

Codex affiche le message suivant dans une session où les plugins AIDD sont activés :

⚠ Skill descriptions were shortened to fit the skills context budget. Codex can still see every
skill, but some descriptions are shorter. Disable unused skills or plugins to leave more room
for the rest.

Il s'agit d'un avertissement de budget global, pas d'une erreur de chargement des skills. Les descriptions raccourcies peuvent toutefois perdre leurs déclencheurs et limites de périmètre, ce qui fragilise la sélection implicite.

Audit du 8 septembre 2026 : 48 descriptions dans plugins/*/skills/*/SKILL.md, entre 168 et 267 caractères, médiane 224, total 10 585 caractères hors noms et chemins. Les trois descriptions AIDD Telemetry ont aussi été consultées dans le plugin installé en version 0.1.0 ; ce plugin est absent du checkout audité. Ces mesures ne prouvent pas qu'AIDD est seul responsable de l'avertissement : d'autres skills sont chargés dans la session.

Scope

Acceptance criteria

• Chaque ligne du tableau est traitée ou explicitement justifiée avec sa source.
• Les descriptions corrigées restent fidèles aux routes et limites réelles des skills.
• Des prompts positifs et négatifs vérifient la sélection des skills concernés avec descriptions complètes et raccourcies ; la méthode de raccourcissement utilisée est documentée.
• Une simple demande de liste de tâches ne sélectionne pas 10-todo ; une demande générique de recherche ne sélectionne pas 12-cook sans contexte de recette.
• 08-three-amigos exprime deux routes alternatives ; 09-for-sure ne promet plus une réussite garantie.
• R3 et le template restent cohérents, sans règle dupliquée ni seuil arbitraire présenté comme une limite universelle de Codex.
• Un essai après rechargement dans Codex documente les descriptions visibles et la présence ou l'absence de l'avertissement. Sa disparition n'est pas obligatoire si les autres skills chargés dépassent encore le budget global.

Prior art in this repo

• plugins/aidd-context/skills/04-skill-generate/references/skill-authoring.md:9 : R3 définit déjà le contrat des descriptions, dont la cible d'environ 240 caractères et l'absence de commande nommée.
• plugins/aidd-context/skills/04-skill-generate/assets/skill-template.md:3 : template actuel de description.
• plugins/aidd-pm/skills/08-three-amigos/SKILL.md : deux routes et règle « Run one route per invocation ».
• Documentation officielle OpenAI : budget de la liste initiale, raccourcissement des descriptions et recommandation de placer cas d'usage et déclencheurs au début. Le corps complet du skill reste lu lorsqu'il est sélectionné.

Out of scope

• Modifier le budget interne de Codex ou garantir la disparition de l'avertissement pour toute configuration.
• Désinstaller ou désactiver les plugins de l'utilisateur.
• Réécrire les workflows ou modifier directement le cache des plugins installés.
• Corriger les descriptions des plugins tiers.