Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

What Flock is / is not

Flock is

  • A coordination runtime — pressure-field scheduler, typed blackboard, episode logs
  • A plugin harness boundaryFlockPlugin::verify_goal drives the default flock run loop
  • An in-tree multiplexer — HerdR-shaped NDJSON socket API + PTY panes
  • A topology evolution loopflock evolve mutates wake maps from episodes
  • Governance-awareflock.toml hooks, tool pipeline, drift-check manifest

Default flock run uses deterministic plugins (gridworld, shell). The scheduler wakes agents from substrate signals — not a manager LLM.

Flock is not

  • An OpenCode / Claude Code clone — no drop-in coding agent with 75 providers on the hot path
  • A meta-harness wrapper — Flock does not wrap external harnesses; it is the runtime
  • A workflow DSL — coordination is the pressure field, not hand-drawn graphs
  • A chat router — agent-to-agent NL handoffs are intentionally forbidden

Honest adoption path

NeedUse
Prove coordination thesisflock run, swarm-demo, Govcraft bench in verify.sh
Editor integrationflock acp (stdio + prompt → engine)
External tool bridgeflock mcp or flock run --mcp
Remote pane farmflock remote --plugin <name> with governance

Flock deliberately does not chase OpenCode/Claude Code feature parity — coordination runtime and honest scope are the product.