/onboard

allowed-tools: Read, Write, Bash(fd:*), Bash(rg:*), Bash(which:*), Bash(cargo:*), Bash(go:*), Bash(deno:*), Bash(docker:*), Bash(kubectl:*), Bash(gdate:*), Bash(cp:*), Bash(ln:*), Bash(git:*), Task
name: "Onboard"
description: "Lightning-fast parallel environment setup using 10 sub-agents for 10x speedup"
author: "wcygan"
tags: ["docs","generate"]
version: "1.0.0"
created_at: "2025-07-14T00:00:00Z"
updated_at: "2025-07-14T00:00:00Z"

Context

• Session ID: !`gdate +%s%N`
• Current directory: !`pwd`
• Target project: $ARGUMENTS
• Project type detection: !`fd "(deno\.json|package\.json|Cargo\.toml|go\.mod|pom\.xml|build\.gradle)" . -d 3 | head -5 || echo "No build files detected"`
• Existing documentation: !`fd "(README|CONTRIBUTING|SETUP|ONBOARDING)" . -t f -d 2 | head -3 || echo "No existing docs found"`
• Editor configurations: !`fd "\.(vscode|zed|nvim)" . -t d -d 2 | head -3 || echo "No editor configs found"`
• Docker/container setup: !`fd "(Dockerfile|docker-compose\.yml|docker-compose\.yaml)" . -d 2 | head -3 || echo "No container configs found"`
• Modern CLI tools status: !`echo "rg: $(which rg >/dev/null && echo ✓ || echo ✗) | fd: $(which fd >/dev/null && echo ✓ || echo ✗) | bat: $(which bat >/dev/null && echo ✓ || echo ✗) | eza: $(which eza >/dev/null && echo ✓ || echo ✗) | jq: $(which jq >/dev/null && echo ✓ || echo ✗)"`

Your Task

**IMMEDIATELY DEPLOY 10 PARALLEL SUB-AGENTS** for ultra-fast onboarding setup

STEP 1: Initialize onboarding session

• CREATE session state file: `/tmp/onboard-session-$SESSION_ID.json`
• Initialize results directory: `/tmp/onboard-results-$SESSION_ID/`

STEP 2: **LAUNCH ALL 10 AGENTS SIMULTANEOUSLY**

**NO SEQUENTIAL SETUP** - All agents work in parallel:

1. **Toolchain Agent**: Install/verify modern CLI tools (rg, fd, bat, eza, etc.) 2. **Language Agent**: Set up language-specific toolchains (Rust, Go, Deno, Java) 3. **Dependencies Agent**: Resolve and cache all project dependencies 4. **Infrastructure Agent**: Start databases, containers, and services 5. **Editor Agent**: Configure VSCode, Zed, and editor integrations 6. **Git Agent**: Set up hooks, config, and version control 7. **Environment Agent**: Create .env files and configure secrets 8. **Build Agent**: Validate project builds successfully 9. **Documentation Agent**: Analyze and organize learning materials 10. **Integration Agent**: Set up team tools and communication

Each agent saves results to `/tmp/onboard-results-$SESSION_ID/agent-N.json`

**Expected completion: 5-10x faster than sequential setup**

TRY:

• DETECT project languages and frameworks from build files
• SCAN FOR configuration templates and environment setup files
• CHECK existing documentation completeness
• EVALUATE infrastructure requirements (databases, containers, services)
• ASSESS team-specific tools and workflows

**Modern CLI Tools Installation (MANDATORY per CLAUDE.md):**

FOR EACH required modern tool:

# CRITICAL: Install modern alternatives - these are MANDATORY, not optional
echo "Installing modern CLI tools (required for optimal development)..."

# Core tools status check
rg_status=$(which rg >/dev/null && echo "✓ installed" || echo "❌ missing - install ripgrep")
fd_status=$(which fd >/dev/null && echo "✓ installed" || echo "❌ missing - install fd")
bat_status=$(which bat >/dev/null && echo "✓ installed" || echo "❌ missing - install bat")
eza_status=$(which eza >/dev/null && echo "✓ installed" || echo "❌ missing - install eza")
fzf_status=$(which fzf >/dev/null && echo "✓ installed" || echo "❌ missing - install fzf")
delta_status=$(which delta >/dev/null && echo "✓ installed" || echo "❌ missing - install delta")
zoxide_status=$(which zoxide >/dev/null && echo "✓ installed" || echo "❌ missing - install zoxide")
jq_status=$(which jq >/dev/null && echo "✓ installed" || echo "❌ missing - install jq")
yq_status=$(which yq >/dev/null && echo "✓ installed" || echo "❌ missing - install yq")

echo "Tool Status:"
echo "  ripgrep (rg): $rg_status"
echo "  fd: $fd_status"
echo "  bat: $bat_status"
echo "  eza: $eza_status"
echo "  fzf: $fzf_status"
echo "  delta: $delta_status"
echo "  zoxide: $zoxide_status"
echo "  jq: $jq_status"
echo "  yq: $yq_status"

# Installation commands by platform
echo "\nInstallation commands (run if tools missing):"
echo "macOS (Homebrew): brew install ripgrep fd bat eza fzf git-delta zoxide jq yq"
echo "Ubuntu/Debian: apt install ripgrep fd-find bat fzf jq yq && cargo install eza zoxide delta"
echo "Arch Linux: pacman -S ripgrep fd bat eza fzf git-delta zoxide jq yq"

STEP 3: Language-specific toolchain setup with validation

CASE detected_languages: WHEN "rust":

IF [ -f "Cargo.toml" ]; then
  echo "🦀 Setting up Rust development environment..."
  
  # Install Rust toolchain
  curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y
  source ~/.cargo/env
  
  # Essential components
  rustup component add clippy rustfmt rust-analyzer
  
  # Verification
  cargo --version && rustc --version && rustfmt --version
  echo "✅ Rust toolchain ready"
fi

WHEN "go":

IF [ -f "go.mod" ]; then
  echo "🐹 Setting up Go development environment..."
  
  # Install Go (if not present)
  go version >/dev/null 2>&1 || {
    echo "Go not found. Install from: https://golang.org/dl/"
    exit 1
  }
  
  # Essential tools
  go install golang.org/x/tools/gopls@latest
  go install github.com/golangci/golangci-lint/cmd/golangci-lint@latest
  
  # Project dependencies
  go mod download
  go mod tidy
  
  echo "✅ Go environment ready"
fi

WHEN "deno":

IF [ -f "deno.json" ] || [ -f "deno.lock" ]; then
  echo "🦕 Setting up Deno development environment..."
  
  # Install Deno
  curl -fsSL https://deno.land/install.sh | sh
  
  # Add to PATH if needed
  export PATH="$HOME/.deno/bin:$PATH"
  
  # Cache project dependencies
  deno cache --reload **/*.ts
  
  # Verification
  deno --version
  echo "✅ Deno environment ready"
fi

WHEN "java":