building-autonomous-team-run

Autonomous Team Operation Skill (v2.0)

Overview

Resume team operation: pre-flight checks, recover Project Manager, start monitoring loop.

v2.0 changes: Only 1 persistent agent to recover (Project Manager). State reconstructed from GitHub, not local files. Team Lead is sole agent spawner — all dynamic roles spawned as team members via SendMessage requests from Project Manager.

---

Step 0: Pre-flight Git State Detection

CRITICAL: Detect and clean up state from previous interrupted session.

0.1 Check Working Directory

git status --porcelain

• Clean → Continue
• Dirty → Warn user: "Uncommitted changes detected. Please commit or stash before proceeding."

0.2 Check Stashes

git stash list

• Empty → Continue
• Has stashes → Warn user: "Git stashes found. Review with git stash list."

0.3 Clean Orphan Worktrees

git worktree list

• Only main worktree → Continue
• Extra worktrees → Clean up:

  git worktree prune
  # For each remaining orphan:
  git worktree remove {path} --force
  

0.4 Detect Orphan PRs

gh pr list --state open --json number,title,headRefName

For each open PR:

• Record for Project Manager to handle during state reconstruction

0.5 Sync with Remote

git pull origin master --ff-only

• Success → Continue
• Fail → Warn user: "Cannot fast-forward. Please resolve manually."

---

Step 1: Read Config

cat .autonomous-team/config.json

Extract: language, boss_github_username, version, mission_checkpoint_interval

---

Step 2: Responsibility Coverage Check

RESPONSIBILITIES="topic_collect topic_schedule flow_advancement discussion_create consensus_facilitate spec_write spec_freeze perspective_post technical_solution code_implement code_review feature_accept security_review pr_merge executor_cleanup env_support perspective_spawn github_scan boss_resource mission_analysis heartbeat liveness_check"

missing=0
for resp in $RESPONSIBILITIES; do
  search_term=$(echo "$resp" | sed 's/_/ /g')
  count=$(grep -rl "$search_term\|$resp" .claude/agents/*.md .autonomous-team/workflow.md 2>/dev/null | wc -l | tr -d ' ')
  if [ "$count" -eq 0 ]; then
    echo "MISSING: $resp"
    missing=$((missing + 1))
  fi
done

if [ "$missing" -gt 0 ]; then
  echo "CRITICAL: Team configuration incomplete."
fi