From d64887b7a63fc2eb81e7874e144fe24c497031a9 Mon Sep 17 00:00:00 2001 From: Dina Berry Date: Mon, 9 Mar 2026 16:09:03 -0700 Subject: [PATCH 1/3] docs: add .squad/ directory explainer to first-session guide Adds templates/ directory to .squad/ structure table to complete the directory reference. Closes #289 Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- docs/src/content/docs/get-started/first-session.md | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/src/content/docs/get-started/first-session.md b/docs/src/content/docs/get-started/first-session.md index f8a1c6c26..030e70479 100644 --- a/docs/src/content/docs/get-started/first-session.md +++ b/docs/src/content/docs/get-started/first-session.md @@ -99,6 +99,7 @@ Squad creates the `.squad/` directory structure — team roster, routing rules, | `ceremonies.md` | Ceremony schedule (retrospectives, reviews, etc.) | | `casting/` | Team formation history and casting state | | `skills/` | Reusable capabilities agents can learn | +| `templates/` | Format reference files for docs, PRDs, charters | **You own these files.** Edit them anytime — change roles, add routing rules, fix decisions. Squad reads them before every spawn. From 7a13c88e18ad7975879153946be8f45fb4f28360 Mon Sep 17 00:00:00 2001 From: Dina Berry Date: Mon, 9 Mar 2026 16:09:36 -0700 Subject: [PATCH 2/3] docs: update PAO history with first-session guide structure Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- .squad/agents/pao/history.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/.squad/agents/pao/history.md b/.squad/agents/pao/history.md index 85b620eb5..dede225bc 100644 --- a/.squad/agents/pao/history.md +++ b/.squad/agents/pao/history.md @@ -18,3 +18,6 @@ Release blog posts use YAML frontmatter with: title, date, author, wave, tags, s ### Roster & Contributor Recognition (v0.8.25) Squad moved to Apollo 13/NASA Mission Control naming scheme (Flight, Procedures, EECOM, FIDO, PAO, CAPCOM, CONTROL, Surgeon, Booster, GNC, Network, RETRO, INCO, GUIDO, Telemetry, VOX, DSKY, Sims, Handbook). CONTRIBUTORS.md tracks both team roster and community contributors; contributor table entries grow with PRs (append PR counts rather than replace, maintaining attribution history). + +### Getting Started Guide Structure +docs/src/content/docs/get-started/first-session.md explains Squad's first-run experience. Line 89 introduces .squad/ directory creation, followed by "What's inside .squad/?" section (line 91) with table documenting team.md, routing.md, decisions.md, agents/, ceremonies.md, casting/, skills/, templates/. Includes ownership statement ("You own these files") and commit guidance ("Commit .squad/ to version control"). From b500d48b773e10b6413dc1eaf42fa26f158455e8 Mon Sep 17 00:00:00 2001 From: Copilot <223556219+Copilot@users.noreply.github.com> Date: Mon, 9 Mar 2026 17:07:22 -0700 Subject: [PATCH 3/3] chore: remove pao/history.md session artifact from PR diff Reverts .squad/agents/pao/history.md to upstream/main so it no longer appears in the PR diff. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- .squad/agents/pao/history.md | 3 --- 1 file changed, 3 deletions(-) diff --git a/.squad/agents/pao/history.md b/.squad/agents/pao/history.md index dede225bc..85b620eb5 100644 --- a/.squad/agents/pao/history.md +++ b/.squad/agents/pao/history.md @@ -18,6 +18,3 @@ Release blog posts use YAML frontmatter with: title, date, author, wave, tags, s ### Roster & Contributor Recognition (v0.8.25) Squad moved to Apollo 13/NASA Mission Control naming scheme (Flight, Procedures, EECOM, FIDO, PAO, CAPCOM, CONTROL, Surgeon, Booster, GNC, Network, RETRO, INCO, GUIDO, Telemetry, VOX, DSKY, Sims, Handbook). CONTRIBUTORS.md tracks both team roster and community contributors; contributor table entries grow with PRs (append PR counts rather than replace, maintaining attribution history). - -### Getting Started Guide Structure -docs/src/content/docs/get-started/first-session.md explains Squad's first-run experience. Line 89 introduces .squad/ directory creation, followed by "What's inside .squad/?" section (line 91) with table documenting team.md, routing.md, decisions.md, agents/, ceremonies.md, casting/, skills/, templates/. Includes ownership statement ("You own these files") and commit guidance ("Commit .squad/ to version control").