concepts: declare the three edges PR #219 dropped to the body cap - #238
Merged
Conversation
PR #219 recorded three real interactions of backlog-stub as prose because each neighbour sat within two words of the old 400-word body cap and a reciprocal bullet did not fit. Epic #220 re-cut the cap to measure a page's own content, so the fan-out can no longer fail — the edges are declared here: publishing-config-resolution, issue-sourced-planning, durable-close-record, each with its mirrored bullet and reciprocal Decision Log entry. Hand curation (last_updated_by: manual): both epics had already drained, so no queue entry was left to carry the edges. Atlas regenerated; anchors untouched, since no code changed. Co-Authored-By: Claude Opus 5 <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
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.
Hand curation of the concept store
PR #219 (distillation of epic #185) recorded three real interactions of
backlog-stubas prose rather than as declaredtouchesedges, and flagged the loss in reviewer note 1. Each neighbour sat at 398–400 body words against the old 400-word cap; a reciprocal Integration Points bullet costs ~15 words, and compressing a neighbour's still-true content to make room is not a legal move. So the drain dropped the edges.Epic #220 re-cut the cap to measure a page's own content and to bound the neighbour list per entry instead. The reciprocity fan-out can no longer fail, which is exactly the success metric #220 stated for these three pages. This PR declares the edges.
Edges declared
publishing-config-resolutionissue-sourced-planningepic-not-planned) rather than emitting one whose story set is emptydurable-close-recordEach verified against source before writing:
.claude/skills/nxs-epic-resolve/SKILL.md(the unplanned-epic refusal),delivery_config.py(unplanned-labelas a resolver key),.claude/commands/nxs.close.md(step 3b filing and the Deferred-scope comment lines).Every edge is bidirectional:
backlog-stubgains three bullets and one Decision Log entry; each neighbour gainsbacklog-stubintouches, one mirrored bullet, and oneReciprocal link from backlog-stubentry.Why hand curation, not a drain
The distiller is the store's single producer, and the README's one carve-out is deliberate manual curation marked
last_updated_by: "manual". Both epics involved had already drained — #185 through PR #219, #220 through PR #236 — so no queue entry was left to carry these edges. The alternative, waiting for some future drain that happens to touch one of the four pages, leaves blast-radius retrieval onbacklog-stubwrong for an unbounded time, which is the silent degradation note 1 was raised about. That trade-off is recorded as the refuted alternative in the new Decision Log entry.Prior art for the
manualsource on a reciprocal entry:decision-record.md,committed-queue.md,nexus-pipeline.md.Checks
pnpm nexus:validate-concepts— 0 blocking, 5 advisories, all pre-existing on other pages. No advisory on the four touched pages; every new bullet is under the 25-word advisory.--base main, the four changed pages) — OK. One new Decision Log entry per page, prior entries untouched.pnpm nexus:check-atlas— OK.docs/concepts.mdregenerated (ordering shift only, no count change).Scope
Only reviewer note 1 of PR #219. Note 2 (store-wide cap saturation) is what #220 fixed; notes 3 and 4 were resolved within #219 itself.
🤖 Generated with Claude Code