KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#developer-tools #codex #typescript #ai-agents #claude-code #dsh #dsh-plugin #deepseek-harness #cli #macos #ai-agent #open-source

openab-map

★ 55 Open GitHub ↗

Agent-maintained human understanding layer for openab — structured mental map for deployers and contributors

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# OpenAB Mental Map

> A living, agent-maintained understanding layer for [OpenAB](https://github.com/openabdev/openab) — the open Agent Client Protocol broker.

This repo is auto-updated by an agent workflow that watches beta releases on openab `main`, diffs what changed, and rewrites affected sections. Every file traces back to a source commit SHA in `.sync-state`.

**If you're new → start at [What is OpenAB](./00-what-is-openab.md)**

---

## Map Layers

| Layer | What it answers |
|-------|----------------|
| [00 · What is OpenAB](./00-what-is-openab.md) | One-page pitch. The problem, the solution, what it is not. |
| [01 · Core Concepts](./01-core-concepts/) | The 8 ideas you must internalize before anything clicks. Includes the [OAB MCP Facade](./01-core-concepts/mcp-facade.md) *(unreleased, `main`)* and [reactions mapping](./01-core-concepts/reactions-mapping.md). |
| [02 · Mental Models](./02-mental-models/) | How the pieces fit — data flows, topology, sequences. |
| [03 · Use Cases](./03-use-cases/) | "I want to do X" → here's how. Includes [driving an agent from an ACP client](./03-use-cases/drive-agent-from-acp-client.md), [browser control from chat](./03-use-cases/browser-control-from-chat.md) *(unreleased, `main`)*, [PR contribution lifecycle](./03-use-cases/contributing-pr-lifecycle.md), and the [Jelli governed community bot setup](./03-use-cases/run-a-governed-community-bot.md). |
| [04 · Decision Trees](./04-decision-trees/) | Should I use X or Y? Structured branching choices. |
| [05 · Change Digest](./05-change-digest/LATEST.md) | Plain-English summary of recent openab changes. |

---

## How This Repo Stays Current

```
openab/beta push or daily schedule
        ↓
  GitHub Action: compute diff since last sync
        ↓
  Claude agent: reads diff + current map
        ↓
  Rewrites affected sections + updates LATEST.md
        ↓
  Opens PR
        ↓
  Multi-agent review via openab b2b
        ↓
  Auto-merge on consensus
```

The agents doing the review run through openab itself — the same system being documented. See the repo's agent sync workflow.

---

## Tracked Source

- **Repo:** `openabdev/openab`
- **Branch:** `main` (beta release tags, currently `v0.10.0-beta.2`)
- **Last synced SHA:** see [`.sync-state`](./.sync-state)

---

## Contributing

This map is agent-maintained but human-correctable. If a section is wrong or missing:

1. Open an issue describing the gap
2. Or open a PR — the next agent sync will reconcile your changes against the source

Priority areas that benefit most from human input: decision trees, use-case narratives, and "gotchas" that aren't visible from the code alone.

openab-map

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README