AmpersandBoxDesign AmpersandBoxDesign/docs/index.md
Welcome to the documentation hub for the [&] Protocol.

[&] Protocol Documentation

Part of the [&] Protocol stack · Ecosystem overview · Three-protocol stack · Stack status

Welcome to the documentation hub for the [&] Protocol.

The [&] Protocol is a language-agnostic specification for capability composition in AI agents. It defines how an agent declares what it can remember, how it reasons, how it understands time and space, how it is embodied (perception/action/affordance), how those capabilities compose, and how that declaration can compile into downstream runtime artifacts such as MCP and A2A configurations.

Use this documentation to understand the protocol from multiple angles:

  • Architecture explains the system model, runtime lifecycle, and end-to-end declaration flow.

  • Positioning compares [&] with adjacent standards and research.

  • Competitive Landscape maps the machine cognition market and explains the structural constraints facing each competitor category.

  • Topology Is the Authority explains why governance must emerge from feedback topology, not be bolted onto architecture.

  • Autonomous Systems explains why autonomous vehicles and drone swarms are the canonical [&] use case, including the Palantir integration surface and κ-driven swarm governance.

  • Research provides the motivation for a composition layer in the agent stack.

  • FAQ answers common questions quickly.

  • Ecosystem Overview explains how all twelve products compose through the six primitives.

  • Industry Verticals maps seven commercial industries where all six primitives deliver value.

  • Capability pages explain the six core primitives in more detail.

  • Skills are hands-on, step-by-step guides covering the full declare → validate → compose → generate workflow, plus provider implementation, governance, and integration patterns.

What you'll find here

  • A practical overview of the protocol's role in the agent stack

  • A runtime walkthrough covering declaration → validation → composition → resolution → generation

  • Explanations of capability declaration, contracts, provenance, and governance

  • Comparisons with MCP, A2A, ACP, and related work

  • Deep dives into &memory, &reason, &time, &space, &body, and &govern

  • Skills guides for hands-on implementation — from writing your first ampersand.json to building providers and governance policies

Documentation map

Homepages

Root Docs

[&] Protocol Docs

Capabilities & Registry

Skills

Documentation index

Every page in this documentation set (the linked index below renders on GitHub and in the docs atlas; the toctrees above drive the Sphinx build):

Guides

Capability deep dives

Capability registry

Build prompts

Suggested reading order

If you're new to the project, a good path is:

  1. quickstart — get from clone to a working ampersand CLI in minutes, with reproducible command output

  2. architecture — understand the protocol's responsibilities, runtime lifecycle, and end-to-end declaration flow

  3. runtime-walkthrough — follow a concrete declaration through validation, composition, provider resolution, and generation

  4. positioning — see where [&] fits relative to MCP, A2A, ACP, and DALIA

  5. competitive-landscape — understand the structural constraints facing every competitor category in machine cognition

  6. topology-is-the-authority — why governance must emerge from feedback topology, not be configured on top

  7. research — understand the ecosystem and research pressures behind the design

  8. faq — get quick answers to common adoption and framing questions

  9. Capability deep dives — explore the six core capability families in detail once the runtime model is clear

  10. skills/SKILLS — hands-on implementation skills registry; start here when you're ready to build

  • 01_DECLARATION02_VALIDATION03_COMPOSITION04_CONTRACTS05_GENERATION (core workflow)

  • 06_CLI_REFERENCE (command reference)

  • 07_INTEGRATION_PATTERNS08_PROVIDER_IMPLEMENTATION (advanced)

  • 09_GOVERNANCE_PROVENANCE10_ANTI_PATTERNS (governance and guardrails)

Core idea

A concise framing for the protocol is:

MCP defines how agents call tools. A2A defines how agents call agents. [&] defines how capabilities compose into a coherent agent.

The goal is not to replace existing protocols, but to provide a source-of-truth composition layer that sits above runtime wiring and makes agent architecture explicit, portable, and auditable.

Open in the interactive atlas

links to
The [&] Protocol EcosystemThe Three-Protocol Stack: [&], PULSE, PRISM[&] Stack Completion StatusFive-Minute Quickstart (Elixir Reference CLI)Architecture GuideRuntime Walkthrough[&] Ecosystem Overview — How Everything Ties TogetherThe Missing Layer: Capability Composition in the Agent Protocol StackCompetitive Landscape: Machine CognitionTopology Is the Authority: Why Agent Governance Can't Be Bolted OnAutonomous Systems: The Canonical [&] Use CaseIndustry Verticals: Where All Six Primitives Compose[&] vs MCP vs A2A vs DALIA vs ACPResearch OverviewFAQCapability Registry Pages&memory: Capability Deep Dive&reason: Deliberation, Evaluation, and Decision-Making&time: Temporal Intelligence in the [&] Protocol&space: Spatial Intelligence for Agents&govern: Cross-Cutting Governance for Agents[&] Protocol — Agent SkillsSkill 01 — Writing Agent DeclarationsSkill 02 — ValidationSkill 03 — Capability CompositionSkill 04 — Capability ContractsSkill 05 — GenerationSkill 06 — CLI ReferenceSkill 07 — Integration PatternsSkill 08 — Provider ImplementationSkill 09 — Governance and ProvenanceSkill 10 — Anti-Patterns[&] / CC2 — Capability Composition, v2 (Coalitional)The Compose Runtime — CC2 compose, made authorable (design note)&body.browser&body.os&govern.escalation — Human-in-the-Loop Escalation and Governance Handoff&govern.identity — Agent Identity, Verification, and Trust&govern.telemetry — Observability, Cost Tracking, and Budget Enforcement&memory.episodic — Experience, Session History, and Replayable Context&memory.graph — Graph-Structured Memory Capability&memory.vector -- Semantic Vector Retrieval Capability&reason.argument — Evidence-Weighted Deliberation for the [&] Protocol&reason.attend — Proactive Attention and Bounded Autonomy for the [&] Protocol&reason.deliberate — κ-Aware Deliberation for the [&] Protocol&reason.plan -- Planning-Oriented Reasoning for the [&] Protocol&reason.vote -- Consensus-Oriented Reasoning for the [&] Protocol&space.fleet — Fleet State, Regional Context, and Spatial Operations&space.geofence --- Boundary Membership, Zone Logic, and Compliance Awareness&space.route -- Route Intelligence, Path Optimization, and Explainable Navigation&time.anomaly — Anomaly Detection as a Capability&time.forecast — Forecasting as a Capability&time.pattern — Pattern Detection as a CapabilityAttention Engine — Build Prompt v1[&] Ecosystem — Codex Prompt GuideDual- and Triple-Loop Machine ArchitectureGRAPHONOMOUS_PROMPTκ-Aware Routing — Build Prompt v2 for Graphonomous + BendScriptκ-Driven Deliberation Orchestrator — Build Prompt v1Model Tier Adaptation — Build Prompt v1[&] Protocol — Zed AI Coder Prompt
content id · CIDv1
bagaaiera6x2iqiomwxpirxzy7othprsvdua4egnjtwy4yp3hwxsqoi2vgcwa