claude/.claude/tasks/TODO.md

TODO

profile.sh — verbe gstack on|off

• Extraire helper enable_all_gstack() (boucle de cmd_reset) — anti-duplication
• Extraire helper disable_gstack_not_in(prof) (boucle gstack de cmd_set) — anti-duplication
• Extraire helper parked_gstack_count() (réutilise pattern cmd_current)
• Refactor cmd_reset + cmd_set pour utiliser les helpers (comportement préservé)
• cmd_gstack() : on = enable tout gstack (garde label active-profile), off = disable gstack hors profil actif
• Wire main() dispatch gstack) + usage() + bloc header
• Doc : SKILL.md argument-hint + exemples + output-policy (Makefile générique suffit)
• shellcheck propre + tests (help/bad-action/none-error/on/off cycle) — état live restauré exact
• Investigué "fix" full.profile : PAS un bug — curation par design (BDR-017 caveat). Aucun fix code.
• FOLLOW-UP (BLK-007 résolu) : linké spec (symlink chirurgical) + ajouté à full/web-full ; iOS NON linké (Linux, besoin Mac+Tailscale) ; .gitignore allowlist gstack complété (12 ajouts + checkpoint stale retiré) → gstack on git-clean ; LRN-025 capitalisé
• Capitalize : BDR-018, LRN-024, BLK-007, EVAL-002, journal 2026-06-02 + backfill index (BDR-017, BLK-005/006)

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

Animation lib (motion) — install + détection

Problème : motion (ex-framer-motion, rebrandé nov 2024) n'est ni installé par les scripts ni détecté par plugin-advisor / design-gate. Ajouter détection + install conditionnel.

Décisions :

• Package : motion (npm motion, import motion/react). motion-v pour Vue 3 (package séparé). Svelte/vanilla → motion.
• Éligibilité : tout projet qui peut consommer l'API. ✅ React/Next/Remix/Astro+React, Vue3/Nuxt, Svelte. ❌ Backend, CLI, embedded, Flutter, WordPress/Drupal/Strapi, RN (réservé react-native-reanimated).
• init-project STEP 5 : auto-install si éligible + absent (l'utilisateur a déjà validé scaffold).
• onboard STEP 2.5 : propose + attendre OK (projet existant, opt-in).
• plugin-advisor : read-only — détecte + reporte ("✅ motion installed" ou "ℹ️ eligible but absent — run /onboard").
• design-gate : ajouter motion/motion-v/framer-motion (legacy) dans filesystem signals.

Subtasks :

• Créer lib/animation-lib-check.sh — fonctions detect_anim_eligibility() + is_anim_lib_installed() + recommend_anim_install_cmd()
• Patcher agents/scaffolder.md PHASE 4 — note (le scaffolder n'installe PAS, l'orchestrateur init-project STEP 5e gère)
• Patcher skills/init-project/SKILL.md — STEP 5e ANIMATION LIB (auto-install si éligible)
• Patcher skills/onboard/SKILL.md — STEP 2.5 ANIMATION LIB (propose + attendre yes/skip)
• Patcher agents/plugin-advisor.md PHASE 1 (sourcing du helper) + PHASE 2 (signaux anim-lib-eligible/anim-lib-installed) + PHASE 3 (section ANIMATION LIB read-only)
• Patcher lib/design-gate.md — ajouter motion/motion-v/framer-motion + autres anim-libs dans filesystem signals
• Tester : shellcheck OK ; matrix React/Vue/RN/backend/with-motion/no-package/pnpm tous corrects

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.

Subtasks :

• Créer skills/lib/help-handler.md — snippet réutilisable (détection + extraction + affichage)
• Définir format d'aide standard + section "ARGUMENTS" vs reuse de argument-hint
• Décider : sections ARGUMENTS/EXAMPLES doivent-elles être dans la frontmatter (nouveau champ YAML) ou dans le corps du SKILL.md (nouvelle section ## Help) ?
• Patcher un skill pilote (/validate) — valider UX
• Patcher les skills perso restants : analyze, bugfix, code-clean, commit-change, doc, feat, geo, graphify, harden, hotfix, init-project, make-pdf, onboard, plan-tune, plugin-check, refactor, seo, ship-feature, skills-perso, status, benchmark-models, context-save, context-restore
• Mettre à jour ~/.claude/CLAUDE.md — mentionner convention --help disponible sur tous les skills perso
• Note : skills-external/gstack ont leur propre convention, ne pas toucher

Skill profiles (partition gstack par usage)

• Plan
• lib/profile.sh — list/show/current/apply/set/reset/diff via symlink toggle
• lib/profiles/{design,dev,qa,audit,minimal}.profile — 5 profils
• skills/profile/SKILL.md — slash command /profile
• Wire agents/plugin-advisor.md — DETECT call profile.sh current + OUTPUT line PROFILE + nouvelle section "Skill profiles" dans TOGGLING EXTERNAL TOOLS
• Wire lib/toggle-external.sh — header pointer vers profile.sh
• Makefile — targets profile/profile-list/profile-current/profile-reset
• Tests : list/show/current/diff/set/reset/apply tous OK, shellcheck propre, symlinks bien restaurés après reset

Profile system v2 — extension plugins/MCPs/CLIs

• Inventaire complet : 7 plugins (4 ON / 3 OFF), 0 MCP local, 4 CLIs installés
• Définir MANAGED_PLUGINS (ui-ux-pro-max, plugin-dev, pr-review-toolkit) + PROTECTED_PLUGINS (caveman, security-guidance, superpowers)
• profile.sh étendu : nouveau type plugin@<marketplace> (auto-toggle via claude plugin enable/disable), mcp (delegate à toggle-external.sh pour magic), cli (advisory only)
• cmd_set désactive aussi les MANAGED_PLUGINS hors profil
• cmd_reset ne touche PAS aux plugins (info line explicite — re-enable manuel ou via apply)
• cmd_current : compte enabled + installed, tiebreaker = total le plus grand
• cmd_show : colonne TYPE élargie à 30 chars pour plugin@ui-ux-pro-max-skill
• 4 nouveaux profils : web, seo, web-full, backend
• Profils existants raffinés (design, dev, qa, audit) avec plugin@<marketplace> + cli
• skills/profile/SKILL.md : table profils mise à jour + table mécanisme par type
• agents/plugin-advisor.md : table de recommandations étendue avec web/seo/web-full/backend
• Tests : set web enable ui-ux-pro-max+magic, set seo disable ui-ux-pro-max, set minimal épargne always-on, reset restaure 64 skills
• Memoire : BDR-008 (v2 décision) + journal entry 2026-05-04
• Shellcheck propre

/audit-delta — skill audit incrémental multi-axes (2026-06-11)

But : 1 skill, 4 axes cochables (conformité CLAUDE.md, erreurs/améliorations, code mort, sécurité), scope = diff depuis dernier run (marqueur SHA persistant, par axe), boucle par axe : audit → gate approbation → fix → re-vérification obligatoire avant axe suivant. Construit via superpowers:writing-skills (TDD).

• RED : baseline subagent sans skill (worktree isolé) — 7 gaps documentés (boundary par date de fichier, checkpoint en prose, pas de marqueur par axe, zéro gate, lint=verify, passe unique mélangée, registres auto-écrits)
• GREEN : skills/audit-delta/SKILL.md — pass sous pression (state file utilisé, gate tenu malgré "fix tout + meeting", marqueurs par axe OK)
• REFACTOR : trou trouvé (premier run + user injoignable, aucune règle) → patch : défaut full codebase report-only, jamais "from HEAD" ; re-test pass
• Vérif finale : skill découvrable (~/.claude/skills/audit-delta via symlink skills/), frontmatter valide, worktrees de test nettoyés
• Capitalize : BDR-020 + LRN-027 + journal 2026-06-11
• Commit (via /commit-change quand prêt)

2026-06-11 — darwin eval: 4 confirmed bugs fix (branch auto-optimize/*-bugfixes)

• geo-analyzer.md: unreachable user → ALL file fixes report-only (STEP 12/13 triage gate)
• init-project SKILL.md: repoint readme-updater.md (absent) → doc-syncer.md x2
• analyzer.md: resolve "Update project memory" vs "Do not modify files" contradiction
• onboard SKILL.md: allowed-tools += Agent, Skill (workflow STEPs 5-7 need them)
• re-test geo fixture (unreachable) → expect zero source edits; 2 blind judges on geo-analyzer diff
• commit per fix, results.tsv rows, merge if green

2026-06-19 — cleanup/caveman-always-on (full plugin purge)

Goal: disable caveman plugin + delete every repo dep on it. Plugin.json self-declares always-on hooks → "enabled w/o always-on" impossible → full purge. Keep memory-registry terse-format rule (separate subsystem); only replace dead /caveman:compress cmd refs w/ "Legacy entries (pre-format-rule): compress manually or via claude.ai on demand." Version 3.4.0 → 3.5.0.

• RUNTIME (user, no TTY): plugin disable + uninstall caveman@caveman; mcp list check
• PHASE 2: settings.json (2 hook blocks + enabledPlugins + marketplace); hooks/ files delete; .gitignore block; session-start.sh L134
• PHASE 3: install-plugins.sh STEP 5.5; update-all.sh block; plugins.lock.json; doctor.sh; lib/detect-plugins.sh; lib/profile.sh; plugin-advisor.md; skills/profile/SKILL.md
• PHASE 4: README row; USAGE always-on line; CHANGELOG; CLAUDE.md cmd ref; skills/capitalize+prune-memory cmd refs; version.txt
• PHASE 5: shellcheck clean (SC1091 info only); full diff reviewed → committed + merged to master