| name | team-bootstrap |
| description | Leadがこのtemplateから新しいprojectを初期化するために、人間へ一度に一つずつ質問し、構築物、stack、entrypoint、post-change、smoke、visual verificationを決めてManagerへ依頼するときに使う。 |
team-bootstrap
現在状態の確認
次のファイルと、すでに存在するproject fileを確認する。
AGENTS.md
README.md
Makefile
.agents/docs/TEAM_PROTOCOL.md
.agents/state/STATE.md
.agents/state/MEMORY.md
pyproject.toml、package.json、pnpm-workspace.yamlなどのpackage metadata。
- source directoryとtest directory。
人間との対話
最初に「何を作るか」を一つだけ質問する。
回答を受けたら、確定した内容を短く示し、次の判断を最も進める質問を一つ選ぶ。
repositoryと依頼から確定できる内容は質問しない。
人間が選びやすくなる場合は、選択肢と推奨案を添える。
一度に複数の質問を並べない。
初期化の要件が固まるまで、実装とtask割り当てを始めない。
次の内容を必要な順に決める。
- 構築するものと利用者。
- library、CLI、service、application、package、scriptなどの提供形態。
- 主な言語、runtime、そのecosystemで標準的なtoolchain。
- package名と公開entrypoint。
- 最初に成立させる利用者向けの挙動。
make post-changeで実行するformat、lint、typecheck、build、test。
make smokeで確認する代表的な利用者向けの挙動。
- frontendがある場合の起動方法、操作方法、screenshot、確認する状態。
stackが決まった後、具体的な初期値が必要な場合はstack-contracts.mdを読む。
Projectの検証command
make post-changeは、Implementation Workerが変更後に実行する一つのcommandとする。
- 選んだstackの標準的なpackage manager、formatter、linter、test runner、必要なbuildまたはpackage commandを設定する。
make post-changeには、format、lint、必要なtypecheck、build、test、git diff --check -- .を含める。
- 複数packageがある場合は、対象directoryを明示し、一つの
post-changeから各packageの検証を呼ぶ。
make smokeは、代表的な利用者向けの挙動を短時間で実行するcommandとする。
- frontendがある場合は、同じ画面と状態を再現できるvisual verificationを
AGENTS.mdへ記載する。
- 必要なlockfileを作る。
- 必須toolがない場合は、見つからないcommandを示してblockerとして報告する。
初期化するファイル
templateの記述を、実際のprojectに合わせて更新する。
README.md:project名、目的、install、実行方法、主要entrypoint、検証command。
AGENTS.md:team共通ルールに加え、実際のstack、source directory、test、visual verificationの情報。
Makefile:projectのpost-changeとsmoke。
- package metadata:package名、version、description、entrypoint、build backend、lockfile。
.agents/config/agent-team.yaml:変更が必要な場合のteam名、session名、agent、CLI、model、effort、固定Supervisor。
選ばなかったstack、未使用のscaffold、templateのproject名、実際には使わないcommandを残さない。
Managerへの引き継ぎ
初期化の要件が固まったら、Managerへintakeを送る。
intakeには次の内容を含める。
- project名、目的、最初の利用者向け挙動。
- 選んだstackと必要なtool。
- package名とentrypoint。
make post-changeの内容。
make smokeで確認する挙動。
README.md、AGENTS.md、Makefile、package metadataの更新内容。
- 初期化後に削除するscaffold。
- Managerが追加承認なしで進められる範囲。
- Leadへ判断を戻す条件。
人間にはtmuxからdetachし、repository rootで次のcommandを実行してもらう。
make bootstrap-team
このcommandはLeadのpaneを残したまま、その他のroleを起動する。
初期化の完了条件
make post-changeが成功する。
make smokeが成功する。
- deliverableにbuildが必要な場合は
make post-changeに含まれている。
README.md、AGENTS.md、Makefile、package metadata、agent team設定が実際のprojectを説明している。
- source、test、lockfile、必要な設定が存在する。
- 未使用のscaffold、stack command、placeholderのproject名が残っていない。
.agents/skills/team-bootstrap/が削除されている。
- bootstrap専用のMake targetが削除されている。
.agents/scripts/team_bootstrap.shと.agents/scripts/team_bootstrap_team.shが削除されている。
- 削除したbootstrap commandへの参照が残っていない。