docs: comprehensive Squad workflow guide for engineering team handover#888
Closed
sabbour wants to merge 3 commits into
Closed
docs: comprehensive Squad workflow guide for engineering team handover#888sabbour wants to merge 3 commits into
sabbour wants to merge 3 commits into
Conversation
… docs - Rewrote docs-site/docs/contributing.md with complete Squad process: * Step-by-step issue workflow (triage → DP → worktree → PR → merge) * Design Proposal gate requirements and template * Worktree setup and management (avoiding top-level checkout conflicts) * PR review gates with label-based approval (leela:approved, zapp:approved) * Code review protocol for addressing feedback * Changeset and release requirements * Components, phases, and skill extension guides * Key files and troubleshooting FAQs - Validated against actual Squad process: * .squad/routing.md (issue-to-agent mapping) * .squad/team.md (team roster, capabilities, charter) * .squad/ceremonies.md (DP and PR review gates) * .github/workflows/squad-review-gate.yml (label-based CI gates) - This is the canonical reference for new engineers and contributors - Top-level CONTRIBUTING.md now points to this guide for details Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
…anch The workflow was originally authored in commit 9db4d59 but lived only on branch squad/fix-retro-base-ref which was never merged into main. This restores it verbatim: scans javascript-typescript and actions languages, runs on push/PR to main and weekly on Mondays, and skips retro-log PRs (label retro-log + head ref retro-log/pr-* + bot author). Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Session: 2026-04-20T10:10:21Z — Rewrote docs-site/docs/contributing.md
to explain Squad and Copilot workflow. Published guide now covers:
- Team roster and roles
- squad:{member} label routing
- @copilot capability matrix
- Design Proposal gates
- Worktree usage
- PR review gates
- Local dev setup
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Owner
Author
|
Superseded by the newer Copilot/Squad-first contributing docs rewrite in the current working tree. Closing this older draft so only active work remains on the board. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Description
This PR adds a dedicated "Contributing with Squad" section to the canonical engineering documentation, completing the docs handover for new team members.
What's included
The new guide (
docs-site/docs/contributing.md) provides:Team roster and routing — Complete Squad team, issue assignment flow, member domains
Issue workflow (9 steps)
Best practices
Extension guides
Troubleshooting FAQs — Common questions and when to ask for help
Maintenance norms — Weekly, monthly, and per-PR expectations
Validation
This guide was verified against the actual current Squad process:
.squad/routing.md— Issue-to-agent mapping.squad/team.md— Team roster and capability matrix.squad/ceremonies.md— Design Proposal and PR Review gates.github/workflows/squad-review-gate.yml— Label-based CI approval gatesImpact
Closes #893
Labels: documentation, leela:approved