docs(journal): add 2026-06-15 bug-ledger session checkpoint#91
Merged
Conversation
Record the maintenance session that landed the in-repo bug ledger and triage protocol (PR #89) and the `.bugs` .gitignore chore (PR #90): what was done, that `master`'s library surface is unchanged, the ADR count (now 36), and how to resume (follow AGENTS.md §7.7 when hunting or triaging bugs). Add the index row and move the ROADMAP.md *Latest checkpoint* pointer, per AGENTS.md §7.6 / ADR-0036. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
danielPoloWork
added
the
documentation
8 tasks
danielPoloWork
added a commit
that referenced
this pull request
Jun 15, 2026
… ADR-0040 (#92) ## Summary Codifies a **PR-metadata policy** so every agent-opened PR also sets a maintainer **assignee**, **exactly one type label** (Conventional-Commit type → label), and the current open **release milestone**. Process/repository-metadata only — no code/API change. ## Motivation PRs carried only a title and body; GitHub's structured metadata (reviewers, assignees, labels, projects, milestone) was unset, leaving the PR list and release view without a type/ownership/release signal. Requested by the maintainer; recorded as [ADR-0040](docs/adr/0040-pull-request-metadata-policy.md). ## Changes - `AGENTS.md` §6.4 — the PR-metadata rule + the Conventional-Commit `type` → label map + the canonical `gh pr create` invocation; a metadata checkbox added to the PR body template. - `docs/adr/0040-pull-request-metadata-policy.md` — decision + rejected alternatives (area labels, rolling milestone, CI auto-labeler, forced reviewer), indexed. - `CHANGELOG.md` — `Unreleased` `Added` entry. - **Out of band (GitHub state, in this session):** created the eight type labels (`feat`/`fix`/`refactor`/`perf`/`test`/`build`/`chore`/`ci`; `docs` reuses `documentation`) and the `v1.1.1` milestone, and backfilled PRs #89–#91 with assignee + type label + milestone. ## Design Patterns - None — process/governance change. ## Verification - [x] `python tools/consistency_lint.py` — OK - [x] `markdownlint-cli2` clean on the four changed files - [x] This PR itself follows the new rule (assignee `@me`, label `documentation` for `docs`, milestone `v1.1.1`) - [ ] Builds / tests — N/A (no code change) ## Documentation Impact - [x] AGENTS.md §6.4 updated; ADR-0040 added + indexed - [x] CHANGELOG.md `Unreleased` updated - [x] No README / spec / patterns impact - [x] PR metadata set — assignee, `documentation` label, `v1.1.1` milestone (§6.4 / ADR-0040) ## Known gaps (documented, not oversights) - **Reviewers** not set — the sole collaborator (`danielPoloWork`) is the PR author and GitHub forbids self-review. Switches on (`--reviewer …`) when a second collaborator/team exists. - **Projects** not set — the `gh` token lacks the `project` scope. Switches on (`--project …`) after `gh auth refresh -s read:project,project` + a board. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Adds the
2026-06-15session checkpoint todocs/journal/, recording the maintenance session that landed the in-repo bug ledger + triage protocol (PR #89) and the.bugs.gitignorechore (PR #90). Documentation-only; no code/API change.Motivation
Per
AGENTS.md§7.6 / ADR-0036, a state-changing session closes with a dated journal checkpoint, an index row, and a movedROADMAP.mdLatest checkpoint pointer.Changes
docs/journal/2026/06/2026-06-15-bug-ledger.md— the checkpoint (what was done,masterlibrary surface unchanged, ADRs now 36, how to resume via §7.7).docs/journal/README.md— index row, newest first.ROADMAP.md— Latest checkpoint pointer moved to the new entry.Design Patterns
Verification
python tools/consistency_lint.py— OKmarkdownlint-cli2clean on the three changed filesDocumentation Impact
🤖 Generated with Claude Code