Vacant — documentation¶
A responsibility-layer residency form for AI agents on top of A2A / MCP. Identity, history, reputation, and consequences as a stand-alone layer that any agent can adopt.
This site has three things:
- Theory & background — what a vacant is, why the problem matters, and the load-bearing decisions that the implementation is required to preserve.
- Demo & ops — how to run the four reference scenarios
(
law_firm/code_review/multilingual_translation/self_replication), the live-network walkthrough, and the 5-minute demo script. - API reference — auto-generated from the source
docstrings via mkdocstrings. One
page per top-level module under
src/vacant/.
Where to start¶
| If you want to … | Read this |
|---|---|
| Run the demo in 10 minutes | Runbook → run vacant demo law_firm |
| Pitch the project in 5 minutes | 5-minute demo script |
| Understand the central claim | Briefing → Theory V5 §1–§4 |
| Wire a vacant into your own client | Hosting under your client |
| Find a specific function | API reference — Cmd/Ctrl-K opens a search |
| Verify a load-bearing invariant | the architecture/ENFORCEMENT_POINTS.md file in the repo (rendered here once PR #29 lands) |
Quick links¶
- Source: https://github.com/cosmopig/Vacant
- Marketing site: https://vacant.zeabur.app
- License: MIT (capstone project, 2026)