hibou04-ops · hibou04-ops · May 22, 2026 · May 22, 2026
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -6,6 +6,19 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 
 ## [Unreleased]
 
+## [0.10.4] - 2026-05-23
+
+### Added
+
+- Added v0.10.4 release notes.
+
+### Changed
+
+- Restructured `README.md`: README-family links moved directly under the badges, "How is this different?" moved above "Quick start", and the verification links grouped under a Verification lead-in.
+- Re-pinned `README.md` repository links from the `v0.10.3` tag to `v0.10.4`.
+- Completed the README-family link line in `EASY_README.md` and `EASY_README_KR.md`.
+- Added a README backlink footer to the CLI exit codes, provider compatibility, and release hygiene docs.
+
 ## [0.10.3] - 2026-05-23
 
 ### Added
@@ -211,7 +224,8 @@ Initial public release of the Antemortem CLI.
 
 Antemortem as a discipline was released as methodology-only in [Antemortem v0.1 / v0.1.1](https://github.com/hibou04-ops/Antemortem). The CLI operationalizes the protocol: scaffold, run, lint — three commands, one week to a disciplined antemortem doc. v0.2 ships the CLI; the methodology repo stays the source of truth for the protocol itself.
 
-[Unreleased]: https://github.com/hibou04-ops/antemortem-cli/compare/v0.10.3...HEAD
+[Unreleased]: https://github.com/hibou04-ops/antemortem-cli/compare/v0.10.4...HEAD
+[0.10.4]: https://github.com/hibou04-ops/antemortem-cli/compare/v0.10.3...v0.10.4
 [0.10.3]: https://github.com/hibou04-ops/antemortem-cli/compare/v0.10.2...v0.10.3
 [0.10.2]: https://github.com/hibou04-ops/antemortem-cli/compare/v0.10.0...v0.10.2
 [0.10.0]: https://github.com/hibou04-ops/antemortem-cli/releases/tag/v0.10.0

diff --git a/EASY_README.md b/EASY_README.md
@@ -1,7 +1,7 @@
 # antemortem (CLI) — Easy Start
 
 > The short version, for people who found the main README intimidating.
-> Full doc: [README.md](README.md) · 한국어 Easy: [EASY_README_KR.md](EASY_README_KR.md)
+> README family: [English](README.md) · [한국어](README_KR.md) · [Easy](EASY_README.md) · [쉬운 한국어](EASY_README_KR.md)
 > Generated source-of-truth claims: [English](docs/generated/claims.md) · [Korean](docs/generated/claims_kr.md).
 > Trust model: [English](docs/trust_model.md) · [Korean](docs/trust_model_kr.md).
 > Toolkit positioning: [English](docs/toolkit_positioning.md) · [Korean](docs/toolkit_positioning_kr.md).

diff --git a/EASY_README_KR.md b/EASY_README_KR.md
@@ -1,6 +1,6 @@
 # antemortem (CLI) — 쉬운 설명
 
-> 짧은 소개입니다. 전체 문서: [README_KR.md](README_KR.md), English easy: [EASY_README.md](EASY_README.md)
+> 짧은 소개입니다. README family: [English](README.md) · [한국어](README_KR.md) · [Easy](EASY_README.md) · [쉬운 한국어](EASY_README_KR.md)
 > 생성된 source-of-truth claim block: [English](docs/generated/claims.md) · [Korean](docs/generated/claims_kr.md)
 > 신뢰 모델: [한국어](docs/trust_model_kr.md) · [English](docs/trust_model.md)
 > Toolkit positioning: [한국어](docs/toolkit_positioning_kr.md) · [English](docs/toolkit_positioning.md)

diff --git a/README.md b/README.md
diff --git a/README_KR.md b/README_KR.md
@@ -5,7 +5,7 @@ Antemortem은 diff를 쓰기 전에 구현 계획의 리스크가 `REAL`, `GHOST
 [![CI](https://github.com/hibou04-ops/antemortem-cli/actions/workflows/ci.yml/badge.svg)](https://github.com/hibou04-ops/antemortem-cli/actions/workflows/ci.yml)
 [![License: Apache 2.0](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](LICENSE)
 [![Python](https://img.shields.io/badge/python-3.11%2B-blue.svg)](https://www.python.org)
-[![PyPI](https://img.shields.io/badge/pypi-0.10.3-blue.svg)](https://pypi.org/project/antemortem/)
+[![PyPI](https://img.shields.io/badge/pypi-0.10.4-blue.svg)](https://pypi.org/project/antemortem/)
 [![Status](https://img.shields.io/badge/status-alpha-orange.svg)](#상태--로드맵)
 [![Tests](https://img.shields.io/badge/tests-offline%20CI-brightgreen.svg)](tests/)
 [![Providers](https://img.shields.io/badge/providers-anthropic%20%7C%20openai%20%7C%20gemini%20%7C%20openai--compatible-informational.svg)](#provider-지원)
@@ -35,9 +35,9 @@ CLI 명령은 7개입니다: `init` / `doctor` / `run` / `lint` / `evidence` / `
 pip install antemortem
 ```
 
-> **현재 릴리스: v0.10.3** — 공개 README claim은 `python scripts/check_repo_consistency.py`로 source of truth와 대조합니다.
+> **현재 릴리스: v0.10.4** — 공개 README claim은 `python scripts/check_repo_consistency.py`로 source of truth와 대조합니다.
 
-English README: [README.md](README.md)
+README family: [English](README.md) · [한국어](README_KR.md) · [Easy](EASY_README.md) · [쉬운 한국어](EASY_README_KR.md)
 
 생성된 source-of-truth claim block: [English](docs/generated/claims.md) · [Korean](docs/generated/claims_kr.md).
 
@@ -664,7 +664,7 @@ Lint discipline (disk-verified citations) 은 변하지 않음. Classification
 
 ## 상태 & 로드맵
 
-v0.10.3 는 **alpha**. CLI 계약 (seven commands, flags, exit codes) 은 stable. JSON artifact schema 는 alpha line 안에서 additive 를 우선합니다. Breaking output-shape 변경은 명시적 contract-lock release 로 미룹니다. Prompt iteration 은 offline test, 기록된 artifact, 또는 문서화된 replay command 로 검증 가능한 경우에만 진행합니다.
+v0.10.4 는 **alpha**. CLI 계약 (seven commands, flags, exit codes) 은 stable. JSON artifact schema 는 alpha line 안에서 additive 를 우선합니다. Breaking output-shape 변경은 명시적 contract-lock release 로 미룹니다. Prompt iteration 은 offline test, 기록된 artifact, 또는 문서화된 replay command 로 검증 가능한 경우에만 진행합니다.
 
 Semver 는 v1.0 부터 엄격 적용.
 
@@ -733,7 +733,7 @@ Case study 는 [Antemortem methodology repo](https://github.com/hibou04-ops/Ante
 ## 인용
 
 ```
-antemortem-cli v0.10.3 — tooling for the Antemortem pre-implementation reconnaissance discipline.
+antemortem-cli v0.10.4 — tooling for the Antemortem pre-implementation reconnaissance discipline.
 https://github.com/hibou04-ops/antemortem-cli, 2026.
 ```
 

diff --git a/docs/claim_ledger.md b/docs/claim_ledger.md
@@ -5,7 +5,7 @@ This ledger maps non-trivial public README claims to a source of truth. Qualitat
 | Claim | Location | Source of truth | Verification command | Status |
 |---|---|---|---|---|
 | The tool classifies implementation-plan risks as REAL, GHOST, NEW, or UNRESOLVED before a diff exists. | README.md:Antemortem checks whether<br>README_KR.md:Antemortem은 diff를 쓰기 전에<br>EASY_README.md:Antemortem checks an implementation plan<br>EASY_README_KR.md:Antemortem은 코드가 생기기 전에 | src/antemortem/schema.py; src/antemortem/decision.py; tests/test_schema.py | pytest -q | source-backed |
-| Current package version is source-backed. | README.md:Current release: v0.10.3<br>README_KR.md:현재 릴리스: v0.10.3 | pyproject.toml; docs/generated/claims.md; docs/generated/claims_kr.md | python scripts/check_repo_consistency.py | generated |
+| Current package version is source-backed. | README.md:Current release: v0.10.4<br>README_KR.md:현재 릴리스: v0.10.4 | pyproject.toml; docs/generated/claims.md; docs/generated/claims_kr.md | python scripts/check_repo_consistency.py | generated |
 | Repository name, PyPI distribution, install command, import package, and CLI command are intentionally separated. | README.md:# antemortem-cli<br>README.md:pypi.org/project/antemortem/<br>README.md:pip install antemortem<br>README.md:github.com/hibou04-ops/antemortem-cli<br>docs/generated/claims.md:PyPI distribution | pyproject.toml; scripts/generate_readme_claims.py; scripts/check_repo_consistency.py; tests/test_generate_readme_claims.py; tests/test_repo_consistency.py | python scripts/check_repo_consistency.py | generated |
 | Offline test suite is verified by CI without a public exact collected-count claim. | README.md:tests-offline%20CI<br>README_KR.md:tests-offline%20CI<br>docs/generated/claims.md:Offline test suite | GitHub Actions workflow; docs/generated/claims.md; tests/test_generate_readme_claims.py | python -m pytest -q | command-backed |
 | Command list contains init, doctor, run, lint, evidence, gate, eval. | README.md:The CLI has seven commands<br>README_KR.md:CLI 명령은 7개입니다<br>EASY_README.md:The 7 commands<br>EASY_README_KR.md:7 commands | src/antemortem/cli.py; docs/generated/claims.md; tests/test_cli.py | python scripts/check_repo_consistency.py | generated |

diff --git a/docs/claim_ledger_kr.md b/docs/claim_ledger_kr.md
@@ -5,7 +5,7 @@
 | Claim | Location | Source of truth | Verification command | Status |
 |---|---|---|---|---|
 | 구현 계획의 risk를 diff 작성 전에 REAL, GHOST, NEW, UNRESOLVED로 분류한다. | README.md:Antemortem checks whether<br>README_KR.md:Antemortem은 diff를 쓰기 전에<br>EASY_README.md:Antemortem checks an implementation plan<br>EASY_README_KR.md:Antemortem은 코드가 생기기 전에 | src/antemortem/schema.py; src/antemortem/decision.py; tests/test_schema.py | pytest -q | source-backed |
-| 현재 package version claim은 source-backed이다. | README.md:Current release: v0.10.3<br>README_KR.md:현재 릴리스: v0.10.3 | pyproject.toml; docs/generated/claims.md; docs/generated/claims_kr.md | python scripts/check_repo_consistency.py | generated |
+| 현재 package version claim은 source-backed이다. | README.md:Current release: v0.10.4<br>README_KR.md:현재 릴리스: v0.10.4 | pyproject.toml; docs/generated/claims.md; docs/generated/claims_kr.md | python scripts/check_repo_consistency.py | generated |
 | repository name, PyPI distribution, install command, import package, CLI command는 의도적으로 분리되어 있다. | README_KR.md:# antemortem-cli<br>README_KR.md:pypi.org/project/antemortem/<br>README_KR.md:pip install antemortem<br>README_KR.md:github.com/hibou04-ops/antemortem-cli<br>docs/generated/claims_kr.md:PyPI distribution | pyproject.toml; scripts/generate_readme_claims.py; scripts/check_repo_consistency.py; tests/test_generate_readme_claims.py; tests/test_repo_consistency.py | python scripts/check_repo_consistency.py | generated |
 | Offline test suite는 공개 exact collected-count claim 없이 CI에서 검증된다. | README.md:tests-offline%20CI<br>README_KR.md:tests-offline%20CI<br>docs/generated/claims_kr.md:Offline test suite | GitHub Actions workflow; docs/generated/claims_kr.md; tests/test_generate_readme_claims.py | python -m pytest -q | command-backed |
 | command list는 init, doctor, run, lint, evidence, gate, eval이다. | README.md:The CLI has seven commands<br>README_KR.md:CLI 명령은 7개입니다<br>EASY_README.md:The 7 commands<br>EASY_README_KR.md:7 commands | src/antemortem/cli.py; docs/generated/claims.md; tests/test_cli.py | python scripts/check_repo_consistency.py | generated |

diff --git a/docs/cli_exit_codes.md b/docs/cli_exit_codes.md
@@ -13,3 +13,7 @@ without parsing human-readable output.
 | 70 | internal error | Reserved for unexpected tool bugs. Report the command, artifact, and traceback if seen. |
 
 The constants live in `src/antemortem/exit_codes.py`.
+
+---
+
+This page is part of the [`antemortem-cli`](../README.md) documentation set.
diff --git a/docs/generated/claims.md b/docs/generated/claims.md
@@ -2,7 +2,7 @@
 ## Generated Repository Claims
 
 - Repository: `hibou04-ops/antemortem-cli`
-- PyPI distribution: `antemortem` `0.10.3`
+- PyPI distribution: `antemortem` `0.10.4`
 - Install: `pip install antemortem`
 - Python import package: `antemortem`
 - CLI command: `antemortem`

diff --git a/docs/generated/claims_kr.md b/docs/generated/claims_kr.md
@@ -2,7 +2,7 @@
 ## 생성된 Repository Claim
 
 - Repository: `hibou04-ops/antemortem-cli`
-- PyPI distribution: `antemortem` `0.10.3`
+- PyPI distribution: `antemortem` `0.10.4`
 - Install: `pip install antemortem`
 - Python import package: `antemortem`
 - CLI command: `antemortem`

diff --git a/docs/launch_note.md b/docs/launch_note.md
@@ -50,8 +50,8 @@ Run the post-release dry run before upload, or the full post-release check after
 upload:
 
 ```bash
-python scripts/post_release_check.py --version 0.10.3 --skip-pypi-network
-python scripts/post_release_check.py --version 0.10.3
+python scripts/post_release_check.py --version 0.10.4 --skip-pypi-network
+python scripts/post_release_check.py --version 0.10.4
 ```
 
 ## Boundaries

diff --git a/docs/launch_note_kr.md b/docs/launch_note_kr.md
@@ -45,8 +45,8 @@ python scripts/release_audit.py
 upload 전에는 dry run, upload 후에는 전체 post-release check를 실행합니다.
 
 ```bash
-python scripts/post_release_check.py --version 0.10.3 --skip-pypi-network
-python scripts/post_release_check.py --version 0.10.3
+python scripts/post_release_check.py --version 0.10.4 --skip-pypi-network
+python scripts/post_release_check.py --version 0.10.4
 ```
 
 ## 경계

diff --git a/docs/provider_compatibility.md b/docs/provider_compatibility.md
@@ -26,3 +26,7 @@ The support contract is narrow:
 pytest -q tests/test_provider_contracts.py
 python scripts/check_repo_consistency.py
 ```
+
+---
+
+This page is part of the [`antemortem-cli`](../README.md) documentation set.
diff --git a/docs/release-notes/v0.10.4.md b/docs/release-notes/v0.10.4.md
@@ -0,0 +1,29 @@
+# Release Notes: antemortem 0.10.4
+
+## Summary
+
+- Package version: `0.10.4`
+- Scope: README navigation restructure, CI-status integrity for more README-linked docs, and release surface version metadata.
+- Runtime behavior: unchanged; the only runtime source edit is the package `__version__` string.
+
+## Changed
+
+- Restructured `README.md` so high-leverage navigation is near the top: the README-family links now sit directly under the badges, "How is this different?" precedes "Quick start", and the verification links are grouped under a Verification lead-in.
+- Re-pinned `README.md` repository links from `v0.10.3` to `v0.10.4`.
+- Completed the README-family link line in `EASY_README.md` and `EASY_README_KR.md` so every variant lists all four.
+
+## Fixed
+
+- Added a README backlink footer to `cli_exit_codes.md`, `provider_compatibility.md`, and `release_hygiene.md`. At the `v0.10.3` tag these README-linked pages were last modified by a failing-CI commit; the `v0.10.4` tag includes a passing-CI commit for them.
+
+## Release surfaces
+
+- [README.md](https://github.com/hibou04-ops/antemortem-cli/blob/v0.10.4/README.md)
+- [README_KR.md](https://github.com/hibou04-ops/antemortem-cli/blob/v0.10.4/README_KR.md)
+- [EASY_README.md](https://github.com/hibou04-ops/antemortem-cli/blob/v0.10.4/EASY_README.md)
+- [EASY_README_KR.md](https://github.com/hibou04-ops/antemortem-cli/blob/v0.10.4/EASY_README_KR.md)
+- [CHANGELOG.md](https://github.com/hibou04-ops/antemortem-cli/blob/v0.10.4/CHANGELOG.md)
+
+## Publish note
+
+The `v0.10.4` GitHub tag must exist before uploading to PyPI. Until that tag is pushed, tag-pinned links in the PyPI README can return 404.
diff --git a/docs/release_hygiene.md b/docs/release_hygiene.md
@@ -171,3 +171,7 @@ The wheel smoke test treats `examples/`, `benchmarks/`, and other repository fix
 ## Publish Boundary
 
 This command is a readiness check only. Publishing remains a separate explicit action outside this script.
+
+---
+
+This page is part of the [`antemortem-cli`](../README.md) documentation set.
diff --git a/pyproject.toml b/pyproject.toml
@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "antemortem"
-version = "0.10.3"
+version = "0.10.4"
 description = "CLI for pre-diff risk classification with schema validation and disk-verified citations."
 readme = { file = "README.md", content-type = "text/markdown" }
 requires-python = ">=3.11"

diff --git a/src/antemortem/__init__.py b/src/antemortem/__init__.py
@@ -10,4 +10,4 @@
 See https://github.com/hibou04-ops/Antemortem for the methodology.
 """
 
-__version__ = "0.10.3"
+__version__ = "0.10.4"
diff --git a/tests/test_cli_help_text.py b/tests/test_cli_help_text.py
@@ -101,7 +101,7 @@ def test_help_output_snapshots_cover_every_command():
 
 def test_readme_quick_start_commands_match_cli_help():
     readme = (ROOT / "README.md").read_text(encoding="utf-8")
-    quick_start = readme.split("## Quick start", 1)[1].split("## How is this different?", 1)[0]
+    quick_start = readme.split("## Quick start", 1)[1].split("## Table of Contents", 1)[0]
     commands = {
         match.group(1)
         for match in re.finditer(r"^antemortem\s+([a-z][a-z0-9_-]*)\b", quick_start, re.M)