Generated by Code IQ · v1.0

squad
Knowledge Tutorial

Squad transforms ephemeral AI chats into a persistent, file-based development team living directly in your repository. It manages AI agents with specific roles (like Frontend or Tester) that possess long-term memory and distinct personalities, allowing them to collaborate on code, follow shared rules, and autonomously handle GitHub Issues through automated workflows.

6
Chapters
-
Subsystems
∞
Rabbit Holes
▶ Start Reading ⎇ View on GitHub
System Architecture

How the pieces fit

squad is organized as connected concepts and components. Start broad, then drill down chapter by chapter.

⚙️
The Coordinator (CLI)
The Coordinator (CLI)
👥
The Agent Model (Cast & Charters)
The Agent Model (Cast & Charters)
⚙️
The Memory Layer (History & Decisions)
The Memory Layer (History & Decisions)
⚙️
The Skills System
The Skills System
🔌
External Integration (MCP & Workflows)
External Integration (MCP & Workflows)
⚙️
Work Routing & Triage
Work Routing & Triage
squad — bash
➜open tutorial
◆ Scanning numbered chapters
◆ Building navigation and Mermaid diagrams
◆ Generating chapter and subsystem pages
✓ 6 chapter pages built
✓ Theme toggle enabled
➜
Repository Overview

Intro and Architecture Diagram

Squad transforms ephemeral AI chats into a persistent, file-based development team living directly in your repository. It manages AI agents with specific roles (like Frontend or Tester) that possess long-term memory and distinct personalities, allowing them to collaborate on code, follow shared rules, and autonomously handle GitHub Issues through automated workflows.

Source Repository: https://github.com/bradygaster/squad

flowchart TD A0["The Coordinator (CLI)"] A1["The Agent Model (Cast & Charters)"] A2["The Memory Layer (History & Decisions)"] A3["Work Routing & Triage"] A4["The Skills System"] A5["External Integration (MCP & Workflows)"] A0 -->|"Initializes and upgrades ro..."| A1 A0 -->|"Installs workflows and config"| A5 A5 -->|"Triggers logic via Actions"| A3 A3 -->|"Assigns tasks to"| A1 A1 -->|"Reads/Writes persistent state"| A2 A1 -->|"Learns procedures from"| A4
Tutorial Chapters

All 6 chapters

Follow sequentially or jump to any topic. Start with The Coordinator (CLI).

Ch.01 CORE
The Coordinator (CLI)
Welcome to the first chapter of the Squad tutorial! Before we meet the AI agents that will help you write code, we need to build the house…
↗
Ch.02 AGENTS
The Agent Model (Cast & Charters)
In the previous chapter, The Coordinator (CLI), we built the "office" (.ai-team/) where our digital employees will live. Now, it's time to…
↗
Ch.03 CORE
The Memory Layer (History & Decisions)
In the previous chapter, The Agent Model (Cast & Charters), we hired our team. We gave them names (like Ripley and Dallas) and personalitie…
↗
Ch.04 CORE
The Skills System
In the previous chapter, The Memory Layer (History & Decisions), we gave our agents a memory. They can remember what happened yesterday ("I…
↗
Ch.05 ADVANCED
External Integration (MCP & Workflows)
In the previous chapter, The Skills System, we taught our agents how to do things by giving them "Skill Books" (like how to deploy code or…
↗
Ch.06 CORE
Work Routing & Triage
In the previous chapter, External Integration (MCP & Workflows), we gave our agents "hands" to use tools and "ears" to listen for GitHub ev…
↗
About This Project

Generated by Code IQ

This tutorial was automatically generated by Code IQ and rendered with the shared tutorial site builder. It can be produced for any repository tutorial folder that follows the numbered markdown chapter layout.

View Code IQ ↗
python build_site.py '/home/runner/work/Code-IQ/Code-IQ/output/squad'

// → 6 chapters
// → source: bradygaster/squad