docs: restore documentation on GitHub auth setup for project board management

Bug Report

What happened: The documentation explaining how to log in to GitHub with the proper credentials to manage project boards has been lost/is missing.

Expected: Clear documentation in our docs site or README covering:

How to authenticate with \gh auth login\ for project board access
Which scopes/permissions are needed for project board management
How to switch between accounts when multiple GitHub accounts are configured (e.g., personal vs EMU)
Common auth pitfalls (EMU account reactivating, token scope issues)

Context: Brady reported this as a bug — users need clear guidance on GitHub auth setup, especially when managing project boards with the Squad CLI.

Priority: Quick doc fix — should be a straightforward addition to the docs site.

🏗️ Squad Triage — Flight (Lead)

Issue: #488 — docs: restore documentation on GitHub auth setup for project board management
Assigned to: FIDO (Quality Owner)
Reason: Issue relates to testing/quality work

@copilot evaluation: 🔴 Not suitable — issue involves work outside the coding agent's capability profile.

Team roster:

Flight (Lead) → label: squad:flight
Procedures (Prompt Engineer) → label: squad:procedures
EECOM (Core Dev) → label: squad:eecom
FIDO (Quality Owner) → label: squad:fido
PAO (DevRel) → label: squad:pao
CAPCOM (SDK Expert) → label: squad:capcom
CONTROL (TypeScript Engineer) → label: squad:control
Surgeon (Release Manager) → label: squad:surgeon
Booster (CI/CD Engineer) → label: squad:booster
GNC (Node.js Runtime) → label: squad:gnc
Network (Distribution) → label: squad:network
RETRO (Security) → label: squad:retro
INCO (CLI UX & Visual Design) → label: squad:inco
GUIDO (VS Code Extension) → label: squad:guido
Telemetry (Aspire & Observability) → label: squad:telemetry
VOX (REPL & Interactive Shell) → label: squad:vox
DSKY (TUI Engineer) → label: squad:dsky
Sims (E2E Test Engineer) → label: squad:sims
Handbook (SDK Usability) → label: squad:handbook
Ralph (Work Monitor) → label: squad:ralph
@copilot (Coding Agent) → label: squad:copilot

To reassign, remove the current squad:* label and add the correct one.

📋 Assigned to PAO (DevRel)

Issue: #488 — docs: restore documentation on GitHub auth setup for project board management

PAO will pick this up in the next Copilot session.

For Copilot coding agent: If enabled, this issue will be worked automatically.
Otherwise, start a Copilot session and say:
PAO, work on issue #488

docs: restore GitHub auth setup documentation (#488)

docs: restore GitHub auth setup documentation (#488) (#489)

docs(ai-team): Cross-agent triage updates + history initialization

docs(ai-team): Wave D kickoff orchestration and decisions

docs(ai-team): Update focus to Wave D Batch 1

feat: unified status display across /agents and AgentPanel (github#488)

docs(ai-team): Wave D batch 1 implementation complete

Navigation Menu

Repository navigation

docs: restore documentation on GitHub auth setup for project board management #488

Bug Report

🏗️ Squad Triage — Flight (Lead)

@copilot evaluation: 🔴 Not suitable — issue involves work outside the coding agent's capability profile.

📋 Assigned to PAO (DevRel)

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

docs: restore documentation on GitHub auth setup for project board management #488

Description

Bug Report

Activity

github-actions commented on Mar 22, 2026

🏗️ Squad Triage — Flight (Lead)

@copilot evaluation: 🔴 Not suitable — issue involves work outside the coding agent's capability profile.

github-actions commented on Mar 22, 2026

📋 Assigned to PAO (DevRel)

Metadata

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

Issue actions