Closed
Conversation
- Orchestration log: 2026-03-22T12-36Z-pao.md — PAO completed full docs catalog audit - Session log: 2026-03-22T12-36Z-docs-catalog-audit.md — session summary - Merged .squad/decisions/inbox/pao-docs-audit.md into decisions.md - Updated PAO history.md with docs audit learnings (15 orphans, 0 dead links, 5 top actions) - Deleted inbox file - Docs audit found critical nav gaps, stale content, duplication; formalized 5 action items Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
- Orchestration: Booster completed whatsnew.md version sync automation (2026-03-22T12:46Z) - Merged decision: whatsnew auto-sync via prebuild script + Vitest test gate - Updated PAO history: Docs audit finding #1 (stale version) resolved - Removed merged inbox decision: booster-whatsnew-sync.md whatsnew.md heading now syncs on every build (local + CI), keeping release docs current with package.json version. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
- Orchestration log: 2026-03-22T12-55Z-pao.md (PAO DevRel spawn) - Session log: 2026-03-22T12-55Z-docs-fixes.md - Inbox: clean (no files to merge) All 4 fires resolved. Build tests passing (23/23).
# Conflicts: # docs/src/content/docs/guide.md # docs/src/content/docs/tips-and-tricks.md # docs/src/content/docs/tour-first-session.md
- Added User Interaction Flow (sequence diagram) showing how messages flow through Squad - Added Component Architecture (layered flowchart) showing UI, orchestration, execution, state, persistence, and artifact layers - Added State Management (drop-box pattern) showing parallel agent writes to inbox and Scribe merging - Added Parallel Execution Model showing background fan-out, sync, and review gate modes - Added Casting & Persistent Naming showing how agents maintain identity across sessions and repos - Added Decision & Knowledge Flow (sequence diagram) showing how directives, decisions, and memory compound - Included descriptive text under each diagram explaining key concepts - All diagrams use Mermaid syntax with color coding by concern - Organized for 30-second comprehension by first-time readers Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Add comprehensive 7th Mermaid diagram showing git worktree lifecycle, including: - Trigger (issue assignment) - Worktree setup and reuse - Parallel agent work with shared worktree - Commit and PR flow - State merging via union driver - Cleanup Includes comparison of worktree-local vs main-checkout strategies with detailed steps. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
diberry
force-pushed
the
squad/pao-arch-diagram
branch
from
e2b1c21 to
217f965
Compare
Owner
Author
|
Superseded by PR #11 (TypeDoc API reference). |
This was referenced Mar 30, 2026
This was referenced Mar 31, 2026
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.
PAO: Architecture Diagrams
What's here
7 Mermaid diagrams covering Squad's architecture:
All diagrams in Mermaid source format at
docs/src/content/docs/concepts/architecture.md.Status
Ready for review. See also: PNG rendering PR and CI proposal PR.