A Salambo project describes agent behavior and sandbox inputs. It is not a replacement agent server: Salambo runs the model loop in the hosted worker.
support-agent/
├── agent/
│   ├── settings.json
│   ├── system.md
│   ├── skills/
│   │   └── incident-triage/
│   │       └── SKILL.md
│   ├── prompts/
│   │   └── incident-report.md
│   └── extensions/
│       └── support-tools.mjs
├── sandbox/
│   ├── packages.mjs
│   └── workspace/
│       └── README.md
├── salambo.yaml
└── package.json

What each path owns

PathBuilder responsibility
agent/system.mdBase purpose, rules, and response expectations
agent/settings.jsonDefault model, thinking level, and active tools
agent/skills/Reusable, immutable instruction packages
agent/prompts/Named prompt templates
agent/extensions/Sandbox-hosted JavaScript extensions
sandbox/workspace/Seed files copied only into new run workspaces
salambo.yamlDeployment, image, region, egress, environment, secrets, and extension entrypoints

Build-time and runtime paths

The source path and runtime path are intentionally different:
SourceHosted behaviorMutability
agent/system.mdCompiled into the deployment manifestImmutable per deployment
agent/skills/Projected as agent resourcesRead-only
agent/extensions/Loaded by the sandbox extension hostRead-only
sandbox/workspace/Copied to /workspace for a new runMutable and checkpointed
Only /workspace is builder-owned mutable state. Platform runtime files are not exposed through managed agent file tools.

Files Salambo generates

salambo manifest compiles source files into a deployment manifest containing normalized model settings, instructions, skills, prompts, tool declarations, hook subscriptions, and workspace policy. Do not edit the compiled manifest manually.

What does not belong here

  • Salambo, storage, or provider credentials in source files
  • Code that expects access to trusted worker memory
  • Mutable customer work under the immutable agent/ resource projection
Next, write agent instructions and choose the built-in tools needed to carry them out.