claw-code/.guardrails/cmd/team-cli

Team CLI

A command-line interface for managing standardized team layouts across projects.

Overview

The Team CLI provides a fast, intuitive interface for the team management system defined in scripts/team_manager.py. It supports all core team operations including initialization, role assignments, status tracking, and backups.

Installation

From Source

cd cmd/team-cli
make install

Or manually:

cd cmd/team-cli
go build -o team .

Cross-Platform Build

make cross-compile

This creates binaries for:

• Linux (amd64, arm64)
• macOS (amd64, arm64)
• Windows (amd64)

Usage

team [command] [flags]

Global Flags

• -p, --project string - Project name (required for most commands)
• -o, --output string - Output format: text, json (default: text)
• --version - Show version information

Commands

init

Initialize a new project with the standardized 12-team structure.

team init my-project

list

List all teams for a project.

team list -p my-project
team list -p my-project --phase "Phase 1"

assign

Assign a person to a role.

team assign -p my-project -t 7 -r "Technical Lead" --person "Jane Developer"

unassign

Remove a person from a role.

team unassign -p my-project -t 7 -r "Technical Lead"

start

Mark a team as started/in-progress.

team start -p my-project -t 7

complete

Mark a team as completed.

team complete -p my-project -t 7

status

Show project or phase status.

team status -p my-project
team status -p my-project --phase "Phase 1"

validate

Validate team sizes meet the 4-6 member requirement.

team validate -p my-project

phase-gate

Check phase gate requirements.

team phase-gate -p my-project --from 1 --to 2

agent-map

Get team mapping for an agent type.

team agent-map backend
team agent-map security

Supported agent types:

• planner - Team 2, Phase 1
• architect - Team 2, Phase 1
• infrastructure - Team 4, Phase 2
• platform - Team 5, Phase 2
• backend - Team 7, Phase 3
• frontend - Team 7, Phase 3
• security - Team 9, Phase 4
• qa - Team 10, Phase 4
• sre - Team 11, Phase 5
• ops - Team 12, Phase 5

export

Export project data.

team export -p my-project -f json
team export -p my-project -f csv

import

Import team assignments from a file.

team import -p my-project -f data.json --format json
team import -p my-project -f data.csv --format csv

backup

List available backups.

team backup -p my-project

restore

Restore from a backup.

team restore -p my-project -b .teams/backups/my-project_20250215_120000.json.gz

delete

Delete a team or entire project.

# Delete a specific team
team delete -p my-project -t 7

# Delete entire project (with confirmation)
team delete -p my-project

# Force delete without confirmation
team delete -p my-project --force

Examples

Initialize and Setup a Project

# Create new project
team init web-platform

# Assign team members
team assign -p web-platform -t 2 -r "Solution Architect" --person "Alice Johnson"
team assign -p web-platform -t 2 -r "Domain Architect" --person "Bob Smith"
team assign -p web-platform -t 4 -r "Cloud Architect" --person "Carol White"
team assign -p web-platform -t 7 -r "Technical Lead" --person "David Brown"

# Check status
team status -p web-platform

# Validate team sizes
team validate -p web-platform

Check Phase Gate

# Validate phase 1 is complete before moving to phase 2
team phase-gate -p web-platform --from 1 --to 2

JSON Output for Scripting

# Get status in JSON format for automation
team status -p web-platform -o json | jq '.teams[] | select(.phase == "Phase 1")'

Environment Variables

• TEAM_MANAGER_PATH - Path to the team_manager.py script (optional)
• TEAM_ENCRYPTION_KEY - Key for encrypted project data (optional)

Requirements

• Go 1.23.2 or later
• Python 3.x (for team_manager.py backend)
• team_manager.py must be accessible (usually in ../../scripts/ relative to the binary)

Development

Build

make build

Test

make test

Format

make fmt

Lint

make lint

Architecture

The Team CLI is a Go application that wraps the existing team_manager.py Python script. Commands are translated to Python subprocess calls, with output formatted for the terminal using Charm's Lipgloss and Log libraries.

License

Part of the Agent Guardrails Template project.