What is openab-map?

OpenAB Mental Map is a documentation repository that explains another project called OpenAB, which is described as an open Agent Client Protocol broker. Rather than being written and maintained by people, this repository is kept up to date automatically by software agents that watch the OpenAB codebase for changes and then rewrite the relevant documentation sections to match. The repository is organized into layers that build on each other. It starts with a one-page overview of what OpenAB is, then moves through core concepts, mental models showing how the pieces fit together, practical use cases, and decision trees for choosing between options. There is also a change digest that summarizes recent updates to OpenAB in plain language. Each file in the repository traces back to a specific commit in the OpenAB codebase, so readers can verify that the documentation matches the actual source code at a given point in time. The update process works through GitHub Actions, which is an automation system built into GitHub. When someone pushes changes to OpenAB's beta branch, or on a daily schedule, the system computes what changed since the last documentation update. A Claude agent then reads the changes alongside the current documentation, rewrites the affected sections, updates the change digest, and opens a pull request for review. The review step is itself handled by agents running through OpenAB, meaning the same system being documented is also used to maintain the documentation about it. Humans can still contribute corrections. If a section is wrong or incomplete, anyone can open an issue or submit a pull request. The next automated sync will reconcile those human edits against the source code. The repository's contributors note that decision trees, use case narratives, and subtle gotchas that are not obvious from reading code alone are the areas where human input adds the most value.