Repository navigation
feat(gh-aw): Generate meet-the-squad.md in repo root #1618
Description
meet-the-squad.md Generation
Part of #1612 (Squad Agentic Workflows epic).
Depends on: #1614 (Cast mode — generates the initial content)
Overview
Every Squad PR includes a meet-the-squad.md at the repo root that introduces the cast. This file serves dual purpose: it's the PR description content AND a permanent onboarding document for anyone discovering the squad.
Content Structure
# Meet the Squad 🎭
> Your AI team, cast specifically for this repository.
## The Team
| Name | Role | Specialty | How to Talk to Them |
|------|------|-----------|---------------------|
| 🎯 Flight | Director | Architecture & product direction | Tag in architectural discussions |
| 🔧 EECOM | Runtime Engineer | Core systems & adapters | Assign runtime/infra issues |
| 🧪 FIDO | Quality Engineer | Testing & CI/CD | Label with `squad:fido` |
| ... | ... | ... | ... |
## How to Work With Your Squad
- **Assign issues** with `squad:{name}` labels
- **Iterate composition** with `/squad cast` and `/squad retire`
- **Check status** with `/squad status`
## What Happened Here
This team was composed based on analysis of your repository:
- **Languages detected:** TypeScript, Python, Go
- **Repo structure:** Monorepo with packages/ directory
- **CI/CD:** GitHub Actions with test + deploy workflows
- **Rationale:** [Why these specific roles were chosen]Mode-Specific Variations
| Mode | "What Happened Here" content |
|---|---|
| Cast | Full analysis rationale (languages, structure, patterns detected) |
| Connect | Notes squad is externally managed, links to source repo |
| Adopt | Notes squad was adopted from source, now locally owned |
Acceptance Criteria
-
meet-the-squad.mdis generated at repo root in every Squad PR - Team table includes: name, role, emoji, specialty, interaction instructions
- "How to Work With Your Squad" section explains label-based assignment
- "What Happened Here" section explains WHY this team was chosen
- Content varies appropriately for Cast/Connect/Adopt modes
- File is valid, well-formatted Markdown
- Serves as effective onboarding doc for new contributors
- Updated when team composition changes (via /squad cast or /squad retire)
Activity
feat(gh-aw): Enrich meet-the-squad.md + auto-include copilot-setup-st…
fix(gh-aw): verify Squad workflow distribution
feat(gh-aw): ship Squad modes with verified consumer bootstrap (#1613-#…