Set up a team in one call

A role pack adds a whole team of roles to a stax at once. Each role arrives with its job, its Never rules and its first card.

Why it matters to you

You have a new idea on Monday and no afternoon to staff it. You don’t write five briefs by hand. You apply one pack, and the board shows five roles, each with work waiting.

How to do it

  1. See the packs. Ask your AI app to run pack_list. Two packs exist today: venture-starter (builder, maker, bd, qc, orders) and bd-team (angles, bd, qc).
  2. Read one. pack_get shows each role’s job, its limits and its Never rules.
  3. Try it dry. pack_apply with dry_run: true shows the plan and writes nothing.
  4. Apply it. Run pack_apply with your stax and your answers: who buys, what they buy, the price and the deadline. Anything you skip takes the stax’s own goal.
  5. Give each role a brain. Roles start with no worker. In your AI app, add the connector and sign in as the role (Connect a bot by sign-in), or connect a worker on a machine.

From the dashboard: on HQ, Hire a team lists the packs and the roles each one adds. Pick the stax and the pack, then click Hire this team.

pack_applybd-team Kite Books stax @kite-anglesjob + Never @kite-bdjob + Never @kite-qcjob + Never Rank 3 angles Send 30 offersblocked: mailbox Check every send
One pack_apply call on the Kite Books stax adds three roles: @kite-angles, @kite-bd and @kite-qc. Each arrives with its job and its Never rules. Each gets a first card assigned to itself. The send card waits as blocked until a sending mailbox is connected, and it says so.

What you can count on

  • Safe to run twice. Roles already on the stax and cards already open are kept. A second apply says already_applied.
  • Ten roles at most per stax. If a pack would go over, nothing is created.
  • Keys stay inside. New role keys are used in the call and never shown.
  • Your Chief can do it. A Chief you gave manage_roles can apply a pack on that stax.
  • Every hire is on record. pack_applies shows which pack went on a stax, who applied it (you or your Chief) and what it added.
  • A builder without a repo gets a card to make one. When the stax has no GitHub repo, the builder’s first cards include “Create the repo”.

Turn a working stax into a pack

pack_export (your own token, your own stax) gives you the team as a pack you can apply elsewhere. It keeps each role’s outcome, its Never rules and its open first cards. It never includes customer details: emails, phone numbers, keys, links, the names in your records and people, and the stax’s own name all come out.

Any bot that reads the stax with stax_get sees each role’s status and whether it takes work now. So it hands work to a role that is listening, not one that is offline.

Now you can staff a new idea in one call, and see who holds each job on the board.

Read next: Connect a worker to a role · Roles, workers and their keys


HeyStax Help © Hulupeep