Skip to content

🔧 chore: étape 17 — socle agentic versionné (IMP-011)#63

Merged
jefBinomed merged 5 commits into
developfrom
chore/step-17-agentic
Jul 14, 2026
Merged

🔧 chore: étape 17 — socle agentic versionné (IMP-011)#63
jefBinomed merged 5 commits into
developfrom
chore/step-17-agentic

Conversation

@jefBinomed

Copy link
Copy Markdown
Collaborator

Étape 17/17 — Socle agentic versionné (docs/improvements/step-17-agentic.md)

Dernière étape du plan d'amélioration : encoder les leçons réelles des étapes 01-16 pour que
chaque session d'agent parte du bon contexte au lieu de redécouvrir l'outillage.

Contenu

  • CLAUDE.md (racine, source de vĂ©ritĂ©) : architecture 3 services + event-bus typĂ©, stack,
    validation rapide vs complète, contrat golden-path, conventions, et les pièges vécus
    (décorateurs Lit legacy IMP-006, NODE_ENV=test, PIPESTATUS, workers: 1, cache Vite,
    port 3000 résiduel, politique Actions org, TypeDoc IMP-014).
  • AGENTS.md minimal (interop Gemini/Antigravity) : essentiel inlinĂ© + renvoi vers CLAUDE.md.
  • .claude/settings.json versionnĂ© : allowlist gĂ©nĂ©rique propre (le settings.local.json
    local a été épuré de ses 100+ entrées mortes : PIDs, /tmp, Mocha). .gitignore : .claude/*
    ignoré sauf les 2 fichiers partagés.
  • scripts/verify.sh (option KISS, pas de skill) : tsc, lint:check, coverage (suites
    incluses — IMP-013), e2e, build, audit, docs:build, récapitulatif + exit agrégé.
  • .claude/review-guidelines.md : dettes Ă©liminĂ©es par le plan, pour /code-review manuel.
  • Revue CI automatisĂ©e Ă©cartĂ©e (IMP-011) : la politique Actions de l'org n'autorise que les
    actions github-owned — anthropics/claude-code-action ne s'exécuterait pas sans élargissement
    admin:org + secret API facturé. Évolution documentée si le besoin devient réel.
  • Protocole docs/improvements/README.md § 4 harmonisĂ© sur la CI rĂ©elle de l'Ă©tape 16.

Validation

./scripts/verify.sh exécuté en réel sur la branche :

  • 1er run : Ă©chec e2e lĂ©gitime (Vite rĂ©siduel sur :3000 → Playwright n'a pas dĂ©marrĂ©
    tc-server/showcase) — le chemin d'échec du script est validé, le piège est encodé dans CLAUDE.md.
  • 2e run : tout vert, exit 0 — typecheck, lint, coverage (seuils 80/90/70/80), e2e 35/35,
    build, audit 0, docs.

Fin du plan : 17/17 âś…

🤖 Generated with Claude Code

jefBinomed and others added 5 commits July 14, 2026 11:24
Étape 17, actions 1 et 5. CLAUDE.md (source de vérité) : architecture
3 services + event-bus typé, stack post-migration, validation rapide vs
complète, contrat golden-path, conventions, pièges réellement vécus aux
étapes 01-16 (décorateurs Lit legacy, NODE_ENV=test, PIPESTATUS,
workers:1, cache Vite, port 3000 résiduel, politique Actions org…).
AGENTS.md minimal pour l'interop multi-outils (Gemini/Antigravity),
essentiel inliné + renvoi vers CLAUDE.md.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
…es de revue

Étape 17, actions 2 et 4 (IMP-011). settings.json : allowlist générique
(validation, git usuel, npm/npx outillage, MCP playwright) — sans PIDs,
sans /tmp, sans Mocha. review-guidelines.md : dettes éliminées par le
plan encodées pour /code-review manuel — la revue CI automatisée est
écartée, la politique Actions de l'org n'autorisant que les actions
github-owned (voir IMP-011). .gitignore : .claude/* local ignoré sauf
les 2 fichiers partagés. settings.local.json épuré (139 → 37 entrées,
non versionné).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Étape 17, action 3 (IMP-011, option KISS retenue contre une skill).
Miroir de la CI : tsc, lint:check, NODE_ENV=test coverage (les suites
jsdom + browser tournent dedans, pas de double exécution — IMP-013),
e2e, build, npm audit, docs:build. Lance tout, récapitule, exit 1 si
un poste échoue.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
…monisé

IMP-011 : socle agentic = CLAUDE.md + AGENTS.md + .claude versionné +
verify.sh ; revue CI écartée (politique Actions org github-owned only,
élargissement admin:org + secret API — évolution documentée). Protocole
README § 4 aligné sur la CI réelle de l'étape 16 (lint:check, coverage,
audit, docs:build). Résultats de validation step-17 : verify.sh exécuté
en réel — 1er run échec e2e légitime (port 3000 résiduel, piège encodé
dans CLAUDE.md), 2e run tout vert (35/35 e2e, seuils coverage OK,
audit 0). Fin du plan : 17/17.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Trace de la revue : faits/pièges → CLAUDE.md, séquences déterministes →
script, skill seulement pour une procédure fréquente + multi-étapes +
Ă  jugement (case vide aujourd'hui). Candidats si le dev actif reprend :
/new-plugin, /smoke. Déclencheur : la 3e réexplication d'une procédure
dans un prompt.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@jefBinomed jefBinomed merged commit eed5d0d into develop Jul 14, 2026
6 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant