Skip to content

Doc agent — le dépôt est la seule source de vérité (étape 2 de la sortie d'atelier) - #3

Merged
aplds merged 1 commit into
devfrom
vibe/sortie-atelier-doc-agent
Oct 24, 2026
Merged

aplds merged 1 commit into
devfrom
vibe/sortie-atelier-doc-agent

Conversation

@aplds

@aplds aplds commented Oct 24, 2026

Copy link
Copy Markdown
Owner

Résumé

Étape 2 du plan src/docs/SORTIE-ATELIER.md : la doc agent dit le nouveau monde. L'atelier Perchance et son harnais de vérification sans Node disparaissent des consignes ; le dépôt git (branche dev) est la seule source de vérité.

  • AGENTS.md : nouvelle section « Comment on livre — le dépôt est la source de vérité » (branche dev, une branche par sujet, une PR par sujet vers dev, CI verte avant relecture, trace changelog + APP_VERSION) ; les références à ATELIER.md, au harnais et au flux atelier ↔ dépôt sont retirées ; les garde-fous sont renumérotés.
  • CLAUDE.md : la référence atelier retirée ; le fichier renvoie à AGENTS.md.
  • src/README.md : « Flux de travail : Perchance ↔ GitHub » → « Flux de travail — le dépôt est la source de vérité » ; les recettes d'export et la table de l'export remplacées par une section « Disposition des fichiers » ; l'arborescence et les pièges ne parlent plus de l'atelier (le harnais de navigateur, Playwright, est explicitement distingué).
  • tests/README.md : la section « Les jouer dans l'atelier » supprimée.
  • src/docs/INDUSTRIALISATION.md : la section « Vérifier depuis l'atelier : le harnais » supprimée ; les références à l'export, à ATELIER.md et à GITHUB.md retirées.
  • src/docs/REPRISE.md : le manifeste main.pjs décrit sans Perchance ; la table d'export remplacée par un renvoi à « Disposition des fichiers ».
  • README.md (racine) : le paragraphe « S'il travaille dans l'atelier (l'édition en ligne…) » supprimé ; le renvoi à la table de l'export corrigé.

Piège nommé respecté : le mot « atelier » reste pour l'écran interne de l'application (?atelier, /atelier, demandeAtelier, SCRIBA_ATELIER_IPS, location /atelier dans nginx) — aucune de ces lignes n'est touchée.

Trace : changelog 1.6.3v (2026-10-24), APP_VERSION = "1.6.3v" / APP_RELEASED = "2026-10-24", logiciel-engendre.mjs régénéré, statut du plan mis à jour.

Vérification

  • npm run syntaxe : 257 fichiers, 0 faute
  • npm run style (strict) : 257 fichiers, 0 remarque
  • node --test tests/*.test.mjs : 152 pass, 0 fail, 2 skipped
  • npm test --prefix src/server/mysql : 333 pass, 0 fail
  • node --test src/server/mysql/logiciel-engendre.test.mjs : 4/4 (miroir engendré conforme)

npm run verifier en un seul bloc échoue dans ce bac à sable pour une raison préexistante (confirmée sur dev propre par git stash) : le dossier ./src/server/charge/ n'existe pas dans ce clone et mysql2 n'est pas installé — la CI installe mysql2 (npm ci --prefix src/server/mysql) et passe. Les quatre parties ci-dessus couvrent le même périmètre.

Hors périmètre (volontairement)

  • Suppression de main.pjs, scripts/harnais-atelier.mjs, src/docs/ATELIER.md → étape 3
  • Mentions restantes dans src/ui/views/docs.js, index.html, src/LICENSE.md, src/TODO.md, commentaires de scripts/*.mjs et ci.yml, src/SPEC.md, src/docs/ADMINISTRATION.md → étape 3 ou décision ultérieure (voir l'inventaire de l'étape 1)
  • Le changelog historique garde ses entrées passées telles quelles.

…érité

Étape 2 du plan de sortie d'atelier (src/docs/SORTIE-ATELIER.md) :
l'atelier Perchance et son harnais disparaissent des consignes aux agents.

- AGENTS.md : nouvelle section « Comment on livre — le dépôt est la source de
  vérité » (branche dev, une branche par sujet, une PR par sujet vers dev, CI
  verte avant relecture, trace changelog + APP_VERSION) ; les références à
  ATELIER.md, au harnais et au flux atelier ↔ dépôt sont retirées ; les
  garde-fous sont renumérotés.
- CLAUDE.md : la référence atelier retirée, le fichier renvoie à AGENTS.md.
- src/README.md : la section « Flux de travail : Perchance ↔ GitHub » devient
  « Flux de travail — le dépôt est la source de vérité » ; les recettes
  d'export et la table de l'export sont remplacées par « Disposition des
  fichiers » ; l'arborescence et les pièges ne parlent plus de l'atelier.
- tests/README.md : la section « Les jouer dans l'atelier » supprimée.
- src/docs/INDUSTRIALISATION.md : la section du harnais supprimée, les
  références à l'export et à ATELIER.md retirées.
- src/docs/REPRISE.md : le manifeste main.pjs décrit sans Perchance, la table
  d'export remplacée par un renvoi à « Disposition des fichiers ».
- README.md (racine) : le paragraphe « S'il travaille dans l'atelier »
  supprimé, le renvoi à la table de l'export corrigé.
- Le mot « atelier » reste pour l'écran interne de l'application (inchangé).
- Trace : changelog 1.6.3v (2026-10-24), APP_VERSION 1.6.3v,
  logiciel-engendre.mjs régénéré, statut du plan mis à jour.

Vérifié : syntaxe 257 fichiers 0 faute, style strict 0 remarque,
152 épreuves + 2 sauts, service 333/333, miroir engendré 4/4.

Generated by Mistral Vibe.
Co-Authored-By: Mistral Vibe <vibe@mistral.ai>

Co-authored-by: aplds <aplds@users.noreply.github.com>
@aplds
aplds merged commit 81f166f into dev Oct 24, 2026
8 checks passed
aplds pushed a commit that referenced this pull request Oct 24, 2026
Co-authored-by: aplds <aplds@users.noreply.github.com>
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.

2 participants