chore(release): bump to 0.5.0 and document release process

.claude-plugin/marketplace.json

@@ -11,7 +11,7 @@
       "name": "look",
       "source": "./src",
       "description": "Sequential code review with fresh agent contexts. Runs multiple independent review passes to catch more issues.",
-      "version": "0.4.0",
+      "version": "0.5.0",
       "author": { "name": "HartBrook" },
       "repository": "https://github.com/HartBrook/lookagain",
       "license": "MIT",

CHANGELOG.md

@@ -5,6 +5,21 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.5.0] - 2026-05-12
+
+### Added
+
+- Global sequential numbering across all severity sections in `/look:again` aggregate summary tables, so issues can be referenced by ID (e.g. "fix #3, #5") across must_fix/should_fix/suggestion groups.
+- "Suggested Fix" column in summary tables, providing a one-line fix preview alongside the existing detailed write-ups.
+- Static format regression tests in `scripts/test.sh` enforcing the new numbering and Suggested Fix output contract.
+- `.env` added to `.gitignore` so local `ANTHROPIC_API_KEY` files used for `make eval` / `make integration` cannot be committed accidentally.
+
+### Changed
+
+- Bumped promptfoo eval `max_tokens` to 4096 so reviewer outputs are not truncated mid-JSON for larger diffs.
+- `/look:again` orchestrator and reviewer prompts updated to emphasize the global ID rules so passes produce stable, parseable output.
+- Pipe and newline characters in Suggested Fix cells are now escaped so the markdown tables render correctly.
+
 ## [0.4.0] - 2026-01-29
 
 ### Changed

CONTRIBUTING.md

@@ -152,6 +152,18 @@ When editing or adding skills in `src/skills/`:
 5. Commit with a clear message
 6. Open a pull request
 
-## Versioning
+## Releasing
 
-Update the version in `src/dot-claude-plugin/plugin.json` when making releases. The marketplace entry in `.claude-plugin/marketplace.json` also has a `version` field — keep both in sync. The test suite (`make test`) validates that agents and skills match between the two files.
+The marketplace tracks `main` of this repo - there are no git tags or GitHub releases. Bumping the version on `main` is what makes a new release visible to users.
+
+Checklist for cutting a release:
+
+1. Branch off `main`: `git checkout -b release/vX.Y.Z`
+2. Bump version in **both** manifest files (kept in sync, enforced by `make test`):
+   - `src/dot-claude-plugin/plugin.json` -> `"version"`
+   - `.claude-plugin/marketplace.json` -> `plugins[0].version`
+3. Add a `## [X.Y.Z] - YYYY-MM-DD` entry to `CHANGELOG.md` (Keep a Changelog format).
+4. Run `make test`. Fix anything it flags.
+5. (Recommended) `make eval` after prompt or argument-handling changes; `make integration` after orchestration or output-format changes. Both require `ANTHROPIC_API_KEY`.
+6. Commit, push, open a PR against `main`.
+7. After merge, users pick up the new version via the [Updating](README.md#updating) steps in the README.

src/dot-claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "look",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "Sequential code review with fresh agent contexts. Runs multiple independent review passes to catch more issues.",
   "author": { "name": "HartBrook" },
   "repository": "https://github.com/HartBrook/lookagain",