Shared Context

Agents often need the same context — coding conventions, repo layout, team policies. The shared/ directory lets you maintain this context in one place and reference it from any agent’s SKILL.md.

How it works

Place files in a shared/ directory at your project root. At image build time, these files are baked into every agent’s container at /app/static/shared/.

my-project/
├── config.toml
├── shared/
│   ├── conventions.md
│   ├── repo-layout.md
│   └── team/
│       └── review-policy.md
├── agents/
│   ├── dev/SKILL.md
│   └── reviewer/SKILL.md

Referencing shared files in SKILL.md

Use direct context injection to include shared files in your agent’s prompt:

## Context

!`cat /app/static/shared/conventions.md`
!`cat /app/static/shared/repo-layout.md`

Each agent chooses which shared files to include. There is no automatic injection — you control exactly what context each agent receives.

Example: coding conventions

Create shared/conventions.md:

# Coding Conventions

- TypeScript strict mode, no `any`
- Use `vitest` for tests, mirror `src/` structure in `test/`
- Prefer named exports over default exports
- Error messages should include enough context to debug without a stack trace

Reference it in agents/dev/SKILL.md:

# Dev Agent

You solve GitHub issues by writing code.

## Context

!`cat /app/static/shared/conventions.md`

## Workflow

1. Read the issue
2. Write the fix following the conventions above
3. Run tests
4. Open a PR

And in agents/reviewer/SKILL.md:

# Reviewer Agent

You review pull requests for correctness and style.

## Context

!`cat /app/static/shared/conventions.md`

## Workflow

1. Read the PR diff
2. Check against conventions
3. Approve or request changes

Both agents now share the same conventions without duplication.

Subdirectories

The shared/ directory supports subdirectories. A file at shared/team/review-policy.md is available at /app/static/shared/team/review-policy.md inside the container.

Cloud deployment

The shared/ directory is included in project deployments.

First Steps

Guides

Concepts

Integrations

Reference

How it works

Referencing shared files in SKILL.md

Example: coding conventions

Subdirectories

Cloud deployment

​How it works

​Referencing shared files in SKILL.md

​Example: coding conventions

​Subdirectories

​Cloud deployment

How it works

Referencing shared files in SKILL.md

Example: coding conventions

Subdirectories

Cloud deployment