Skip to main content
DevOpsSteveGJones

deploy-team

Build a team Docker image from a manifest in .archon/teams/. Resolves plugin paths, generates Dockerfile with additive copy-only, makes plugins read-only, bakes team CLAUDE.md.

Stars
38
Source
SteveGJones/ai-first-sdlc-practices
Updated
2026-05-11
Slug
SteveGJones--ai-first-sdlc-practices--deploy-team
View on GitHubRaw SKILL.md

// install — copy + paste into any project

mkdir -p .claude/skills && curl -fsSL https://raw.githubusercontent.com/SteveGJones/ai-first-sdlc-practices/HEAD/plugins/sdlc-workflows/skills/deploy-team/SKILL.md -o .claude/skills/deploy-team.md

Drops the SKILL.md into .claude/skills/deploy-team.md. Works with Claude Code, Cursor, and any agent that loads SKILL.md files from .claude/skills/.

Deploy Team Image

Build a team-specific Docker image from a team manifest.

Arguments

  • --name <team-name> (required) — team manifest in .archon/teams/<team-name>.yaml
  • --image <tag> (optional) — custom image tag (default: sdlc-worker:<team-name>)

Steps

1. Read and validate the manifest

Read .archon/teams/<team-name>.yaml. Validate:

python3 ${CLAUDE_PLUGIN_ROOT}/scripts/validate_team_manifest.py \
    .archon/teams/<team-name>.yaml \
    --installed-plugins "${CLAUDE_PLUGINS_DIR:-$HOME/.claude/plugins}/installed_plugins.json" \
    --project-root .

If validation fails, report errors and stop. Check status field — refuse to build inactive or decommissioned teams.

2. Verify base and full images exist

docker image inspect sdlc-worker:base >/dev/null 2>&1
docker image inspect sdlc-worker:full >/dev/null 2>&1

If missing, inform user and offer to build them:

bash ${CLAUDE_PLUGIN_ROOT}/docker/build-base.sh
bash ${CLAUDE_PLUGIN_ROOT}/docker/build-full.sh

3. Generate team CLAUDE.md

Use the generate_team_claude_md.py script to create the team's CLAUDE.md from the manifest:

python3 ${CLAUDE_PLUGIN_ROOT}/scripts/generate_team_claude_md.py \
    .archon/teams/<team-name>.yaml \
    --installed-plugins "${CLAUDE_PLUGINS_DIR:-$HOME/.claude/plugins}/installed_plugins.json" \
    --output .archon/teams/.generated/<team-name>-CLAUDE.md

If the project has a CLAUDE.md, concatenate it (project first, team second).

4. Build the team image

bash ${CLAUDE_PLUGIN_ROOT}/docker/build-team.sh <team-name> [--image <tag>]

This generates a Dockerfile with additive copy-only (no prune) and builds the image. The generated Dockerfile and CLAUDE.md go to .archon/teams/.generated/.

5. Update manifest timestamp

After successful build, update image_built in the manifest YAML to current ISO-8601 datetime.

6. Report

Report the following:

  • Image name and tag
  • Image size (from docker image inspect)
  • Agent count and skill count (from manifest)
  • Generated file locations (Dockerfile and CLAUDE.md)