AGENTS.md@packs git:20260819.db5a4edA

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

# AGENTS.md — `packs/`

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

The pack owns its runtime export and test boundary. `.apm/` is source material
projected into installed adapters; tests and pack documentation are not projected.
Design packs around the user intent, journey, and capability they provide.

## Authoring or editing a skill

The runtime export boundary is `.apm/`: `.apm/adapter-root-bins/`,
`.apm/agents/`, `.apm/commands/`, `.apm/hook-wiring/`, `.apm/hooks/`,
`.apm/kiro-ide-hooks/`, `.apm/shared-libs/`, `.apm/skills/`, and `.apm/user-libs/`.
Do not put tests in `.apm/`; edit skill sources and use the canonical
[catalogue authoring standards](../guides/_shared/reference/catalogue-authoring-standards.md).

`pack.toml` fields belong to the pack JSON Schema. Its top-level tables are
`adapter-contract`, `recipes`, `dependencies`, `seeds`, `layout`, `first-value`,
and `adaptation`; use the schema rather than reproducing field inventories here.

```bash
agentbundle catalogue lint --root . --deep
agentbundle catalogue verify --root .
agentbundle catalogue self-host --root . --write
```

## Version bump rule

Every non-cosmetic pack-content change, including `seeds/**` and `.apm/**`, bumps matching versions in `pack.toml` and
`.claude-plugin/plugin.json`: patch for changed content, minor for new primitives,
and major for removals. Do not borrow an unreleased version from another change.

## Shipped pack content carries no internal-governance citations

Under `packs/`, write portable guidance only. Do not cite this catalogue's internal
records, acceptance criteria, or repository-only paths; state the rule directly.

## Self-hosting projection

`.apm/` is the source of truth. Run self-host after all seed and non-seed pack
edits, and never edit adapter projections directly. For catalogue CI behavior, see
[`catalogue-ci-contract.md`](../guides/_shared/reference/catalogue-ci-contract.md).