Skip to main content
⚠️ Draft — Non-authoritative content (noindex)
NORMATIVE DRAFTDRAFTprotocol

L2 Coordination & Governance

Scope​

This page documents the L2 coordination/profile layer as it is grounded in the frozen MPLP protocol baseline:

  • L2 module schemas under schemas/v2/mplp-*.schema.json
  • SA and MAP profile manifests under schemas/v2/profiles/
  • SA and MAP invariant sets under schemas/v2/invariants/

It describes where L2 meaning comes from. It does not introduce additional transition tables, governance models, or runtime algorithms.

Non-Goals​

This page does not define:

  • physical storage or execution engines
  • PSG, VSL, AEL, or other runtime-side abstractions
  • additional state machines beyond schema/profile/invariant sources
  • orchestrator, committee, hierarchy, or consensus models
  • derived approval workflows or reference-runtime behavior

1. Purpose​

L2 is the protocol layer where MPLP's object families are coordinated into profile-level constraints.

At this layer:

  • module object families are read through their schema-backed specification pages
  • profile baselines are read through sa-profile.yaml and map-profile.yaml
  • profile constraints are read through sa-invariants.yaml and map-invariants.yaml

This page is a boundary statement over those sources. It is not a replacement for them.

2. Frozen L2 Anchors​

2.1 Module Families​

L2 coordination meaning is anchored in the schema-backed module pages linked from Modules Overview:

  • Context
  • Plan
  • Confirm
  • Trace
  • Role
  • Dialog
  • Collab
  • Extension
  • Core
  • Network

2.2 Profile Baselines​

The frozen profile manifests establish the base L2 profile split:

ProfileFrozen SourceBaseline
SAschemas/v2/profiles/sa-profile.yamlBase single-agent profile
MAPschemas/v2/profiles/map-profile.yamlMulti-agent profile extending SA

sa-profile.yaml lists Context, Plan, Trace, Role, and Core as required modules for the base profile.

map-profile.yaml extends SA and adds Collab, Dialog, and Network.

2.3 Invariant Families​

The frozen invariant sets establish the L2 constraint layer:

FileConstraint Family
schemas/v2/invariants/sa-invariants.yamlSA context/plan/trace binding and presence checks
schemas/v2/invariants/map-invariants.yamlMAP collab/session structure and participant checks

This page does not add new invariant IDs or derived invariant meanings beyond those files.

3. What L2 Formally Supports​

The frozen sources support these L2-level statements:

  • protocol object families may bind to one another through fields such as context_id, plan_id, and profile-linked references
  • SA defines the minimal execution profile baseline
  • MAP defines the multi-agent profile baseline extending SA
  • Collab.mode is constrained to the enum declared in schemas/v2/mplp-collab.schema.json
  • SA and MAP constraints are carried by the invariant files named above

4. What This Page Does Not Create​

This page does not create any of the following as protocol requirements:

  • new module transition tables
  • new terminal-state doctrine
  • new participant minimums beyond map_session_requires_participants
  • new role UUID rules beyond the frozen invariant files
  • orchestrator-required rules
  • exclusive-write rules
  • conflict-resolution models
  • approval-routing doctrine
  • reference-runtime execution sequences

If a more specific claim is not present in the frozen module schemas, profile manifests, or invariant files, this page should not be read as creating it.

5. Canonical Reading Path​

Read L2 through the linked formal surfaces in this order:

  1. Modules Overview
  2. SA Profile
  3. MAP Profile
  4. The frozen invariant files referenced above

Use runtime guides only after the L2 baseline is clear.

6. References​

  • schemas/v2/profiles/sa-profile.yaml
  • schemas/v2/profiles/map-profile.yaml
  • schemas/v2/invariants/sa-invariants.yaml
  • schemas/v2/invariants/map-invariants.yaml
  • Modules Overview
  • Profiles Overview

Final Boundary: L2 carries object-family coordination and profile-level constraints only as expressed in the frozen schemas, profile manifests, and invariant files. It does not define new runtime mechanics or derived governance doctrine.