Agent Morphogenesis
Quickstart

Agent Morphogenesis quickstart

This quickstart demonstrates source behavior locally. It does not deploy a production control plane or authorize real external effects.

Prerequisites

  • Node.js 20.19.3 or newer;
  • pnpm;
  • an AgentPlat checkout using one coordinated package version.
git clone https://github.com/Agentplat/agentplat.git
cd agentplat
pnpm install
pnpm example:agent-morphogenesis

Additional examples exercise advanced topology operators and strategy adaptation:

pnpm example:agent-morphogenesis:advanced
pnpm example:agent-morphogenesis:strategy-adaptation

Minimal integration shape

import {
  createMorphogenesisNeedV1,
  createMorphogenesisPolicyV1,
  createMorphogenesisProposalV1,
  MorphogenesisExecutionRuntimeV1,
} from "@agentplat/collective-runtime/morphogenesis";

A real integration must provide more than these constructors. It supplies:

  1. authenticated and freshness-checked morphology source heads;
  2. a closed MorphogenesisPolicyV1 or MorphogenesisPolicyV2;
  3. a policy-selected decision adapter;
  4. a separately issued execution authorization and fence;
  5. concrete Membership, Team, Work, Action and lifecycle ports;
  6. durable stores for process state, morphology head and receipts; and
  7. rollback witnesses and idempotent effect reconciliation where required.

Recommended adoption sequence

  1. Start with recruit_existing and an in-memory store.
  2. Add an authorized-agent, authorized-person or collective decision adapter.
  3. Persist Workflow and Morphogenesis state in PostgreSQL.
  4. Add Agent Room projections for review and observability.
  5. Add Agent Mesh only when multiple independently executing peers need to exchange bounded evidence.
  6. Enable advanced V2 operators individually.
  7. Enable V3–V8 only with explicit policies, evidence collection and rollback plans.

Fail-closed expectations

Do not continue when a required source is missing, stale, rolled back, equivocating or from another scope. Do not treat a proposal as a decision, a decision as an action grant, or an action grant as evidence that an effect committed. Exact receipts close each boundary.

Continue with Governance and Authority and the API Reference.

OverviewGovernance and Authority