How henomis/stiggy works
Stiggy turns YAML or Go configuration into durable multi-agent workflows on packtrail/NATS, then runs agent jobs with phero. The principal path is fleet definition → validated spec → compiled flows and workers → execution results observed through a client. Crews and named patterns expand into flows; exposed and remote agents, human review, memory/knowledge, tracing, and replay are additional capabilities. A separate browser designer edits project documents and compiles them to fleet YAML without connecting to NATS. Relationships for unsampled subsystems are included only where the README documents them.
Main entry points: agentrun.go Agent job runner · assembly.go Runtime assembly · App.tsx Browser designer · design.go Designer API
Components 25
Fleet definition
- YAML loader
config/config.go - Go configuration
options.go - Fleet spec
spec/spec.go - Flow compiler
compile/flows.go - Crews and patterns
patterns/teams.go
Workflow execution
- Runtime assembly
assembly.go - Packtrail engine
- NATS JetStream
- Execution client
stiggy.go
Agent capabilities
- Agent job runner
agentrun/agentrun.go - Job observation
agentrun/observe.go - Memory and storage
registry/builtin_storage.go - Agent exposure
agentrun/expose.go - Human review
agentrun/hitl.go - Remote agents
agentrun/remote.go
Workflow designer
- Browser designer
ui/src/App.tsx - Workflow canvas
ui/src/Canvas.tsx - Block catalogue
ui/src/blocks.ts - Project document
ui/src/project.ts - Designer API
internal/design/design.go - Project compiler
internal/design/project/compile.go
Serving and observability
- stiggy CLI
cmd/stiggy/online.go - Execution tracing
internal/tracing/tracing.go - Component registry
registry/registry.go
Other components
- Fleet author
Connections 27
- Fleet author → YAML loader: defines fleet
- Fleet author → Go configuration: configures Go
- YAML loader → Fleet spec: decodes
- Go configuration → Fleet spec: builds
- Fleet spec → Flow compiler: validates and compiles
- Crews and patterns → Flow compiler: expands to flows
- Flow compiler → Runtime assembly: provides flows
- Runtime assembly → Component registry: builds components
assembly.go - Runtime assembly → Packtrail engine: configures runtime
- Packtrail engine → NATS JetStream: persists executions
- Runtime assembly → Agent job runner: registers workers
assembly.go - Agent job runner → Job observation: records outcomes
agentrun/agentrun.go - Agent job runner → Memory and storage: uses agent memory
- Agent job runner → Human review: requests review
- Agent job runner → Remote agents: invokes remote steps
- Runtime assembly → Agent exposure: serves agents
- Execution client → Packtrail engine: starts and watches
- stiggy CLI → Runtime assembly: runs fleet
- stiggy CLI → Designer API: serves designer
- Browser designer → Workflow canvas: renders canvas
ui/src/App.tsx - Browser designer → Block catalogue: offers blocks
ui/src/App.tsx - Browser designer → Project document: edits project
ui/src/App.tsx - Browser designer → Designer API: calls API
ui/src/App.tsx - Designer API → Project compiler: compiles project
internal/design/design.go - Project compiler → Fleet spec: emits fleet YAML
- Designer API → Component registry: reads catalog
internal/design/design.go - Agent job runner → Execution tracing: creates spans