@package-system
Team
team[] — ready-made agent characters a package ships, with their settings and identity files.
team/<slug>/ ships a ready-made agent character — package-provided base
configuration for the agent-creation flow:
team/
search-agent/
member.json # slug, name, role, description, config, permissions, appearance
identity/ # *.md identity files injected for this member
files/ # *.md additional member filesmember.json carries the create-agent shape:
{
"slug": "search-agent",
"name": "Search",
"role": "assistant",
"description": "What this coworker is for, and when to pick it.",
"config": {
"settings": {
"maxSteps": 15,
"defaultModelId": "provider/model-id",
"guardProfile": "balanced"
}
},
"permissions": { "sources": ["brain"], "features": ["core.agents"] },
"appearance": { "icon": "search", "color": "#3b82f6" }
}A team directory without a member.json is skipped.
Four rules that are easy to get wrong
descriptionis the field that reaches a model. A member may also carrydescriptionForModel, but nothing reads a member's copy — only the package-leveldescriptionForModelis advertised. Put the "when to pick this coworker" sentence indescription.- Pin a model and a guard posture inside
config.settings, asdefaultModelIdandguardProfile. There is no top-levelmodel,icon, orcolorkey — appearance nests underappearance. - Identity placeholders substitute once, at provisioning. When an agent is
created from the member, each
identity/*.mdandfiles/*.mdis copied into the agent's own data directory with a fixed eight-key substitution:{{agentId}},{{agentName}},{{createdAt}},{{packageId}},{{memberSlug}},{{role}},{{projectId}},{{userId}}. There is no per-turn re-substitution, and{{conversationId}}is not in the set — write it and it ships to the model literally. Dotted forms such as{{user.name}}ship literally everywhere. - Identity-file frontmatter is stripped, not parsed.
activation,pinned, andpriorityon an identity file do nothing; injection order is fixed by filename, so name the files in the order you want them read.
A spawn-time sub-agent persona is an agent instead.
A workflow template can name a member through
teamMemberSlug (validated, but no runtime reads it yet).