Repository navigation
docs(gh-aw): consolidate slash command reference into a single table - #1755
Merged
Merged
Conversation
The command reference was split across four category-grouped tables, which made it hard to scan the full surface at once. Merge them into one table with a Category column, preserving all 27 commands and their notes. Also note the longest-prefix-first matching rule, which explains why `/squad plan accept scope` does not resolve to `/squad plan`. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: 1057dff0-c7a0-4524-a5a7-d38b3eebdaa3
Contributor
🟢 Impact Analysis — PR #1755Risk tier: 🟢 LOW 📊 Summary
🎯 Risk Factors
📦 Modules Affecteddocs (1 file)
This report is generated automatically for every PR. See #733 for details. |
Contributor
🛫 PR Readiness Check
PR Scope: 🔧 Infrastructure
|
| Status | Check | Details |
|---|---|---|
| ❌ | Single commit | 2 commits — consider squashing before review |
| ✅ | Not in draft | Ready for review |
| ❌ | Branch up to date | dev is 1 commit(s) ahead — rebase recommended |
| ❌ | Copilot review | No Copilot review yet — it may still be processing |
| ✅ | Changeset present | No source files changed — changeset not required |
| ✅ | Scope clean | No .squad/ or docs/proposals/ files |
| ✅ | No merge conflicts | No merge conflicts |
| ✅ | Copilot threads resolved | 0 active Copilot thread(s) resolved (1 outdated skipped) |
| ✅ | CI passing | All checks passing |
Files Changed (1 file, +32 −46)
| File | +/− |
|---|---|
docs/src/content/docs/guide/gh-aw.md |
+32 −46 |
Total: +32 −46
This check runs automatically on every push. Fix any ❌ items and push again.
See CONTRIBUTING.md and PR Requirements for details.
Contributor
There was a problem hiding this comment.
Pull request overview
Consolidates the GitHub Agentic Workflows guide’s /squad slash command reference into a single table and adds a brief note explaining the command matcher’s longest-prefix-first behavior, improving scanability and reducing duplication in the docs.
Changes:
- Collapse the previously separated command tables into one unified table with a
Categorycolumn. - Document longest-prefix-first command matching with an illustrative example.
Show a summary per file
| File | Description |
|---|---|
| docs/src/content/docs/guide/gh-aw.md | Reworks the slash-command reference into a single categorized table and adds a note about longest-prefix-first matching. |
Review details
💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.
- Files reviewed: 1/1 changed files
- Comments generated: 1
- Review effort level: Lite
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
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
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.
Rescues the one genuinely-unmerged commit (
4efc8474, 2026-08-17) from three stale branches before they are deleted in the branch cleanup.Why this was almost lost
Three branches --
bradygaster-document-gh-aw-sdlc,bradygaster-cautious-sniffle, andintegration/dispatch-inputs-and-cast-frontmatter-- all descend fromb0b4ac9e, whose commit message matches PR #1722. That PR merged, so nearly all of their content is already ondev. Verification:origin/devbradygaster-cautious-snifflebradygaster-document-gh-aw-sdlcA two-dot diff
origin/dev..bradygaster-document-gh-aw-sdlcis -787 lines: the branch is mostly just missing dev's newer work from #1741, #1742, #1744, #1747, and #1752. Its entire unique contribution is this single-file docs commit.Cherry-picked onto current
devrather than merging the branches, which still carry thedefault: 'cast'dispatch input that #1752 removed.What it does
Collapses five separate command tables (Team management / Research and planning / Acceptance and activation / Implementation) into one table with a
Categorycolumn, and documents the longest-prefix-first matching rule -- which explains why/squad plan accept scoperesolves to scope-acceptance rather than to/squad plan.No commands lost
/squad ...commandsRow count rises because the unified table re-lists commands that previously shared a row; the set of distinct commands is unchanged. Diffed the extracted command strings both directions -- nothing dropped.
Cherry-picked cleanly with no conflicts.