Skip to content

Quick Start

Create a hive with one role and one decision, then validate it.

mkdir -p my-hive/roles my-hive/decisions

my-hive/roles/billing.json:

{
  "name": "billing",
  "status": "draft",
  "mission": "Own the billing service and its payment integrations.",
  "autonomy": "prepare",
  "repositories": [
    {"pattern": "github.com/example/billing", "affinity": "steward"}
  ]
}

my-hive/decisions/one-billing-service.json:

{
  "id": "one-billing-service",
  "title": "One service owns billing",
  "status": "accepted",
  "decision": "All charges go through the billing service.",
  "reasons": ["One place to audit every charge."],
  "roles": ["billing"]
}

Validate it and ask who works in the billing repository:

$ plexushive -C my-hive validate
1 role and 1 decision are valid

$ plexushive -C my-hive roles github.com/example/billing
steward      billing              repository

Start the agent's session with its role:

HIVE_ROLE=billing claude --resume <session>

The User Guide covers each step in depth.