docs: switch CLAUDE.md to the v2 URN grammar - #9
Merged
Conversation
CLAUDE.md is loaded verbatim as mandatory instruction every session, so its v1 `::` URNs actively teach the stale grammar to every agent working here. v1 still resolves forever via the stored alias map, which is exactly why the habit never gets corrected by feedback. Per cor:urn:010:01, `::` is v1; v2 is flat single-colon and the platform has emitted it since #697/#720. - memory refs `hrn:memory:<org>::<slug>` -> `hrn:mem:<org>:<slug>` (the type word changes too, per the v2 registry) - node refs collapse to a single colon and KEEP/GAIN the `hrn:node:` prefix: a bare v2 node URN has no positional memory-vs-loc split without the type word, and the CLI rejects it (dev:findings:bare-v2-node-urn-ambiguous-to-cli) - `-m <org>:<memory>` args stay bare -- the flag fixes the arity there - shorthand spelled out in full Every site was instructional -- no ownership chains and no accepted-input examples to preserve (dev:conventions:memory-audit-fix-vs-preserve). Every rewritten target verified to resolve. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Closes #8. Part of hadron-memory/hadron-server#866.
|
Caution The consumer version of Gemini Code Assist on GitHub has been sunset. All code review activity has officially ceased. |
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.
Closes #8. Part of hadron-memory/hadron-server#866 — the ecosystem-wide sweep.
CLAUDE.mdis loaded verbatim as mandatory instruction every session, so its v1::URNs actively teach the stale grammar to every agent working in this repo. v1 still resolves forever via the stored alias map, which is precisely why the habit never gets corrected by feedback — nothing ever errors.Per
cor:urn:010:01,::is v1; v2 is flat single-colon and the platform has emitted it since #697/#720.What changed
hrn:memory:<org>::<slug>→hrn:mem:<org>:<slug>— the type word changes too, per the v2 registryhrn:node:prefix. A bare v2 node URN has no positional memory-vs-loc split without the type word, and the CLI rejects it outright — seedev:findings:bare-v2-node-urn-ambiguous-to-cli-m <org>:<memory>args stay bare — the flag fixes the arity there, so the ambiguity doesn't ariseNot a blind sweep
Every site in this file was checked and every one was instructional — no ownership chains (which have no string-derivable v2 form) and no accepted-input examples to preserve, per
dev:conventions:memory-audit-fix-vs-preserve.Every rewritten target was verified to resolve via a batch
hadron_get_nodesread, not assumed.Follows the same transformation as hadron-memory/hadron-server#868. The root cause — the MCP tool descriptions, which reach every agent regardless of local
CLAUDE.md— was hadron-memory/hadron-server#870.