From 0889ff409039ee7bf7fb78676ec37423831bc121 Mon Sep 17 00:00:00 2001 From: Etienne Filhol Date: Tue, 10 Nov 2026 13:48:01 +0100 Subject: [PATCH] Title pull requests as conventional commit subjects --- .claude/skills/file-issue/SKILL.md | 7 +++++++ AGENTS.md | 10 +++++++++- 2 files changed, 16 insertions(+), 1 deletion(-) diff --git a/.claude/skills/file-issue/SKILL.md b/.claude/skills/file-issue/SKILL.md index 4eb5034..48331fd 100644 --- a/.claude/skills/file-issue/SKILL.md +++ b/.claude/skills/file-issue/SKILL.md @@ -54,6 +54,13 @@ repository and of the repository that owns the cause, with `gh issue list ## A pull request +The title is a conventional commit subject, because a squash merge makes it +the commit on `main`: `type(scope): summary`, lowercase except names, no +final period. Type: `feat`, `fix`, `perf`, `refactor`, `docs`, `test`, `ci`, +`build`, `chore` or `revert`. Scope: the part touched, as AGENTS.md lists them +(`standard`, `catalogue`, `runs`, `web`, `docs`, `ci`, ...). For example +`feat(catalogue): run LongMemEval on one question type`. + The body follows the template: `Closes #n` first when an issue exists, then `## What`, `## Touches`, `## Before and after` (two images at the same width when the change is visible; leave the section out otherwise), `## Verified` diff --git a/AGENTS.md b/AGENTS.md index 691ad15..0434102 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -338,7 +338,15 @@ catalogue, high the backend, extreme what runs and proves), **Components**, **Screenshot** when it is visible, **Reproduction** (the smallest steps or input that show it), **Expected**, **Acceptance** (one checkbox per criterion; the judge gives each its own row) and **Dependencies and -related**. A pull request's body follows `.github/pull_request_template.md`: +related**. A pull request's title is a conventional commit subject, since a +squash merge makes it the commit on `main`: `type(scope): summary`, the +summary lowercase (names keep their case) without a final period. The type is +one of `feat`, `fix`, `perf`, `refactor`, `docs`, `test`, `ci`, `build`, +`chore` or `revert`; the scope is the part it touches: `standard`, +`catalogue`, `runs`, `traces`, `compare`, `judge`, `builder`, `web`, +`execution`, `settings`, `docs`, `site`, `ci`, `release`. For example +`fix(standard): give drivers only the nullius package on PYTHONPATH`. +A pull request's body follows `.github/pull_request_template.md`: `Closes #n`, What, Touches, Before and after (two images when the change is visible), Verified, Risk. An assistant files either with the `/file-issue` skill (`.claude/skills/file-issue/SKILL.md`), which produces the same shape