AGENTS.md@packages/agentbundle/agentbundle/_data/catalogue-scaffold/profiles git:20260820.8a4971bA

Immutable. This exact content is served forever at /api/v1/blob/34fba229a4e8bd1b.

# AGENTS.md — `profiles/`

Applies to `profiles/`. Inherits the root `AGENTS.md`. Scope-specific deltas only.

## Profile boundary

A profile is a hand-authored `profiles/<id>.toml` that composes an ordered,
single-scope set of existing packs; it introduces no primitives. The filename stem
is its identifier. Reserved `_` children are authoring assets, not active profiles.

## Validation and ownership

`profile.schema.json` owns fields and semantic validation. Read it with
`agentbundle catalogue contracts show profile.schema.json`. Profile TOML is the
source; profiles are scaffold sources but are not projected by `catalogue self-host`.

- A pack name appears at most once in a profile.
- Packs with a declared `conflicts` relationship do not share a profile.

## Essential commands

```bash
agentbundle catalogue lint --root .
agentbundle catalogue verify --root .
agentbundle list-profiles <catalogue>
```

## Deeper pointers

Start from `profiles/_example/profile.toml`.