clawteam-dev

Category: Tools & Productivity | Uploader: HKUDS | Downloads: 0 | Version: v1.0（Latest）
This skill should be used when the user asks to "run e2e test", "test clawteam", "end-to-end test", "test agent team", "verify clawteam works", "dev test", or wants to validate the full ClawTeam lifecycle. Runs a complete end-to-end test: cleanup → create team → create tasks with dependencies → spawn agents → wait for completion → verify results → cleanup.
Changelog: Source: GitHub https://github.com/HKUDS/ClawTeam
Directory Structure

Current level: .agents/skills/clawteam-dev/
📄 SKILL.md 8.2 KB
SKILL.md

---
name: clawteam-dev
description: >
  This skill should be used when the user asks to "run e2e test", "test clawteam",
  "end-to-end test", "test agent team", "verify clawteam works", "dev test", or wants
  to validate the full ClawTeam lifecycle. Runs a complete end-to-end test: cleanup →
  create team → create tasks with dependencies → spawn agents → wait for completion →
  verify results → cleanup.
version: 0.1.0
---

# ClawTeam End-to-End Test

This skill runs a full lifecycle test of ClawTeam: cleanup residual state, create a team
with tasks and dependency chains, spawn real Claude agents in tmux, wait for all tasks to
complete, verify results, and clean up.

## Prerequisites

- ClawTeam installed (`pip install -e .` from the ClawTeam repo)
- `tmux` available
- `claude` CLI available
- Current directory is the ClawTeam git repo (for worktree isolation)

## Test Procedure

Follow these steps **exactly in order**. Run each bash block and verify the expected output
before proceeding to the next step.

### Step 1: Cleanup ALL Previous State

Remove **all** residual clawteam teams, worktrees, tmux sessions, and branches from any prior runs.
This ensures a clean slate regardless of what team names were used before or if a previous test crashed.

```bash
# 1. Kill ALL clawteam tmux sessions
for sess in $(tmux list-sessions -F '#{session_name}' 2>/dev/null | grep '^clawteam-'); do
  tmux kill-session -t "$sess" 2>/dev/null
done
echo "tmux sessions cleaned"

# 2. Remove ALL clawteam worktrees
for wt in $(git worktree list --porcelain | grep 'worktree.*/\.clawteam/' | awk '{print $2}'); do
  git worktree remove --force "$wt" 2>/dev/null
done
echo "worktrees cleaned"

# 3. Delete ALL clawteam branches
for br in $(git branch --list 'clawteam/*' | tr -d ' +'); do
  git branch -D "$br" 2>/dev/null
done
echo "branches cleaned"

# 4. Remove all team/task/workspace data (preserve config.json)
rm -rf ~/.clawteam/teams/ ~/.clawteam/tasks/ ~/.clawteam/workspaces/ ~/.clawteam/inboxes/ ~/.clawteam/events/ ~/.clawteam/plans/
echo "data cleaned"

# 5. Verify clean state
echo "=== Verification ==="
git worktree list
git branch --list 'clawteam/*' | grep . || echo "OK: no clawteam branches"
tmux list-sessions 2>&1 | grep '^clawteam-' || echo "OK: no clawteam tmux sessions"
ls ~/.clawteam/ 2>/dev/null
```

**Expected**: Only the main worktree remains, no clawteam branches, no clawteam tmux sessions,
`~/.clawteam/` contains only `config.json`.

### Step 2: Set Leader Identity

```bash
export CLAWTEAM_AGENT_ID="e2e-leader-001"
export CLAWTEAM_AGENT_NAME="leader"
export CLAWTEAM_AGENT_TYPE="leader"
```

These env vars MUST be set for all subsequent commands in this test.

### Step 3: Create Team

```bash
clawteam team spawn-team e2e-test -d "End-to-end test team" -n leader
```

**Expected**: `OK Team 'e2e-test' created`

### Step 4: Create Tasks with Dependencies

Create 3 tasks: 2 independent tasks and 1 dependent task that is blocked until both complete.

```bash
T1=$(clawteam --json task create e2e-test "Implement feature A" -o worker1 -d "Add a hello() function to a new file hello.py" | python3 -c "import sys,json;print(json.load(sys.stdin)['id'])")
T2=$(clawteam --json task create e2e-test "Implement feature B" -o worker2 -d "Add a goodbye() function to a new file goodbye.py" | python3 -c "import sys,json;print(json.load(sys.stdin)['id'])")
T3=$(clawteam --json task create e2e-test "Write tests" -o worker3 -d "Write pytest tests for hello.py and goodbye.py" --blocked-by "$T1,$T2" | python3 -c "import sys,json;print(json.load(sys.stdin)['id'])")
echo "Tasks created: T1=$T1 T2=$T2 T3=$T3"
```

**Expected**: Three task IDs printed. Then verify:

```bash
clawteam task list e2e-test
```

**Expected**: worker1 and worker2 tasks are `pending`, worker3 task is `blocked`.

### Step 5: Spawn Agents

Spawn 3 agents. Each gets its own git worktree and tmux window.

```bash
clawteam spawn --team e2e-test --agent-name worker1 \
  --task "Create hello.py with a hello() function that returns 'Hello, World!'. When done, mark your task as completed and send a summary to leader."

clawteam spawn --team e2e-test --agent-name worker2 \
  --task "Create goodbye.py with a goodbye() function that returns 'Goodbye, World!'. When done, mark your task as completed and send a summary to leader."

clawteam spawn --team e2e-test --agent-name worker3 \
  --task "Write pytest tests in test_all.py for hello.py (hello function) and goodbye.py (goodbye function). When done, mark your task as completed and send a summary to leader."
```

**Expected**: Each prints `OK Agent '<name>' spawned in tmux (clawteam-e2e-test:<name>)` with a workspace path.

### Step 6: Verify Team State

```bash
clawteam team status e2e-test
clawteam board show e2e-test
git worktree list
tmux list-windows -t clawteam-e2e-test
```

**Expected**:
- 4 members (leader + 3 workers)
- Board shows 2 pending, 1 blocked tasks
- 3 worktrees under `~/.clawteam/workspaces/e2e-test/`
- 3 tmux windows

### Step 7: Wait for All Tasks to Complete

Block until all agents finish. Timeout 10 minutes, poll every 5 seconds.

```bash
clawteam task wait e2e-test --timeout 600 --poll-interval 5
```

**Expected**:
- Progress updates as tasks complete (e.g., `1/3 tasks completed`)
- Messages from workers displayed as they arrive
- Final line: `All 3 tasks completed!`
- Exit code 0

### Step 8: Verify Results

```bash
# All tasks should be completed
clawteam task list e2e-test

# Board should show 3 completed, 0 pending/blocked
clawteam board show e2e-test

# Read any remaining inbox messages
clawteam inbox receive e2e-test
```

**Expected**:
- All 3 tasks show status `completed`
- Board shows 3 in COMPLETED column
- Messages from workers summarizing their work

### Step 9: Cleanup

Reuse the same full cleanup from Step 1 to remove everything created during this test.

```bash
# Kill ALL clawteam tmux sessions
for sess in $(tmux list-sessions -F '#{session_name}' 2>/dev/null | grep '^clawteam-'); do
  tmux kill-session -t "$sess" 2>/dev/null
done

# Remove ALL clawteam worktrees
for wt in $(git worktree list --porcelain | grep 'worktree.*/\.clawteam/' | awk '{print $2}'); do
  git worktree remove --force "$wt" 2>/dev/null
done

# Delete ALL clawteam branches
for br in $(git branch --list 'clawteam/*' | tr -d ' +'); do
  git branch -D "$br" 2>/dev/null
done

# Remove all team/task/workspace data (preserve config.json)
rm -rf ~/.clawteam/teams/ ~/.clawteam/tasks/ ~/.clawteam/workspaces/ ~/.clawteam/inboxes/ ~/.clawteam/events/ ~/.clawteam/plans/

echo "E2E test cleanup complete"
```

**Expected**: `E2E test cleanup complete`

### Step 10: Final Verification

```bash
git worktree list | grep -v '^\/' | head -1  # should show only main
git branch --list 'clawteam/*' | grep . || echo "OK: no clawteam branches"
tmux list-sessions 2>&1 | grep '^clawteam-' || echo "OK: no clawteam tmux sessions"
ls ~/.clawteam/teams/ 2>&1 | grep -q "No such file" && echo "OK: no team data"
ls ~/.clawteam/tasks/ 2>&1 | grep -q "No such file" && echo "OK: no task data"
ls ~/.clawteam/workspaces/ 2>&1 | grep -q "No such file" && echo "OK: no workspace data"
```

**Expected**: All lines start with `OK:`.

## Test Variants

### With P2P Transport

Add `--transport p2p` and `export CLAWTEAM_TRANSPORT=p2p` before Step 3 to test ZeroMQ direct messaging with file fallback. The rest of the steps remain the same.

### With subprocess Backend

Replace `clawteam spawn` with `clawteam spawn subprocess claude` to test the subprocess backend instead of tmux. Note: `board attach` and tmux verification steps won't apply.

## What This Test Validates

| Component | Validated |
|-----------|-----------|
| `team spawn-team` | Team creation with leader |
| `task create --blocked-by` | Task dependency chains |
| `spawn` (tmux backend) | Agent process launch with worktree isolation |
| Identity propagation | Env vars passed to sub-agents |
| Agent coordination | Workers update task status and send messages to leader |
| Auto-unblock | Blocked task unblocked when dependencies complete |
| `task wait` | Progress tracking, inbox drain, completion detection |
| `inbox send/receive` | Point-to-point messaging between agents |
| `board show` | Kanban board rendering |
| `workspace` (auto) | Git worktree creation and isolation |
| Cleanup | Worktree removal, branch deletion, data cleanup |
Comments 0
Latest | Hot
Please login before commenting.
No comments yet. Be the first one!
clawteam-dev

Directory Structure

SKILL.md

Report

Notice
