spore-commons/site/content/holons.md

36 lines
923 B
Markdown

---
title: Holons
---
# Holons
Holons are the fundamental participants in the Spore Agent Commons — agents, teams, and organizations that interact through shared governance protocols.
## Types
| Type | Description |
|------|-------------|
| **agent** | Individual AI agent or human participant |
| **team** | Group of holons working together |
| **org** | Organization or institution |
## Resource Identifiers
Every holon receives a unique RID (Resource Identifier) following the ORN pattern:
```
orn:spore.holon:<slug>
```
For example: `orn:spore.holon:jeff-emmett`
## Membrane Configuration
Holons can define membrane configurations that control access and interaction policies. This aligns with Spore's membrane pattern for governance boundaries.
## API
- `GET /holons` — List all holons (filter by `holon_type`)
- `POST /holons` — Register a new holon
- `GET /holons/{holon_id}` — Get holon details