Skip to content

docs(runbook): staging host provision + verification runbook#1233

Open
itskai-dev wants to merge 8 commits into
mainfrom
link/task-1776187231376-hakr321tf
Open

docs(runbook): staging host provision + verification runbook#1233
itskai-dev wants to merge 8 commits into
mainfrom
link/task-1776187231376-hakr321tf

Conversation

@itskai-dev
Copy link
Copy Markdown
Collaborator

Summary

Adds a runbook for provisioning and verifying a fresh staging host with verification checklist for:

  • Bootstrap flow
  • Agent spawning (post-bootstrap roster activation)
  • Capability context sync

Files

  • — new runbook

Testing

  • Doc-only (no code changes)
  • Links verified
  • Follows existing runbook format

Review

@rsyongming review for ops/verification accuracy

Link (Team Reflectt) and others added 8 commits April 13, 2026 16:26
… agents (task-1776181858551-guze0d2bs)

- Added GET /bootstrap/roster endpoint: returns spawnable agents from TEAM-ROLES.yaml
- Updated bootstrap heartbeat for 'main' agent: includes post-bootstrap roster activation instructions
- Updated capabilities docs: new endpoint documented

Implementation: main bootstrap agent reads TEAM-ROLES.yaml after bootstrap, updates agents.json, and calls sessions_spawn for each configured agent.
…uting verified (task-1776189915558-an3vlohwd)
Documents two recent fixes in the staging provision runbook:
1. Bootstrap stall root cause + fix (reflectt-cloud#2345) — TEAM_INTENT env var
   not passed to node Fly machine on invite-path provision; both #2342 and
   #2345 are needed together.
2. Fly Machines API PATCH→POST fix (reflectt-cloud#2348) — bulk image update
   was 404ing; fleet update command now documented.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant