2026-07-06 Mon
Filed
Updated
#tag links to [[wikilink]] form on committext:fix-invisible mise task, that rewrites Logseq #tag and #[[Page]] links into [[...]] form — one obvious way to link (Py/Zen of Python), and the shape Looksyk can import, since it reads [[...]] but not #tag.# also begins headings, hex colors, shell comments, and URL fragments, so the converter has to skip fenced and inline code, ignore # before a space or another #, and treat # as a link only at a word boundary. Scope it to .md files under pages/ and journals/, where well over a thousand inline # links live today.That's why example 1 (wrap/linebreak) felt like a non-example to you — an unfamiliar reader doesn't obviously know what linebreak does, so spelling it out is earning its place under the real preference, even though the spec's current wording would tell an agent to omit it.
❯ in what universe does this make sense?
> ### Requirement: Link rationale is not narrated into the config
> A config comment carries the garden link. It SHALL NOT explain the linking rule itself
— for example, why the link points at an entity page rather than a preference page.
Comments can still say what a file or setting is; they just don't explain the linking
convention.
to me, this is just terrible. It's so terrible I can't even really articulate what
preference I should add to my knowledge garden so as to guide AI away from this. I keep
noticing that AI puts into rules explicit instructions not to do things ... that it
should be obvious one should never do. Imagine a parenting guidebook that said, "when
teaching your child how to tie their shoes, you must never push them into the water."
the instruction in the 2nd part of the phrase doesn't have anything to do with the
first part of the phrase. In what world would it make sense to make a comment that
itself explains how and why the comment is being made?
⏺ You've named the actual disease, not just a symptom. This requirement only exists
because AI narrates its own instruction-following into things it produces. But "don't
narrate why you added a link" isn't a fact about how garden links work — it's a symptom
of that one general AI failure mode, bolted onto this one spec as if it were a
link-formatting rule. Your shoe-tying analogy is exactly right: the two halves of the
sentence have no real relationship to each other except that AI needed reminding not to
misbehave, and someone decided the reminder belonged wherever the misbehavior happened
to show up last.
The general fix already exists, once, in the one place it belongs: the "No Recipe in the
Cake" AI rule, loaded into every session via .claude/rules/. A domain spec about how
links work shouldn't also carry a copy of "and don't narrate yourself while doing this"
— that's not a property of links, it's a standing constraint on AI's writing that
applies everywhere, all the time, already.
I think the right move is to delete this requirement entirely from garden-entity-links
Poetry to PyPoetrydeptrust