Dewey / Field notes
Documentation as an interface for AI agents
How Dewey turns maintained Markdown into an agent-facing entry point, retrieval map, and source artifacts without requiring a particular documentation website.
- Formats
- Landscape
- Runtime
- 54 seconds at 30 fps
- Delivery
- MP4 · H.264 · AAC · BT.709
- Source
- openscout.app
Transcript
An agent opens a project. Can it find the rules, entry points, and a working example?
Treat documentation as an interface with a maintained entry point. In Dewey, authored Markdown feeds generated agent artifacts.
A short index explains where to go. Raw pages carry the detail; bundles support broader reading.
Keep human explanations and dense agent references aligned. Different reading paths should describe the same current behavior.
You can change the documentation website without changing this approach. Dewey's generated artifacts work without its optional site.
Generation cannot prove the guidance matches the code. Run documented examples, review changes, and check links.
Give agents a reliable starting point and a path to evidence. Maintain that path alongside the software.
Educational diagrams with synthesized English narration. Captions are included in the picture; the optional caption track repeats the same text.
Try the explanation
Sources
Reviewed 2026-10-02. The diagrams illustrate the documented model; they are not a recording of a live agent run.