agent0ai/dox

Self-documenting AGENTS.md

What it solves

AI agents often edit code blindly or lose track of project-wide rules, leading to "drift" and unexpected changes. DOX provides a structured way for agents to maintain and follow precise project context across a codebase.

How it works

DOX is a lightweight framework based on a hierarchy of AGENTS.md files. The agent starts at a root AGENTS.md for project-wide instructions and traverses down to child AGENTS.md files for local guidelines specific to certain areas of the project. Before making any edit, the agent reads this documentation tree to understand the local rules; after making changes, it updates the documentation to keep it current.

Who it’s for

Developers using AI agents (such as Codex, Claude Code, or OpenCode) to manage and edit their software projects.

Highlights

  • Zero installation: No dependencies, packages, or runtimes required.
  • Hierarchical context: Uses a tree of Markdown files to provide local and global instructions.
  • Self-maintaining: The agent updates the documentation as the project evolves.
  • Agent-agnostic: Works with any AI agent that supports reading Markdown files.

Related

  • Project
  • Project
  • Project
  • Project
  • Project