From 941117fc7dcda628ddce9aa7ed06de9d1651aa80 Mon Sep 17 00:00:00 2001 From: Holger Selover-Stephan Date: Tue, 4 Aug 2026 08:09:54 +0200 Subject: [PATCH] docs: switch CLAUDE.md to the v2 URN grammar 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:::` -> `hrn:mem::` (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 :` 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 Closes #2. Part of hadron-memory/hadron-server#866. --- CLAUDE.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/CLAUDE.md b/CLAUDE.md index 9fc2e7a..ffb8e6d 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -84,9 +84,9 @@ No database, no Prisma, no migrations, no keys at rest — nothing to set up. This tool has no memory of its own — work against the shared ones: -- `hrn:memory:hadronmemory.com::dev` — findings, conventions, the +- `hrn:mem:hadronmemory.com:dev` — findings, conventions, the capability-tool pattern (`capability-tool-pattern`), deploy runbook -- `hrn:memory:hadronmemory.com::specs` — product specs (`cor:web:020*` is the +- `hrn:mem:hadronmemory.com:specs` — product specs (`cor:web:020*` is the web-search capability contract this tool implements) Query Hadron before reading code/design (`hadron_find_nodes` → `hadron_get_node`),