TODO

README.md overhaul

Plan
Corriger section install ctx7 (retirer MCP, clarifier CLI + API key)
Marquer ruflo comme désactivé
Supprimer section Troubleshooting/bugs courants
Simplifier stacks tierces (gstack, ruflo, ctx7, GSD) — juste description + lien
Ajouter section skills personnels (skills-perso)
Ajouter section système d'autogestion (plugin-advisor, tokens, synergies)
Nettoyer section Updating (retirer instructions manuelles par outil)
Nettoyer section Maintenance (retirer doublon updating)
Mettre à jour table Plugins reference (ctx7 row, ruflo OFF)
Corriger lien USAGE.md dans l'intro (retirer mention cas/erreurs)

USAGE.md cleanup

Supprimer tous les "Cas de figure — corrections vX.X.X validées"
Supprimer table "Erreurs fréquentes"
Corriger /readme → /doc dans bonnes pratiques
Supprimer séparateurs orphelins

Skill /doc

Mettre à jour doc-syncer.md pour gérer ajouts/suppressions de features
Mettre à jour SKILL.md description pour mentionner feature delta

Auto-activation ui-ux-pro-max sur détection design

Créer lib/design-gate.md — snippet réutilisable (detect design signals + ask to activate ui-ux-pro-max)
Intégrer dans feater.md — STEP 0.5 entre scope check et mini-plan
Intégrer dans hotfixer.md — STEP 1.5 (si CSS/style/animation)
Intégrer dans bugfixer.md — STEP 1.5 (si bug UI/style)
Mettre à jour plugin-advisor.md — PHASE 4 : cohérence avec le design gate
Mettre à jour CLAUDE.md skill routing — documenter le comportement auto

Refonte agents/seo-analyzer.md

Lire agent actuel + plugin-advisor + interviewer + feater + hotfixer + analyzer
Réécrire l'agent complet v1 (11 étapes)
Ajouter orchestration sub-agents (hotfixer/feater) + triage par batches
Déplacer plugin-advisor après détection stack (STEP 3 au lieu de STEP 0)
Ajouter 2 niveaux d'audit (LOCAL code-only / FULL live+externe)
Adapter scoring, legal, GEO aux deux niveaux
Renumeroter proprement (0-14) + corriger toutes les refs internes
Commit

/onboard — cso archetype-aware

Problème : prompt cso fallback est non-adaptatif — cherche XSS/SQLi/CORS même sur firmware. Objectif : charger ## Typical pain points + Surface sécurité de l'archétype et les injecter dans le prompt cso.

STEP 4.5 → ajouter extraction de archetype-context.md (pain points + Surface sécurité + category) — validé sur firmware-embedded / nextjs-app-router / library
STEP 6 dispatch cso fallback → re-écrire prompt : universal checks + sections conditionnelles par category (web / embedded / library / cli / infra / data / desktop)
STEP 6 dispatch cso gstack ON → passer --archetype <name> --context-file .onboard-audit/archetype-context.md dans args
OUT-OF-SCOPE ce fix : étendre le pattern à analyze/code-clean/doc (déjà reçoivent ARCHETYPE: <name>, juste pas le context-file). À faire dans un 2e passage si besoin.

/validate — nouveau skill W3C + WCAG (option A)

Scope : W3C HTML validity (validator.nu API) + W3C CSS validity (jigsaw API) + WCAG a11y (axe-core CLI / pa11y / WAVE API / fallback statique). Même pattern que /harden (audit par défaut, --fix avec confirmation A/B/C/D). Rapport = VALIDATE.md racine. Complémentaire à /onboard (qui audite a11y au setup initial — /validate est l'outil on-demand réutilisable).

Design décisions :

Agent dédié : agents/validator-analyzer.md (nouveau). Pas de réutilisation de seo-analyzer — scope différent (validité syntaxique vs indexabilité).
Depth : LOCAL (fichiers HTML/CSS statiques, tools npm locaux si dispo) | FULL (URL live + APIs distantes W3C/WAVE).
External validators : validator.nu/?out=json (HTML), jigsaw.w3.org/css-validator (CSS), WAVE API optionnelle (quota gratuit ~100/mois), axe-cli local, pa11y-cli local.
Tools fallback order : npm tools locaux → APIs distantes → agent général statique (cas onboard). Aucun install forcé.
--fix conservateur : alt="" sur images décoratives évidentes, lang sur <html>, fermetures de tags manquantes, sauts de niveau heading renumérotés. PAS : labels forms, contraste couleurs, landmarks (demandent décision humaine).
Out of scope : meta tags/SEO → /seo ; JSON-LD → /geo ; security headers → /harden ; code linting générique (ESLint/Prettier) → hors scope web standards.

Subtasks :

Créer agents/validator-analyzer.md — spec 6 étapes (478 lignes)
Créer skills/validate/SKILL.md — dispatcher (378 lignes)
Ajouter routage /validate dans ~/.claude/CLAUDE.md section "Skill routing"
Mettre à jour skills/harden/SKILL.md — W3C/a11y redirigé vers /validate
Mettre à jour skills/seo/SKILL.md — cross-ref /validate pour W3C/WCAG
Grep cohérence : refs /validate correctes, skill détecté par la harness

Helper `--help` / `help` sur tous les skills (option C)

Problème : aucun skill ne gère --help aujourd'hui. argument-hint affiche juste la syntaxe en autocomplétion, pas de description/exemples. L'utilisateur doit lire le SKILL.md ou deviner.

Objectif : /<skill> --help (ou /<skill> help) affiche un bloc standardisé (description, args, exemples, cross-refs) et exit SANS dispatcher l'agent ni modifier quoi que ce soit.

Design :

Lib partagée : créer skills/lib/help-handler.md — snippet réutilisable "if $ARGUMENTS contains --help|help|-h, extract frontmatter fields (description, argument-hint, cross-refs) + afficher bloc d'aide standardisé + STOP".

Format d'aide standardisé :

/<skill> — <titre court>

DESCRIPTION
<extrait de la frontmatter description, dépouillé des Triggers>

USAGE
/<skill> <argument-hint>

ARGUMENTS
<liste détaillée de chaque flag avec son effet — nouvelle section
 dans les SKILL.md, ou parsée depuis STEP 0 arg parsing>

EXAMPLES
<3-4 exemples concrets>

SEE ALSO
<extrait des "For X → use /Y" de la frontmatter>

Intégration : ajouter STEP 0.5 ("Handle --help") dans chaque SKILL.md juste après STEP 0 parsing args. Ordre : parse args → check --help → si oui afficher + exit → sinon continuer.
Skills à patcher : ~/Documents/claude/skills/ = ~20 skills persos + skills-perso list pour référence. Ne PAS toucher skills-external/gstack (ownership externe) ni example-skills.