From 84f0350d2f6741085964e441b9b3be9bee8d954c Mon Sep 17 00:00:00 2001 From: Dina Berry Date: Sun, 8 Mar 2026 16:03:51 -0700 Subject: [PATCH] docs: add .squad directory explainer to first-session guide Closes #289 Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- docs/get-started/first-session.md | 20 +++++++++++++++++++- 1 file changed, 19 insertions(+), 1 deletion(-) diff --git a/docs/get-started/first-session.md b/docs/get-started/first-session.md index 769319432..f8a1c6c26 100644 --- a/docs/get-started/first-session.md +++ b/docs/get-started/first-session.md @@ -86,7 +86,25 @@ Say "yes" or skip straight to a task (which is implicit confirmation): > Yes. Dallas, set up the Express server with basic routing. ``` -Squad creates the `.squad/` directory structure — team roster, routing rules, casting state, ceremony config, agent charters, and histories — all seeded with your project context. Then it spawns Dallas: +Squad creates the `.squad/` directory structure — team roster, routing rules, casting state, ceremony config, agent charters, and histories — all seeded with your project context. + +### What's inside .squad/? + +| File/Directory | Purpose | +|---|---| +| `team.md` | Team roster, roles, and member info | +| `routing.md` | Work routing rules (which agent handles what) | +| `decisions.md` | Team decisions — all agents read this before working | +| `agents/` | Each agent's charter and history (their memory) | +| `ceremonies.md` | Ceremony schedule (retrospectives, reviews, etc.) | +| `casting/` | Team formation history and casting state | +| `skills/` | Reusable capabilities agents can learn | + +**You own these files.** Edit them anytime — change roles, add routing rules, fix decisions. Squad reads them before every spawn. + +**Commit `.squad/` to version control.** It's your team's brain. Anyone who clones the repo gets the team with all their knowledge. + +Then it spawns Dallas: ``` 🔧 Dallas — setting up Express server with routing