erplibre/.claude/rules
Mathieu Benoit 5fb49da0f2 [ADD] convention : dire le fonctionnement, pas le contexte ni les noms
Le dépôt n'avait aucune règle sur le commentaire de code : le seul modèle
d'écriture était le corps de commit, et le gabarit y renvoyait le
raisonnement qui n'y tenait pas. Le récit s'écoulait dans les sources,
avec les noms qu'il portait.

L'épreuve tient en une phrase : le code est le sujet, au présent de ce
qu'il fait. Une phrase dont le sujet est un incident, une machine, une date
ou une personne part vers tasks/, non versionné ; le mode de défaillance
que le code empêche reste. Rien d'identifiant hors de private/, et
seulement sur un dépôt privé.

--- EN ---

The repository had no rule at all about code comments: the only writing
model available was the commit body, and the template sent the reasoning
that did not fit there into a comment. The story flowed into the sources,
carrying the names it named.

The test fits in one sentence: the code is the subject, in the present of
what it does. A sentence whose subject is an incident, a machine, a date or
a person goes to tasks/, unversioned; the failure mode the code prevents
stays. Nothing identifying outside private/, and only on a private
repository.

Assisted-by: Claude Opus 5
2026-08-30 05:11:36 -04:00
..
01-versions.md [REF] claude: trim the always-loaded guidance, and fix what it got wrong 2026-08-07 01:15:33 -04:00
04-code-conventions.md [ADD] convention : dire le fonctionnement, pas le contexte ni les noms 2026-08-30 05:11:36 -04:00
06-code-generator.md [REF] claude: split CLAUDE.md into .claude/rules/ 2026-03-14 23:15:54 -04:00
07-documentation.md [REF] claude: trim the always-loaded guidance, and fix what it got wrong 2026-08-07 01:15:33 -04:00
08-deployment.md [ADD] qemu: openSUSE Leap 16.0, numbered, as the default 2026-08-17 00:40:01 -04:00
09-workflow.md [ADD] convention : dire le fonctionnement, pas le contexte ni les noms 2026-08-30 05:11:36 -04:00