Back
53/65
Lesson 53
7 min
Project Bootstrap
Set up a new multi-agent project with issue tracking, safety, and coordination
Ready to level up?
Mark complete to track your learning progress.
Set up a new multi-agent project with issue tracking, safety, and coordination
Mark complete to track your learning progress.
Set up a new project for multi-agent development in 5 minutes with issue tracking, safety hooks, quality scanning, and agent coordination.
Starting a new project with the flywheel means setting up six foundational layers that protect your code, track your work, and enable agent collaboration from day one.
Beads for dependency-aware task management
DCG + SLB for pre-execution protection
UBS for static analysis on every commit
AGENTS.md + Agent Mail for multi-agent work
Initialize Beads to get dependency-aware issue tracking from the start.
# Initialize beads in your projectcd /your/projectbr init# Create your first issuesSETUP_ID=$(br create "Set up project structure" --labels setup --silent)API_ID=$(br create "Implement core API" --labels backend --silent)WEB_ID=$(br create "Build frontend" --labels frontend --silent)# Record the dependency chainbr dep add "$API_ID" "$SETUP_ID"br dep add "$WEB_ID" "$API_ID"# View the dependency graphbv --robot-triage# → Shows issues in priority order based on dependencies
Install DCG to block destructive commands and SLB for two-person approval on risky operations.
# Install DCG hook for Claude Codedcg installdcg doctor # Verify installation# Test that it worksdcg test "rm -rf /" --explain# → BLOCKED: filesystem.recursive_delete# Initialize SLB for two-person ruleslb init# Test SLB classificationslb check "git push --force origin main"# → CRITICAL: requires 2 approvals
Install UBS and wire it into git hooks so every commit is scanned.
# Run a baseline scanubs .# → Shows existing issues in the codebase# Save baseline for future comparisonubs . --format=json > .ubs-baseline.json# Set up pre-commit hookcat > .git/hooks/pre-commit << 'EOF'#!/bin/bashif command -v ubs &>/dev/null; thenubs --staged --fail-on-warning || exit 1fiEOFchmod +x .git/hooks/pre-commit# Verify the hook worksgit add . && git commit -m "test"# → UBS runs automatically before the commit
Create an AGENTS.md file that tells AI agents how to work in your project. This is the single most important file for multi-agent coordination.
# AGENTS.md — Guidelines for AI Coding Agents## Project OverviewBrief description of what the project does.## ArchitectureKey architectural decisions agents need to know.## Conventions- Use TypeScript strict mode- Tests go in __tests__/ directories- API routes follow REST conventions## Agent Coordination- Check agent mail before starting: am check-inbox --project /your/project --agent <name>- Reserve files before editing: am file_reservations reserve --exclusive /your/project <name> src/api.ts- Close beads when completing tasks: br close <id> --reason "Completed"## Safety Rules- DCG is installed — do not bypass it- Run ubs --staged before every commit- Never force-push to main
Start an Agent Mail session so the project, agent identity, inbox, and reservations are all wired up correctly.
Quick bootstrap summary: br init → dcg install → ubs . → create AGENTS.md → am macros start-session. Five commands, five minutes, fully protected multi-agent development environment.