Skip to content

docs: add repo-owned agent skills - #2711

Open
shikanime wants to merge 6 commits into
mainfrom
docs/repo-skills
Open

docs: add repo-owned agent skills#2711
shikanime wants to merge 6 commits into
mainfrom
docs/repo-skills

Conversation

@shikanime

@shikanime shikanime commented Sep 9, 2026

Copy link
Copy Markdown
Member

Issues liées

#2710 (fermer délibérément après la fusion)


Quel est le comportement actuel ?

Les conventions de contribution (cycle issue-first, triage des issues, forme des commits conventionnels, workflow de PR, revue) ne sont chargées par aucun agent de codage automatiquement : chaque session les réapprend ou les devine.

Quel est le nouveau comportement ?

Sept skills agent-owned sont ajoutés sous .agents/skills/cpn-dev-workflow, cpn-commit, cpn-pr, cpn-issue, cpn-review, cpn-merge, cpn-delegate — distillant le cycle issue-first, la forme de commit imposée par commitlint, le workflow de PR (brouillon, corps français depuis le template, triage, merge queue), le cycle issue (templates français, ledger d'acceptation, triage additif) et la revue (findings inline sévéritisés, réconciliation DoD, résolution des threads). Préfixe cpn- aligné sur le catalogue org. Workflow git standard (branches + worktrees). Convention générique multi-agents : .agents/skills/ est découvert nativement par Claude Code et chargeable via hermes skills trust côté Hermes. Contenu volontairement impersonnel. AGENTS.md n'est pas modifié.

Cette PR introduit-elle un breaking change ?

Non.

Autres informations

Documentation seule : cinq SKILL.md nouveaux, aucun code ni dépendance. À rapprocher de #2324 (conventions server-nestjs versionnées dans le dépôt).

@shikanime shikanime added the docs Improvements or additions to documentation label Sep 9, 2026
@shikanime shikanime self-assigned this Sep 9, 2026
@shikanime shikanime added this to the 9.26.0 milestone Sep 9, 2026
@shikanime
shikanime force-pushed the docs/repo-skills branch 6 times, most recently from b031db0 to 3aa337c Compare September 9, 2026 14:02
@shikanime
shikanime marked this pull request as ready for review September 9, 2026 14:11
@shikanime
shikanime requested a review from a team as a code owner September 9, 2026 14:11
StephaneTrebel
StephaneTrebel previously approved these changes Sep 11, 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.

J'ai des suggestions, mais ça reste une excellente initialisation du sujet 👍

Comment thread .agents/skills/cpn-dev-workflow/SKILL.md
Comment thread .agents/skills/cpn-dev-workflow/SKILL.md
Comment thread .agents/skills/cpn-dev-workflow/SKILL.md Outdated
Comment thread .agents/skills/cpn-issue/SKILL.md
Comment thread .agents/skills/cpn-issue/SKILL.md
Signed-off-by: William Phetsinorath <william.phetsinorath-open@interieur.gouv.fr>
Change-Id: I16ed8b7b82081dfb93609c317a87107b6a6a6964
Drop the jj-specific commands in favor of plain git (worktree isolation,
heredoc commit bodies, rebase onto origin/main). Add cpn-issue (French
templates, acceptance ledger, triage) and cpn-review (severity-tagged
inline findings, DoD reconciliation, thread resolution), both distilled
from the team's shared review practice. Rename all skills to the cpn-
prefix to mirror the org catalog. No jj anywhere.

Refs #2710
Add a terseness rule to cpn-dev-workflow and cross-reference it from
cpn-issue free-text rules. Run pnpm playwright:test systematically in
the verify block: unlinked changes can break E2E, and runs surface
flaky and slow specs.

Refs #2710
Port the landing and worktree-isolation units from the shikanime family, readapted to this repo: plain git worktrees, human approval gate, SonarQube merge queue cross-reference, no agent-specific identity. Cross-wire the existing skills.

Refs #2710
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.

3 participants