Skip to content

Extension boundary

Atlante v0.1 extends through static packs. It does not provide a plugin runtime, registration hook, lifecycle API, or remote registry.

Use a pack when several projects need the same preset, template, instance, or supporting Markdown. A pack declares its format in package.json:

{
"name": "@acme/review-pack",
"version": "1.0.0",
"atlante": { "format": 1 }
}

Expose a preset through atlante.jsonc and keep resources under the package root:

atlante.jsonc
{
"$schema": "https://atlante.sh/schema/v0.1/schema.json",
"agents": {
"reviewer": "./reviewer"
}
}

The consuming project declares and installs the pack, then selects it with --preset. Atlante reads only the selected static resources and their transitive dependencies.

Atlante does not load JavaScript from a pack, call package registration hooks, install dependencies, consult a registry, load URLs, or execute project code. The OpenCode adapter also reads verified artifacts instead of source packs.

There is no plugin API to implement against in v0.1. Do not depend on internal loader, resolver, validator, builder, or adapter modules as an extension surface. When a future version defines an extension contract, it must be versioned and must preserve the boundary between static content selection, artifact publication, and host execution.

For the supported authoring workflow, read Author a pack and Resources and packs.