docs: FAQ and CLI guidance improvements (#398)#403
Merged
bradygaster merged 3 commits intodevfrom Mar 15, 2026
Merged
Conversation
Owner
Author
FIDO Quality Review — ✅ APPROVEDTest discipline:
Content quality:
Structural:
CI failure: Verdict: ✅ GO — PAO maintained test assertions correctly. Safe to merge when dev CI is fixed. |
Session: 2026-03-15T11-27-09Z-team-sync Requested by: Scribe Changes: - Logged team sync session (Flight triage + FIDO quality review) - Archived 2 decisions from 2025-07 (>30 days old) - Merged 2 orchestration logs - No duplicates detected in decisions.md - Test baseline: 3931 tests passing; 2 PRs ready to merge
Addresses community feedback from @jmservera on documentation gaps: - Created comprehensive FAQ page covering: - Which CLI to use (GHCP CLI vs Squad CLI) - Bot assignment troubleshooting - Aspire dashboard Squad CLI requirement - squad doctor teamRoot absolute path warning - Common questions about setup and workflows - Added platform callouts: - Aspire dashboard: noted Squad CLI requirement at top - Copilot coding agent: added troubleshooting note for bot assignment - CLI reference: added troubleshooting section for squad doctor warnings - Clarified CLI guidance in guide.md: - Positioned GitHub Copilot CLI as recommended for day-to-day work - Positioned Squad CLI for setup and operations - Added common workflow pattern example - Updated test assertions for new FAQ page Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
bradygaster
force-pushed
the
squad/398-docs-faq-cli-guidance
branch
from
d7e0c88 to
916130c
Compare
bradygaster
added a commit
that referenced
this pull request
Mar 15, 2026
Session: 2026-03-15T11-40-00Z-skill-install-and-flicker-fix Requested by: Coordinator Changes: - Appended team updates to Flight history: bug classification (6 issues, 2 fixed) - Appended team updates to PAO history: PR #403 merge (docs FAQ) - Created INCO history: terminal flicker fix cherry-pick to dev (PR #405) - Logged session activity for Flight, PAO, INCO, Coordinator Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
tamirdresher
pushed a commit
to tamirdresher/squad
that referenced
this pull request
Mar 16, 2026
* chore(squad): quality review findings — 7 issues filed Quality audit complete: 5 agents assessed CLI across testing, coverage, stability, accessibility, UX. Results: 4 P0 blockers (bradygaster#365–bradygaster#368), 3 P1 items (bradygaster#369–bradygaster#371). Blocking: Waingro dead sessions, ErrorBoundary, dropped input; Marquez help text consistency. Changes: - Logged session summary to .squad/log/2026-02-24T0205-quality-review-complete.md - Updated .squad/identity/now.md with quality review findings and new issue numbers Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * chore(squad): merge decision — Marquez UX audit findings Quality assessment merged from inbox (Grade B): 11 improvements (3 P0, 4 P1, 4 P2). help text, stub commands, vocabulary, separators, roster. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * test: add speed gate tests for impatient user journey 18 speed gate tests enforcing time budgets across the user journey: - Help scanability, init ceremony speed, welcome data loading - Input parsing latency, ghost retry bounds, error actionability - Version output speed and format Filed issues: bradygaster#387, bradygaster#395, bradygaster#397, bradygaster#399, bradygaster#401, bradygaster#403 Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --------- Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
tamirdresher
pushed a commit
to tamirdresher/squad
that referenced
this pull request
Mar 16, 2026
…aster#403) (bradygaster#461) The triage command is a real implementation (not a stub) that polls issues and auto-triages them to team members. Updated help text from 'Scan issues and categorize' to 'Watch issues and auto-triage to team' for accuracy. loop and hire commands were never implemented as stubs — they don't exist in the codebase, only in decision docs as future ideas. 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
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.
Closes #398 — Addresses community feedback from @jmservera on FAQ and CLI documentation gaps
What changed:
Community feedback addressed:
✅ Why gh issue edit --add-assignee @copilot does not work locally
✅ When to use Squad CLI vs GitHub Copilot CLI
✅ Aspire dashboard is Squad CLI only (added callout)
✅ squad doctor absolute path warning (added troubleshooting)
Working as PAO (DevRel) — following Microsoft Style Guide and DOCS-TEST SYNC pattern
Co-authored-by: Copilot 223556219+Copilot@users.noreply.github.com