I wanted to give AmblerTS, my Deno/TypeScript state-machine framework, the ability to record non-obvious learnings that would otherwise require significant context to reconstruct across sessions.
I turned to the classic note-taking methodology developed by the German sociologist Niklas Luhmann: the Zettelkasten (German for slip box). The methodology is elegantly simple: take atomic notes, link them explicitly to related ones, and organise them so they can be retrieved precisely when they become relevant again.
The Concept
The idea translates naturally to agentic coding:
Describe the protocol in an AGENTS.md file, a convention that coding agents like Gemini and Claude read as project-level instructions.
