From 2886f0b4c74d0bf008f483c3300aead4b1da6cd8 Mon Sep 17 00:00:00 2001 From: moilanik Date: Tue, 17 Mar 2026 09:15:17 +0200 Subject: [PATCH] =?UTF-8?q?docs(git):=20add=20body=20length=20example=20wi?= =?UTF-8?q?th=20=E2=9D=8C/=E2=9C=85=20pair?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .ai/instructions/skills/git.instructions.md | 26 +++++++++++++++++++++ 1 file changed, 26 insertions(+) diff --git a/.ai/instructions/skills/git.instructions.md b/.ai/instructions/skills/git.instructions.md index 1687ce4..0e2e788 100644 --- a/.ai/instructions/skills/git.instructions.md +++ b/.ai/instructions/skills/git.instructions.md @@ -100,6 +100,32 @@ Types: `feat`, `fix`, `docs`, `refactor`, `chore` - ✅ `disable redis sub-chart` - ✅ `set queue type to level` +**Body length example — what "too much explanation" looks like vs. the correct version:** + +❌ Too long — describes runtime behavior, not the change: +```text +chore(minio): pin image to RELEASE.2025-10-15T17-29-55Z + +Chart 5.4.0 bundles RELEASE.2024-12-18 which does not return Last-Modified +metadata on objects. Thanos compactor falls back to ULID creation time and +deletes valid blocks as stale partial uploads (>48h old). + +Also add comment on thanos-sidecar image noting all Thanos containers +(compactor, blocks-exporter, init container, ghost cleanup job) share +this single image reference. +``` + +✅ Correct — states what changed, one line of context for the why: +```text +chore(minio): pin image to RELEASE.2025-10-15T17-29-55Z + +RELEASE.2024-12-18 (Chart 5.4.0) lacks Last-Modified on objects; compactor +deletes valid blocks as stale partial uploads. + +Add comment on thanos-sidecar: image is shared by compactor, blocks-exporter, +init container and ghost cleanup job. +``` + **All projects:** - Treat commit messages as change logs of repository state, not behavior reports - Never include runtime status, deployment outcomes, test run narratives, or manual operation confirmations unless the user explicitly asks for a release note or status report instead of a commit message