Skip to content

docs: move authoring conventions from AGENTS.md to cpn-code-authoring - #2811

Open
shikanime wants to merge 12 commits into
mainfrom
chore/trim-agents-md
Open

shikanime wants to merge 12 commits into
mainfrom
chore/trim-agents-md

Conversation

@shikanime

@shikanime shikanime commented Oct 2, 2026 •

Copy link
Copy Markdown
Member

Quoi

Déplace les conventions d'authoring d'AGENTS.md vers un skill
.agents/skills/cpn-code-authoring consultable par les agents, puis le
complète avec le vocabulaire des services clients ratifié dans #2832 :
get*/create*/ensure* (+ reconcile* pour les sweeps planifiés),
routage par le ensure() util module-local, miroir verbatim des verbes
des API externes, et l'exception de réutilisation des secrets.

Pourquoi

AGENTS.md porte des règles de fixture/test que seuls les agents appliquent ;
un skill dédié les charge à la demande. Le vocabulaire manquait au skill
alors qu'il vient d'être ratifié.

Références

@shikanime
shikanime requested a review from a team as a code owner October 2, 2026 14:11
@shikanime
shikanime marked this pull request as draft October 2, 2026 14:19
shikanime added a commit to shikanime-labs/skills that referenced this pull request Oct 2, 2026
Design: skills/sks-code-authoring/
Related: cloud-pi-native/console#2811 carries cpn-code-authoring
Signed-off-by: Shikanime Deva <william.phetsinorath@shikanime.studio>
Change-Id: I6add530d32944e5563bf7f7a7b551ad86a6a6964
@shikanime shikanime changed the title docs: trim AGENTS.md rules moved to sks-code-authoring docs: move authoring conventions from AGENTS.md to cpn-code-authoring Oct 2, 2026

@StephaneTrebel StephaneTrebel left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

La migration allège correctement le contexte global, mais elle supprime aussi une règle d’architecture sans la préserver dans le skill. Le changement doit conserver cette convention avant intégration.

Comment thread AGENTS.md
@shikanime
shikanime force-pushed the chore/trim-agents-md branch 2 times, most recently from 4718486 to 195296e Compare October 5, 2026 13:18
@shikanime shikanime moved this to Hypotheses in Cloud Pi Native Oct 5, 2026
@shikanime
shikanime force-pushed the chore/trim-agents-md branch from 195296e to 5e34585 Compare October 5, 2026 13:35

@shikanime shikanime left a comment

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

La migration des conventions d'authoring vers .agents/skills/cpn-code-authoring est bien découpée : le skill reprend fidèlement les règles de tests déterministes (fenêtre de tirage faker) et de mockDeep retirées d'AGENTS.md, et la section Boundaries clarifie ce qui reste dans AGENTS.md. Une seule règle disparaît sans reprise visible : « Helpers return new objects; do not mutate inputs » — à confirmer dans le skill privé (shikanime-labs/skills#360) ou à réintégrer. Titre sans scope (docs: au lieu de docs(scope):) et premier commit qui mentionne sks-code-authoring au lieu de cpn-code-authoring, à harmoniser. Le flag draft est approprié tant que les règles continuent d'être ratifiées depuis les revues.

Comment thread AGENTS.md
@shikanime shikanime added the docs Improvements or additions to documentation label Oct 8, 2026
@shikanime shikanime self-assigned this Oct 8, 2026
@shikanime
shikanime marked this pull request as ready for review October 8, 2026 11:32
@shikanime shikanime added this to the 9.28.0 milestone Oct 8, 2026
@shikanime
shikanime force-pushed the chore/trim-agents-md branch 2 times, most recently from aa4c00e to 3ad5bf8 Compare October 8, 2026 12:25
Co-authored-by: Automata <automata@shikanime.studio>

Signed-off-by: Shikanime Deva <22115108+shikanime@users.noreply.github.com>
Co-authored-by: Automata <automata@shikanime.studio>

Signed-off-by: Shikanime Deva <22115108+shikanime@users.noreply.github.com>
Co-authored-by: Automata <automata@shikanime.studio>

Signed-off-by: Shikanime Deva <22115108+shikanime@users.noreply.github.com>
Co-authored-by: Automata <automata@shikanime.studio>
Signed-off-by: William Phetsinorath <william.phetsinorath-open@interieur.gouv.fr>
Change-Id: Ib5f2c9f757ac12a821e96a74e9a849b06a6a6964

Signed-off-by: Shikanime Deva <22115108+shikanime@users.noreply.github.com>
Co-authored-by: Automata <automata@shikanime.studio>

Signed-off-by: Shikanime Deva <22115108+shikanime@users.noreply.github.com>
Ratifies the get/create/ensure/reconcile vocabulary and module-local
ensure() util routing from #2832.

Co-authored-by: Automata <automata@shikanime.studio>

Signed-off-by: Shikanime Deva <22115108+shikanime@users.noreply.github.com>
ensure* primitives in xxx-client.service.ts; service-layer ensure* is
private composition that never re-implements race recovery; reconcile*
(collection sweep, may delete) only in xxx.service.ts.

Co-authored-by: Automata <automata@shikanime.studio>

Signed-off-by: Shikanime Deva <22115108+shikanime@users.noreply.github.com>
Deduplicate the strangler-fig rules out of SKILL.md into
references/migration-parity.md, referenced from the section and the
description.

Co-authored-by: Automata <automata@shikanime.studio>

Signed-off-by: Shikanime Deva <22115108+shikanime@users.noreply.github.com>
cpn-create-skill profile mandates metadata.version over a root-level
version field; sibling skills follow it.

Co-authored-by: Automata <automata@shikanime.studio>

Signed-off-by: Shikanime Deva <22115108+shikanime@users.noreply.github.com>
@shikanime
shikanime force-pushed the chore/trim-agents-md branch from c1274d9 to 2aa0042 Compare October 8, 2026 13:02
Mirror the cross-reference convention used by cpn-delegate, cpn-merge, and
cpn-release-patch.

Co-authored-by: Automata <automata@shikanime.studio>

Signed-off-by: Shikanime Deva <22115108+shikanime@users.noreply.github.com>
Co-authored-by: Automata <automata@shikanime.studio>

Signed-off-by: Shikanime Deva <22115108+shikanime@users.noreply.github.com>
Co-authored-by: Automata <automata@shikanime.studio>
Signed-off-by: William Phetsinorath <william.phetsinorath-open@interieur.gouv.fr>

@StephaneTrebel StephaneTrebel left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

✨ Le déplacement des conventions de test vers le skill les rend découvrables sans alourdir AGENTS.md, et les règles de parité sont externalisées dans une référence ciblée. Aucun écart relevé dans le diff ; la CI est verte.

@shikanime
shikanime added this pull request to the merge queue Oct 9, 2026
@shikanime
shikanime removed this pull request from the merge queue due to a manual request Oct 9, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

docs Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants