miniblog.

There's something pleasingly self-referential about configuring an agent by talking to it. > Remember that [fact about data formats]. Agent: Noted. ... realise nothing happened ... > Write to your rules file that when I say "remember", I want you to write to the rules file.

It's so hard to talk about probabilities. Casual conversation often conflates 'the likelihood of an event happening' with 'how strongly I believe in my assessment'. For example, I'm very confident (say 90%) that the coin in my pocket is 50% likely to land on heads.

There are docs resources like https://diataxis.fr/ that categorise documents based on format and intended audience. They don't say where you should start, or what order you should write docs. I'm currently thinking README > reference > tutorial > how-tos. Agree/disagree?