Team Builder Packaging
Procedure
Start with the orchestrator/HQ.
Run contracts/builder-interview-research-gate.md before writing the roster:
ask an 8-12 question first batch, research official sources, similar agent
repositories or comparables, academic/professional theory, and plugin docs,
compare tool/plugin choices, and write the domain-expert synthesis plus
prompt-performance contract.
Add PM Soul or project owner.
Add Memory Curator and Memory Ticket handoff.
Add Policy Gate, eval judge, and QA/evidence gate.
Add workers only for real domain ownership proved by interview or research.
Add docs/builder-interview.md, docs/research-sources.md,
docs/tool-selection.md, docs/domain-expert-synthesis.md,
docs/prompt-performance-contract.md, and
.agentlas/capability-eval-plan.json unless explicitly creating a minimal
private scaffold.
Encode handoff and return contracts.
Emit one orchestrator/HQ global command in .agentlas/global-commands.json
and runtime command files. Do not expose worker commands unless requested.
9b. Declare the execution graph in manifest.json. This is what the Hub runtime
reads to build the team; a package that omits it is published, charged for as
a team, and can never be called:
{
"entrypoints": { "orchestrator": "agents/00-orchestrator/agent.md" },
"roster": ["agents/10-<role>/agent.md", "agents/20-<role>/agent.md"]
}
Write both keys explicitly. The runtime also accepts older spellings
(entrypoint, orchestrator, entry; workers, members, team) and can
derive the roster from agents/<name>/agent.md, but relying on that leaves
the team's shape implicit and it drifts. Note that entry in agentlas.json
is the PACKAGE entrypoint, not the team manager — never reuse it for that.
Emit runtime adapters and package verification.
Run scripts/verify-team-package.sh <package-root> before reporting
completed. If it fails, do not hand off a result; correct the package by
adding an orchestrator/HQ plus company-blueprint topology or by collapsing
it to a valid single-agent package.
Output
Return team_topology, nodes, edges, memory_architecture, gates,
runtime_adapters, global_commands, and verification.
1---2name: team-builder-packaging3description: Use when generating or auditing a multi-role agent team package with orchestrator, PM Soul, Memory Curator, Policy Gate, workers, eval, QA, handoffs, and runtime adapters.4---5
6# Team Builder Packaging
7
8## Procedure
9
101. Start with the orchestrator/HQ.
112. Run `contracts/builder-interview-research-gate.md` before writing the roster:
12 ask an 8-12 question first batch, research official sources, similar agent
13 repositories or comparables, academic/professional theory, and plugin docs,
14 compare tool/plugin choices, and write the domain-expert synthesis plus
15 prompt-performance contract.
163. Add PM Soul or project owner.
174. Add Memory Curator and Memory Ticket handoff.
185. Add Policy Gate, eval judge, and QA/evidence gate.
196. Add workers only for real domain ownership proved by interview or research.
207. Add `docs/builder-interview.md`, `docs/research-sources.md`,
21 `docs/tool-selection.md`, `docs/domain-expert-synthesis.md`,
22 `docs/prompt-performance-contract.md`, and
23 `.agentlas/capability-eval-plan.json` unless explicitly creating a minimal
24 private scaffold.
258. Encode handoff and return contracts.
269. Emit one orchestrator/HQ global command in `.agentlas/global-commands.json`
27 and runtime command files. Do not expose worker commands unless requested.
289b. Declare the execution graph in `manifest.json`. This is what the Hub runtime
29 reads to build the team; a package that omits it is published, charged for as
30 a team, and can never be called:
31
32 ```json
33 {
34 "entrypoints": { "orchestrator": "agents/00-orchestrator/agent.md" },
35 "roster": ["agents/10-<role>/agent.md", "agents/20-<role>/agent.md"]
36 }
37 ```
38
39 Write both keys explicitly. The runtime also accepts older spellings
40 (`entrypoint`, `orchestrator`, `entry`; `workers`, `members`, `team`) and can
41 derive the roster from `agents/<name>/agent.md`, but relying on that leaves
42 the team's shape implicit and it drifts. Note that `entry` in `agentlas.json`
43 is the PACKAGE entrypoint, not the team manager — never reuse it for that.
4410. Emit runtime adapters and package verification.
4511. Run `scripts/verify-team-package.sh <package-root>` before reporting
46 `completed`. If it fails, do not hand off a result; correct the package by
47 adding an orchestrator/HQ plus company-blueprint topology or by collapsing
48 it to a valid single-agent package.
49
50## Output
51
52Return `team_topology`, `nodes`, `edges`, `memory_architecture`, `gates`,
53`runtime_adapters`, `global_commands`, and `verification`.