2026-07-03 Fri

so much Word/Salad

ugh. AI keeps writing things into my plans to "never" do something that's completely unrelated, e.g. while building an iPhone app, "never talk to a brown cow" (it's usually not that unrelated - but that's how it feels). So often, AI expressions collapse into an always/never binary.
so many double negatives.
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.

regarding My/AI/Rule/No Recipe in the Cake - new My/AI/Rule/Prune useless commandments

❯ 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

Filed
Updated
- added a line on flowery synonyms
  - My/Pref/Writing/Use the simpler word
- added new Neuralese examples
  - Word/Salad
- clarified the explain-arcane-settings guidance
  - My/Pref/Dev/Management/Configuration/Comment Style
- documented a same-day violation of the rule
  - My/AI/Rule/No Recipe in the Cake
- noted the experimental skills-vendoring technique
  - My/Pref/Dev/AI/Config/Management/Rulesync
- renamed Poetry to PyPoetry
  - PyPoetry/Concept/How to handle Monorepos in Poetry vs uv
  - PyPoetry/Concept/Misconception - Disadvantages of Pip vs Poetry
- renamed and rewrote the CLI setup tutorial for the official readwise cli
  - Readwise/CLI/Tutorial/Install and Log In
- repointed Scarvy's rw-cli link after the tutorial rename
  - Person/Scott Carvalho
- updated with deptrust
  - Security/DevSecOps/Taxonomy
- updated with official readwise cli
  - Readwise/CLI

2026-07-03 Fri

so much Word/Salad

Filed

Updated

3 Linked References

Unlinked References