# Project layout reference

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

```text
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:

```text
.git
node_modules
dist
.next
.turbo
coverage
```

Keep required deployment inputs outside generated directories.