ContextDoc
The diary of ContextDoc (formerly ConceptDoc), my open source format for giving context to AI agents working on code.
❯ start with part 1ContextDoc: Your Coding Agent Finally Stops Breaking Things
ConceptDoc grew up, changed its name, and — most importantly — learned to stay quiet when it has nothing useful to say. Discover how ContextDoc, .ctx files, and the new ctx-watch and ctx-run tools transform your coding agent into a collaborator that truly understands your code.
ContextDoc Diary: from a 3D Guinea Pig to 0.4, with Numbers
From March to today ContextDoc went from a side project to a package on PyPI: a 3D guinea pig, the rule that forbids agents from rewriting tests, a VS Code extension whose first version didn't even start, and in the end a simple question. Does it work? I measured it: without ContextDoc the agent breaks a documented decision 9 times out of 12, when it reads the .ctx files 0 out of 12.