╔═══════════════════════════════════════════════════════════════════════════╗
║ ║
║ ██████╗ ███████╗████████╗████████╗██╗███╗ ██╗ ██████╗ ║
║ ██╔════╝ ██╔════╝╚══██╔══╝╚══██╔══╝██║████╗ ██║██╔════╝ ║
║ ██║ ███╗█████╗ ██║ ██║ ██║██╔██╗ ██║██║ ███╗ ║
║ ██║ ██║██╔══╝ ██║ ██║ ██║██║╚██╗██║██║ ██║ ║
║ ╚██████╔╝███████╗ ██║ ██║ ██║██║ ╚████║╚██████╔╝ ║
║ ╚═════╝ ╚══════╝ ╚═╝ ╚═╝ ╚═╝╚═╝ ╚═══╝ ╚═════╝ ║
║ ║
║ ███████╗████████╗ █████╗ ██████╗ ████████╗███████╗██████╗ ║
║ ██╔════╝╚══██╔══╝██╔══██╗██╔══██╗╚══██╔══╝██╔════╝██╔══██╗ ║
║ ███████╗ ██║ ███████║██████╔╝ ██║ █████╗ ██║ ██║ ║
║ ╚════██║ ██║ ██╔══██║██╔══██╗ ██║ ██╔══╝ ██║ ██║ ║
║ ███████║ ██║ ██║ ██║██║ ██║ ██║ ███████╗██████╔╝ ║
║ ╚══════╝ ╚═╝ ╚═╝ ╚═╝╚═╝ ╚═╝ ╚═╝ ╚══════╝╚═════╝ ║
║ ║
║ 🕹️ WITH SQUAD 🕹️ ║
║ ━━━━━━━━━━━━━━━━━ ║
║ Your First Multi-Agent Dev Team ║
║ ║
╚═══════════════════════════════════════════════════════════════════════════╝
Welcome to the future of collaborative AI development!
Where agents work together like a synthwave dream team ✨
Welcome to SQUAD – the ultimate multi-agent development experience! 🚀
In this lab, you'll learn how to orchestrate a team of specialized AI agents that work together to build, improve, and ship code. Forget solo coding sessions – you're about to experience what it's like to have a full development team at your fingertips!
You'll work with the TaskFlow API – a simple task management API that SQUAD will help you transform from a basic starter into a production-ready powerhouse. Think of it as your canvas, and SQUAD as your artistic collective. 🎨
🎯 Mission Objective: Master the art of multi-agent orchestration by letting SQUAD transform a basic API into something awesome!
By the end of this lab, you'll be a certified SQUAD Commander with knowledge of:
- 🧠 The Brain – Strategic planning and task breakdown (your architect)
- 🖐️ The Hands – Code implementation and feature building (your developer)
- 👁️ The Eyes – Code review and quality assurance (your senior reviewer)
- 📢 The Mouth – Documentation and communication (your tech writer)
- 🎭 Ralph – The wildcard agent for specialized tasks (your specialist)
Plus, you'll master:
- ⚙️ Setting up
.squad/configuration from scratch - 📋 Running strategic planning sessions
- 🔄 The full SQUAD dev cycle: plan → implement → review → document → ship
- 💬 Inter-agent communication patterns and workflows
- 🎪 Coordinating multiple agents to build features collaboratively
PLAYER ONE, INSERT YOUR SETUP:
Before you begin your journey, make sure you have these power-ups equipped:
✅ GitHub Account with Copilot access (your ticket to the game)
✅ Node.js 20+ installed (Download here)
✅ Git CLI installed (Download here)
✅ VS Code with GitHub Copilot extension (Get it here)
✅ Copilot CLI installed (Install guide)
Pro Tip: 💡 Run gh copilot --version to verify your Copilot CLI is ready to roll!
LOADING GAME... █████████████████░░░ 95%
git clone https://github.com/EmeaAppGbb/appmodlab-getting-started-with-squad.git
cd appmodlab-getting-started-with-squadnpm installnpm start🎊 SERVER ONLINE! The API should now be running at http://localhost:3000
GET all tasks:
curl http://localhost:3000/tasksPOST a new task:
curl -X POST http://localhost:3000/tasks \
-H "Content-Type: application/json" \
-d '{"title":"Test SQUAD","description":"Learn multi-agent development","priority":"high"}'PUT (update) a task:
curl -X PUT http://localhost:3000/tasks/1 \
-H "Content-Type: application/json" \
-d '{"title":"Updated Task","completed":true}'DELETE a task:
curl -X DELETE http://localhost:3000/tasks/1💚 GREEN LIGHTS? You're ready to level up! 🎮
appmodlab-getting-started-with-squad/
│
├── 📂 src/
│ ├── server.js # Express server setup
│ ├── routes/ # API route handlers
│ └── models/ # Data models (in-memory for now)
│
├── 📂 .squad/ # SQUAD configuration (you'll create this!)
│ ├── brain.md # Planning agent config
│ ├── hands.md # Implementation agent config
│ ├── eyes.md # Review agent config
│ ├── mouth.md # Documentation agent config
│ └── ralph.md # Specialist agent config
│
├── 📄 package.json # Project dependencies
├── 📄 .gitignore
└── 📄 README.md # You are here! 👋
GAME START! 🎮
You've already done this in Quick Start! Check your health bar:
curl http://localhost:3000/tasksAchievement Unlocked: 🏆 API Explorer
Time to assemble your team! Open your Copilot CLI and summon SQUAD:
# Start a Copilot session
copilotOnce inside the Copilot CLI, ask it to help you set up SQUAD:
@Squad Initialize SQUAD for this project with a focus on improving the TaskFlow API
This will create the .squad/ directory with configuration files for each agent.
What just happened? 🤔
You just assembled a team of specialized agents, each with their own expertise!
Achievement Unlocked: 🏆 Squad Leader
Let's meet your team! Each agent has a specific role:
- Role: Strategic planner and architect
- Mission: Analyze the codebase, identify improvements, create task backlog
- Personality: Thoughtful, strategic, sees the big picture
- Role: Implementation specialist
- Mission: Write code, implement features, fix bugs
- Personality: Action-oriented, detail-focused, gets things done
- Role: Code reviewer and quality guardian
- Mission: Review PRs, catch bugs, ensure best practices
- Personality: Critical thinker, quality-obsessed, thorough
- Role: Documentation specialist
- Mission: Write docs, update README, create API documentation
- Personality: Clear communicator, user-focused, accessible
- Role: Wildcard specialist
- Mission: Handle specialized tasks (testing, DevOps, security)
- Personality: Jack-of-all-trades, adaptable, problem-solver
Pro Tip: 💡 Each agent's .md file contains their system prompt, capabilities, and constraints. Customize them to fit your project!
Achievement Unlocked: 🏆 Team Manager
Time to put The Brain to work! Ask the Brain to analyze the TaskFlow API and create an improvement backlog:
In Copilot CLI:
@Brain Analyze the TaskFlow API and create a prioritized backlog of improvements we should make to transform this into a production-ready API
The Brain will:
- 📊 Audit the current codebase
- 🎯 Identify gaps and opportunities
- 📝 Create a prioritized task list
- 🔮 Suggest an implementation order
Expected Output: A detailed markdown file with 8-10 improvement tasks, such as:
- ✅ Input validation for API endpoints
- 🔒 Authentication & authorization
- 🐛 Error handling middleware
- 📊 Request logging
- ✅ Unit tests
- 🚀 CI/CD pipeline
- 📚 OpenAPI/Swagger documentation
- 🔍 Search and filtering
Achievement Unlocked: 🏆 Strategic Vision
Time to bring in The Hands! Let's implement input validation:
@Hands Implement input validation for the POST /tasks endpoint. Ensure title is required, description is optional, and priority is one of: low, medium, high
The Hands will:
- ✍️ Write validation middleware
- 🔧 Update the route handler
- 🧪 Add validation logic
- ✅ Test the implementation
Watch the magic happen! The Hands will create or modify files, add validation logic, and ensure requests are properly validated.
Test it:
# Should fail (no title)
curl -X POST http://localhost:3000/tasks \
-H "Content-Type: application/json" \
-d '{"description":"Missing title"}'
# Should succeed
curl -X POST http://localhost:3000/tasks \
-H "Content-Type: application/json" \
-d '{"title":"Valid Task","priority":"high"}'LEVEL UP! 🎮 You just implemented your first feature with SQUAD!
Achievement Unlocked: 🏆 Feature Shipper
Never merge without a review! Bring in The Eyes:
@Eyes Review the input validation implementation. Check for edge cases, security issues, and best practices
The Eyes will:
- 🔍 Analyze the code changes
- 🚨 Flag potential issues
- ✅ Suggest improvements
- 📋 Provide a review summary
The Eyes might catch:
- Missing edge cases (empty strings, null values)
- Security concerns (injection attacks)
- Performance issues
- Code style inconsistencies
Fix any issues The Eyes identifies before moving on!
Achievement Unlocked: 🏆 Quality Champion
Time for The Mouth to shine! Let's document our new validation:
@Mouth Update the README with information about the new input validation, including request/response examples and error codes
The Mouth will:
- 📝 Write clear, user-friendly documentation
- 🎯 Add usage examples
- 📊 Document error responses
- ✨ Update the API reference
Documentation is love! 💝 Your future self (and teammates) will thank you.
Achievement Unlocked: 🏆 Documentation Hero
COMBO CHAIN ACTIVATED! ⚡
Now that you've mastered the SQUAD cycle, repeat for more features:
Task 2: Error Handling Middleware
@Brain What's next on our backlog?
@Hands Implement global error handling middleware
@Eyes Review the error handling implementation
@Mouth Document the error response format
Task 3: Authentication
@Hands Add JWT authentication to protected routes
@Eyes Security review of the auth implementation
@Mouth Update API docs with authentication guide
Task 4: Unit Tests
@Ralph Create a comprehensive test suite using Jest
@Eyes Review test coverage and quality
@Mouth Add testing documentation to README
Keep the momentum going! 🚀 Complete 2-3 more features from your backlog.
Achievement Unlocked: 🏆 SQUAD Master
Time to reflect! Ask The Brain for a project summary:
@Brain Provide a retrospective of what we built, how SQUAD contributed, and recommendations for next steps
Celebrate your wins! 🎉 You've transformed a basic API into something production-ready with your SQUAD team!
By the end of this lab, your TaskFlow API will include:
✅ Input Validation – Never trust user input again!
✅ Error Handling – Graceful failures with meaningful messages
✅ Authentication – JWT-based auth for protected routes
✅ Request Logging – Track every request for debugging
✅ Unit Tests – Confidence with every deployment
✅ CI/CD Pipeline – Automated testing and deployment
✅ API Documentation – OpenAPI/Swagger for easy integration
✅ Search & Filters – Find tasks by priority, status, etc.
MAXIMUM POWER! ⚡ Your API is now production-ready!
TOTAL PLAYTIME: 2-3 hours
Speedrun Mode: 90 minutes (if you're experienced)
Casual Mode: 3-4 hours (take your time, explore!)
No continues needed! 🎮 Save points are automatic with git commits.
POWER-UP LOCATIONS:
- 📖 SQUAD Documentation – Your strategy guide
- 🤖 GitHub Copilot CLI – Your command center
- 🎯 Multi-Agent Patterns – Advanced tactics
- 💡 Copilot Best Practices – Pro tips
- 🔧 Express.js Documentation – API framework guide
FOR THE BRAVE WARRIORS:
Once you've completed the main quest, try these EXTRA HARD challenges:
Replace in-memory storage with PostgreSQL or MongoDB. Can SQUAD help you migrate?
Add WebSocket support for real-time task updates. Which agent would handle this?
Add organization/team support with data isolation. Security review required!
Add caching, pagination, and rate limiting. Let Ralph handle the DevOps!
Deploy to Azure, AWS, or your preferred cloud. Automate everything!
LEGENDARY STATUS AWAITS! 👑
AVOID THESE TRAPS:
❌ Not committing regularly – Save your progress! Git is your savepoint system
❌ Ignoring The Eyes' feedback – Code reviews exist for a reason
❌ Skipping documentation – Future you will rage quit
❌ Not testing changes – YOLO deploys = game over
❌ Merging without review – Two pairs of eyes > one
Remember: SQUAD works best when you follow the cycle! 🔄
🎮 HIGH SCORE ACHIEVED! 🎮
You've mastered the art of multi-agent development with SQUAD! You're now ready to:
- 🚀 Build production apps with AI assistance
- 🎯 Orchestrate specialized agents for complex tasks
- 💪 Scale your development workflow
- 🌟 Ship faster with higher quality
THE FUTURE IS COLLABORATIVE! 🤝
█▀▀ ▄▀█ █▀▄▀█ █▀▀ █▀█ █░█ █▀▀ █▀█
█▄█ █▀█ █░▀░█ ██▄ █▄█ ▀▄▀ ██▄ █▀▄
Made with 💜 by the GitHub App Innovation GBB Team
Now go build something awesome! 🚀
[PRESS START TO PLAY AGAIN] 🎮
- 💬 Questions? Open an issue in this repo
- 🐛 Found a bug? We welcome PRs!
- 🎯 Feedback? We'd love to hear from you
Remember: In the world of SQUAD, you're never coding alone! 🤝
P.S. – If you enjoyed this lab, give it a ⭐ star on GitHub! Your support means the world! 🌍✨