Guides
Task-oriented guides for common operations in protoWorkstacean.
Available guides
Section titled “Available guides”| Guide | Description |
|---|---|
| Add an agent | Register an in-process agent (YAML + ProtoSdkExecutor) or an external A2A agent |
| Add a domain | Poll a custom HTTP endpoint and expose it as a world-state domain |
| Add goals and actions | Write goal definitions (Invariant, Threshold, Distribution) and matching actions with preconditions and effects |
| Create a ceremony | Schedule a recurring fleet ritual — a skill dispatched on a cron expression |
| Integrate an external app | Connect any service to the GOAP loop as a reactive actor — purely YAML-driven |
| Deploy with Docker | Production deployment: Docker Compose, env vars, workspace volume mount, health check |
Where to start
Section titled “Where to start”If you have just completed the Getting Started tutorial, the natural next guides are:
- Add an agent — bring your own agent into the fleet
- Add goals and actions — let the world engine react autonomously to state changes
- Create a ceremony — schedule recurring work
For background on why things work the way they do, see the Explanation section.