Skip to content

docs(gh-aw): consolidate slash command reference into a single table - #1755

Merged
bradygaster merged 2 commits into
devfrom
squad/consolidate-slash-command-table
Aug 20, 2026
Merged

bradygaster merged 2 commits into
devfrom
squad/consolidate-slash-command-table

Conversation

@bradygaster

Copy link
Copy Markdown
Collaborator

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, and integration/dispatch-inputs-and-cast-frontmatter -- all descend from b0b4ac9e, whose commit message matches PR #1722. That PR merged, so nearly all of their content is already on dev. Verification:

Branch gh-aw.md size vs dev
origin/dev 40,718 --
bradygaster-cautious-sniffle 40,718 byte-identical
bradygaster-document-gh-aw-sdlc 40,881 +163 bytes

A two-dot diff origin/dev..bradygaster-document-gh-aw-sdlc is -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 dev rather than merging the branches, which still carry the default: '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 Category column, and documents the longest-prefix-first matching rule -- which explains why /squad plan accept scope resolves to scope-acceptance rather than to /squad plan.

No commands lost

dev after
Table rows 31 33
Unique /squad ... commands 27 27

Row 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.

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
Copilot AI lite review requested due to automatic review settings August 20, 2026 07:48
@github-actions

Copy link
Copy Markdown
Contributor

🟢 Impact Analysis — PR #1755

Risk tier: 🟢 LOW

📊 Summary

Metric Count
Files changed 1
Files added 0
Files modified 1
Files deleted 0
Modules touched 1

🎯 Risk Factors

  • 1 files changed (≤5 → LOW)
  • 1 module(s) touched (≤1 → LOW)

📦 Modules Affected

docs (1 file)
  • docs/src/content/docs/guide/gh-aw.md

This report is generated automatically for every PR. See #733 for details.

@github-actions

github-actions Bot commented Aug 20, 2026 •

Copy link
Copy Markdown
Contributor

🛫 PR Readiness Check

ℹ️ This comment updates on each push. Last checked: commit d102e28

PR Scope: 🔧 Infrastructure

⚠️ 3 item(s) to address before review

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.

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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 Category column.
  • 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

Comment thread docs/src/content/docs/guide/gh-aw.md Resolved
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@bradygaster
bradygaster merged commit a49d7b3 into dev Aug 20, 2026
15 checks passed
@bradygaster
bradygaster deleted the squad/consolidate-slash-command-table branch September 9, 2026 19:44
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants