Browse documentation

Project layout reference

Reference for files compiled into an agent deployment and files used as sandbox inputs.

project/
├── .pi/
│   ├── settings.json
│   ├── SYSTEM.md
│   ├── skills/
│   │   └── <skill>/SKILL.md
│   ├── prompts/
│   │   └── <prompt>.md
│   └── extensions/
│       └── <extension>.mjs
├── sandbox/
│   ├── packages.json
│   └── workspace/
├── salambo.yaml
└── package.json

Compilation mapping

Source	Manifest destination
`.pi/settings.json`	Model and thinking-level defaults
`.pi/SYSTEM.md`	Base system prompt input
`.pi/skills/**/SKILL.md`	Skill resources
`.pi/prompts/*.md`	Prompt-template resources
`.pi/extensions/*`	Hosted extension manifest
`sandbox/packages.json`	Managed image package declaration
`sandbox/workspace/`	Immutable new-run workspace seed
`salambo.yaml`	Deployment, sandbox and runtime settings

Runtime paths

Path	Owner	Mutability
`/workspace`	Run	Mutable and durable
`/workspace/.salambo/agent/skills`	Deployment projection	Read-only to managed tools

All other runtime files are platform-owned and unavailable through managed agent file tools.

Source archive exclusions

Deployment excludes common generated and dependency directories such as:

.git
node_modules
dist
.next
.turbo
coverage

Keep required deployment inputs outside generated directories.

Previoussalambo.yaml reference