| name | cave-blackboard |
| description | N agents read and write a shared state over rounds, with a mutator that folds each contribution in and an optional adjudicator (stigmergy arena). Use for agents collaborating on a shared board, a market, a workspace they all see. `blackboard()`. |
Blackboard — a shared-workspace arena
The arena / stigmergy core: N agents ↔ a shared state ↔ a mutator ((board, name, value) -> board) over rounds, with an optional adjudicator Link. The gameworld's core building block.
Native API (how you program)
from cave_teams import blackboard
from cave_teams import register_fn
def keep_latest(board, name, value): return {**board, name: value}
arena = blackboard({"a": a, "b": b}, keep_latest, adjudicator=judge, rounds=3)
The mutator is required and is a Python callable. For the cave() spec, register it by name (register_fn) and reference the name — that's the callable axis of extending the metacontrol surface.
Via cave() (drive it from data)
{"op": "blackboard", "agents": {"a": <spec>, "b": <spec>},
"mutator": "keep_latest", "rounds": 3}
If the spec is malformed, cave() returns {"status": "construction_error", "hint": "read the cave-blackboard skill"} — the error names this skill.
See also
cave-season · cave-world · cave
Part of the cave-teams plugin — the language + full DSL is the cave-teams skill; drive any pattern from data with the cave skill.
