From b291eb0b03def8d1adb78422c283b28bf0c8d171 Mon Sep 17 00:00:00 2001 From: Bohdan Triapitsyn Date: Fri, 28 Aug 2026 19:17:58 +0300 Subject: [PATCH] docs(agents): changelog is written only on the maintainer's explicit request Claude-Session: https://claude.ai/code/session_017TK5JAYDfT3Fotc23UEg98 --- .agents/skills/changelog-authoring/SKILL.md | 4 +++- AGENTS.md | 3 ++- 2 files changed, 5 insertions(+), 2 deletions(-) diff --git a/.agents/skills/changelog-authoring/SKILL.md b/.agents/skills/changelog-authoring/SKILL.md index fc0668fd..06c887e3 100644 --- a/.agents/skills/changelog-authoring/SKILL.md +++ b/.agents/skills/changelog-authoring/SKILL.md @@ -1,12 +1,14 @@ --- name: changelog-authoring -description: Use when drafting or updating user-facing CHANGELOG.md entries for the OpenChamber `[Unreleased]` section, including the VS Code extension changelog, summarizing changes since the latest git tag. +description: Use only when the maintainer explicitly asks to update the changelog — then draft the OpenChamber `[Unreleased]` entries (main app and VS Code extension) summarizing changes since the latest git tag. license: MIT compatibility: opencode --- ## Overview +**Gate: an explicit maintainer request.** The changelog is written once per release, by the maintainer, as a single story. Both `CHANGELOG.md` files stay untouched by fixes, features, PR merges, de-slop follow-ups, and every other task — a change lands without a changelog line, and the maintainer folds it in later. Proceed past this point only when the current message asks to update the changelog; otherwise stop and leave both files as they are. + Draft user-facing bullet points for the `## [Unreleased]` section that summarize changes since the latest git tag up to `HEAD`. Two files are maintained: diff --git a/AGENTS.md b/AGENTS.md index 92a88286..cae060a7 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -42,6 +42,7 @@ Shared contracts must define intentional behavior for every applicable runtime: - Do not add dependencies unless explicitly requested. - Never add or log secrets, bearer tokens, pairing credentials, or sensitive user data. - Keep changes minimal and preserve unrelated worktree changes. +- `CHANGELOG.md` and `packages/vscode/CHANGELOG.md` are the maintainer's release-time work: they get written once, as one story, when the maintainer asks to update the changelog. Until that request, treat both files as read-only — a fix, feature, or merged PR lands without a changelog line. - Enforce security and correctness in core/runtime logic, not only UI visibility or prompts. - Keep entrypoints and bridges thin; place domain logic in focused owning modules. - Update owning documentation when module ownership, contracts, or invariants change. @@ -100,7 +101,7 @@ process violation. | Settings UI, settings dialogs, configuration surfaces, or settings search | `settings-ui-patterns` | | Sortable or drag-to-reorder behavior, especially `@dnd-kit` and touch/wrapping layouts | `drag-to-reorder` | | iOS Simulator build, launch, preview, gestures, or `serve-sim` control | `serve-sim` | -| Drafting or updating user-facing CHANGELOG entries for the `[Unreleased]` section (main app or VS Code extension) | `changelog-authoring` | +| The maintainer explicitly asks to update the changelog (main app or VS Code extension) — the only time either CHANGELOG is edited | `changelog-authoring` | | Creating or editing skills, `AGENTS.md`, or docs reached through agent instructions/context pointers | `writing-for-agents` | | Reviewing a single pull request or drafting a PR verdict/close/review comment | `pr-review` | | Triaging, cleaning up, or batch-processing the open PR queue | `triage-prs` |