Repo-Local Documentation System for Humans & Agents
Summary
The article introduces a repo-local Markdown documentation system designed to help both humans and AI agents understand a codebase by providing durable, near-code documentation. It outlines how to structure docs, coordinates via AGENTS.md, and uses templates for system, flow, and ADR documentation, plus a local viewing tool (MDTS). The goal is to keep documentation close to code, up-to-date, and useful for safe changes and onboarding.