Skip to content

docs(adr): ADR 0010's "pending A2 (#350)" points at a closed issue - #574

Open
lis186 wants to merge 1 commit into
mainfrom
fix/adr-0010-dangling-a2-reference
Open

docs(adr): ADR 0010's "pending A2 (#350)" points at a closed issue#574
lis186 wants to merge 1 commit into
mainfrom
fix/adr-0010-dangling-a2-reference

Conversation

@lis186

@lis186 lis186 commented Aug 20, 2026

Copy link
Copy Markdown
Owner

繁中摘要

ADR 0010 的狀態行與 CLAUDE.md 的 invariant 都說 live path 與 turn list「pending A2 (#350)」,但 #350 已 CLOSED,而那兩處確實還是 per-turn —— 所以那個待辦沒有任何 issue 在追。指向已關閉 issue 的承諾比沒有承諾更糟:讀者會以為有人在管。

What changed

Documentation and one code comment. No behaviour change.

Site Before After
docs/decisions/0010-…md status line "pending A2" accepted bounded divergence, no dangling ref
docs/decisions/0010-…md A1/A2 section "A2 (#350) mirrors …" never implemented, #350 closed, nothing tracks it
CLAUDE.md:38 same dangling ref same correction
CHANGELOG.md:71 "per-conversation … replaces per-turn early-exit" qualified: batch path only
public/workflow-timeline.js:1100 "A2 mirrors … here" this per-turn form IS the accepted divergence

Verified

  • gh issue view 350 → CLOSED.
  • public/workflow-timeline.js:1093-1105 and public/entry-rendering.js:495-499 are still the per-turn early-exit, so the ADR's description of the divergence was right; only its tracking claim was stale.

A2 is deliberately not reopened — reopen it when someone intends to implement it, not to make a paper trail look tidy.

🤖 Generated with Claude Code

狀態行與 CLAUDE.md 的 invariant 都寫著 live path 與 turn list「still use the
per-turn form **pending A2 (#350)**」。但 #350 已經 CLOSED,而
`public/workflow-timeline.js:1093-1105` 與 `public/entry-rendering.js:495-499`
確實還是 per-turn —— 也就是說那個「待辦」沒有任何 issue 在追。

指向已關閉 issue 的承諾比沒有承諾更糟:讀者會以為有人在管。ADR 本體早就把這個
偏離描述成 bounded、self-correcting 的殘留,所以把狀態行改成「已接受的 bounded
divergence」,並移除懸空引用。不重開 A2 —— 除非有人要實作它。

`CHANGELOG.md` 那條才是真正的 over-claim("per-conversation coreHash ownership
replaces per-turn early-exit"),加上「只有 batch path」的限定。程式碼裡承諾
「A2 mirrors … here」的註解一併改成「這就是被接受的偏離」。

No behaviour change: documentation and one comment only.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant