Title: Implementation: Ambient Personal Squad (#329 + #344) · Issue #508 · github/squad · GitHub
Open Graph Title: Implementation: Ambient Personal Squad (#329 + #344) · Issue #508 · github/squad
X Title: Implementation: Ambient Personal Squad (#329 + #344) · Issue #508 · github/squad
Description: Summary Implementation plan for the Ambient Personal Squad feature, based on Flight's architecture review and 19-task breakdown. Refs: #329, #344 Background Flight validated the 20KB design doc and identified 5 gaps (all resolved): No re...
Open Graph Description: Summary Implementation plan for the Ambient Personal Squad feature, based on Flight's architecture review and 19-task breakdown. Refs: #329, #344 Background Flight validated the 20KB design doc and...
X Description: Summary Implementation plan for the Ambient Personal Squad feature, based on Flight's architecture review and 19-task breakdown. Refs: #329, #344 Background Flight validated the 20KB design doc...
Opengraph URL: https://github.com/github/squad/issues/508
X: @github
Domain: github.com
{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"Implementation: Ambient Personal Squad (#329 + #344)","articleBody":"## Summary\n\nImplementation plan for the **Ambient Personal Squad** feature, based on Flight's architecture review and 19-task breakdown.\n\nRefs: #329, #344\n\n## Background\n\nFlight validated the 20KB design doc and identified 5 gaps (all resolved):\n1. No `resolvePersonalAgents()` function signature — added to plan\n2. Scenario 9 contradiction: personal agents writing to project orchestration log (violates ghost protocol) — coordinator writes audit trail instead\n3. `--team-root` scope undefined — additive CLI flag on `squad init`, backward compat\n4. `squad personal init` missing — bootstrapping path for first-time users\n5. No `SQUAD_NO_PERSONAL` kill switch — env var gates ambient discovery at earliest point\n\n## Implementation Plan — 4 PRs\n\n### PR #1 — SDK Foundation (EECOM)\n- `ResolvedSquadPaths.personalDir` — add personal dir to resolved paths\n- `resolvePersonalSquadDir()` — platform-aware personal squad directory resolution\n- `PersonalAgentMeta` type — metadata for personal agents (`origin: 'personal'`)\n- `resolvePersonalAgents()` — discover and load personal agents\n- `mergeSessionCast()` — merge personal agents into session cast\n- `ensureSquadPathTriple()` — extend dual-root path guard to triple-root for personal dirs\n- `SQUAD_NO_PERSONAL` env var — kill switch for ambient discovery\n\n### PR #2 — CLI Surface (EECOM, depends on PR #1)\n- `squad personal init` — bootstrap a personal squad\n- `squad personal list` — list personal agents\n- `squad personal add` — add a personal agent\n- `squad personal remove` — remove a personal agent\n- `squad cast` — show current session cast (project + personal)\n- `--team-root` flag — explicit team root override\n- Wiring + package exports\n\n### PR #3 — Governance (Procedures, concurrent with PR #1)\n- `squad.agent.md` updates for personal squad awareness\n- Ghost Protocol template — rules for personal agent behavior in project context\n- `personal-charter.md` template — charter template for personal agents\n- Consult mode detection and routing rules\n\n### PR #4 — Tests (Sims, after PR #1 + #2)\n- E2E ambient discovery tests\n- Ghost Protocol enforcement tests\n- Routing scenario tests (personal vs project agents)\n- Unit tests for all SDK functions\n\n## MVP\n\n**PR #1 + PR #3** — users see ambient cast immediately. `squad personal` commands (PR #2) are quality-of-life on top.\n\n## Key Decisions\n\n- Personal agents tagged with `origin: 'personal'` and Ghost Protocol applied\n- Audit trail is coordinator-written in project orchestration log (personal agents don't write to project state)\n- `SQUAD_NO_PERSONAL` env var gates ambient discovery at the earliest point\n- Dual-root path guard extended to triple-root (`ensureSquadPathTriple`) for personal dirs\n- Personal squad paths resolved via platform detection (never hard-coded)\n- Resolution priority: explicit (CLI flag) > project config > env var > git remote mapping > path mapping > default\n\n## Status\n\nDesign validated. Ready for EECOM to start PR #1.","author":{"url":"https://github.com/bradygaster","@type":"Person","name":"bradygaster"},"datePublished":"2026-03-22T10:49:23Z","url":"https://github.com/github/squad/issues/508"}
| react-profiling | 0 |
| react-import-map | react,react-dom,react-dom/client,react-dom/profiling,react-is,react/compiler-runtime,react/jsx-dev-runtime,react/jsx-runtime,scheduler@b8488ee2c322 |
| route-pattern | /_view_fragments/issues/show/:user_id/:repository/:id/issue_layout(.:format) |
| route-controller | voltron_issues_fragments |
| route-action | issue_layout |
| fetch-nonce | v2:b5fb5b74-db6e-4d28-c8b4-5ec484ba4e44 |
| current-catalog-service-hash | 81bb79d38c15960b92d99bca9288a9108c7a47b18f2423d0f6438c5b7bcd2114 |
| request-id | 9CA8:B1B84:19FF39F:21047D0:6B0187D1 |
| html-safe-nonce | b3bcb2accd840a3b2f22baf35ad293aefee395d2983e9afeb3849f8a42dff4bf |
| visitor-payload | eyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiI5Q0E4OkIxQjg0OjE5RkYzOUY6MjEwNDdEMDo2QjAxODdEMSIsInZpc2l0b3JfaWQiOiI3MzQ3MDk1OTYwMjc2Nzk3MzkzIiwicmVnaW9uX2VkZ2UiOiJpYWQiLCJyZWdpb25fcmVuZGVyIjoiaWFkIn0= |
| visitor-hmac | 64c425635c6384e5b820f436f9de4ccce89442ee15be18347baddbfedafac733 |
| hovercard-subject-tag | issue:4115660667 |
| github-keyboard-shortcuts | repository,issues,copilot |
| google-site-verification | Apib7-x98H0j5cPqHWwSMm6dNU4GmODRoqxLiDzdx9I |
| octolytics-url | https://collector.github.com/github/collect |
| analytics-location | / |
| fb:app_id | 1401488693436528 |
| apple-itunes-app | app-id=1477376905, app-argument=https://github.com/_view_fragments/issues/show/github/squad/508/issue_layout |
| twitter:image | https://opengraph.githubassets.com/8b302b3692c3df34c892f65e5bdac0dce0d70b118c2cc5416e04df86883dfb48/github/squad/issues/508 |
| twitter:card | summary_large_image |
| og:image | https://opengraph.githubassets.com/8b302b3692c3df34c892f65e5bdac0dce0d70b118c2cc5416e04df86883dfb48/github/squad/issues/508 |
| og:image:alt | Summary Implementation plan for the Ambient Personal Squad feature, based on Flight's architecture review and 19-task breakdown. Refs: #329, #344 Background Flight validated the 20KB design doc and... |
| og:image:width | 1200 |
| og:image:height | 600 |
| og:site_name | GitHub |
| og:type | object |
| og:author:username | bradygaster |
| hostname | github.com |
| expected-hostname | github.com |
| None | cc5dfdd32f62ebd3223cab3af3aa2b268d3605218237326a48a99d1efd89495c |
| turbo-cache-control | no-preview |
| go-import | github.com/github/squad git https://github.com/github/squad.git |
| octolytics-dimension-user_id | 9919 |
| octolytics-dimension-user_login | github |
| octolytics-dimension-repository_id | 1151205052 |
| octolytics-dimension-repository_nwo | github/squad |
| octolytics-dimension-repository_public | true |
| octolytics-dimension-repository_is_fork | false |
| octolytics-dimension-repository_network_root_id | 1151205052 |
| octolytics-dimension-repository_network_root_nwo | github/squad |
| turbo-body-classes | logged-out env-production page-responsive |
| disable-turbo | false |
| browser-stats-url | https://api.github.com/_private/browser/stats |
| browser-errors-url | https://api.github.com/_private/browser/errors |
| release | 8c77c9e8439031ad54c75a250694842892f693e1 |
| ui-target | full |
| theme-color | #1e2327 |
| color-scheme | light dark |
| react-app-name | issues |
Links:
Viewport: width=device-width