Title: PRD: SDK-First Feature Parity — Full Test Results (32/50 verified, 6 gaps, 12 need setup) · Issue #341 · github/squad · GitHub
Open Graph Title: PRD: SDK-First Feature Parity — Full Test Results (32/50 verified, 6 gaps, 12 need setup) · Issue #341 · github/squad
X Title: PRD: SDK-First Feature Parity — Full Test Results (32/50 verified, 6 gaps, 12 need setup) · Issue #341 · github/squad
Description: SDK-First Squad Feature Parity — Full Test Results Goal: Ensure squad init --sdk produces squads that work identically to regular markdown squads for all MVP use cases. Test bed: SdkSquad — Snake game repo initialized with squad init --s...
Open Graph Description: SDK-First Squad Feature Parity — Full Test Results Goal: Ensure squad init --sdk produces squads that work identically to regular markdown squads for all MVP use cases. Test bed: SdkSquad — Snake g...
X Description: SDK-First Squad Feature Parity — Full Test Results Goal: Ensure squad init --sdk produces squads that work identically to regular markdown squads for all MVP use cases. Test bed: SdkSquad — Snake g...
Opengraph URL: https://github.com/github/squad/issues/341
X: @github
Domain: github.com
{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"PRD: SDK-First Feature Parity — Full Test Results (32/50 verified, 6 gaps, 12 need setup)","articleBody":"## SDK-First Squad Feature Parity — Full Test Results\n\n> **Goal:** Ensure `squad init --sdk` produces squads that work identically to regular markdown squads for all MVP use cases.\n\n**Test bed:** [SdkSquad](https://github.com/bradygaster/SdkSquad) — Snake game repo initialized with `squad init --sdk` (Matrix universe)\n**Tested:** 2026-03-10\n**Method:** Systematic filesystem verification + active feature exercise across 2 sessions\n\n---\n\n## Results Summary\n\n| Status | Count | % |\n|--------|-------|---|\n| ✅ Verified | 32 | 64% |\n| ❌ Known Gap | 6 | 12% |\n| ⚠️ Needs Setup | 12 | 24% |\n| **Total** | **50** | 100% |\n\n---\n\n## Feature Matrix\n\n| # | Feature | Category | MD Squad | SDK Squad | Notes |\n|---|---------|----------|:--------:|:---------:|-------|\n| 1 | `squad init` — creates `.squad/` structure | Init & Setup | ✅ | ✅ Verified | Directory structure identical |\n| 2 | `squad init --sdk` — creates `squad.config.ts` | Init & Setup | N/A | ✅ Verified | defineSquad/defineAgent working |\n| 3 | Team casting — universe selection | Init & Setup | ✅ | ✅ Verified | Matrix universe cast correctly |\n| 4 | Casting state files | Init & Setup | ✅ | ✅ Verified | policy.json, registry.json, history.json present |\n| 5 | `.gitattributes` merge drivers | Init & Setup | ✅ | ✅ Verified | merge=union rules for decisions, history, logs |\n| 6 | Config stays in sync with team.md | Init & Setup | N/A | ❌ Gap | **#337** — config not updated on team changes |\n| 7 | Adding team members (markdown) | Team Mgmt | ✅ | ✅ Verified | charter, history, routing, team.md all updated |\n| 8 | Adding members updates config | Team Mgmt | N/A | ❌ Gap | **#337** — new agent not added to config |\n| 9 | Removing team members | Team Mgmt | ✅ | ✅ Verified | Alumni folder, registry retired, roster cleaned |\n| 10 | Removing members updates config | Team Mgmt | N/A | ❌ Gap | **#337** — removed agent not cleaned from config |\n| 11 | Plugin marketplace check | Team Mgmt | ✅ | ✅ Verified | No marketplaces → silently skipped (correct) |\n| 12 | Agent spawn with charter inline | Spawning | ✅ | ✅ Verified | 6 agents spawned successfully |\n| 13 | Model selection (4-layer) | Spawning | ✅ | ✅ Verified | haiku for non-code, sonnet for code, task-aware working |\n| 14 | Response mode selection | Spawning | ✅ | ✅ Verified | Direct, Lightweight, Standard, Full all exercised |\n| 15 | Parallel fan-out | Spawning | ✅ | ✅ Verified | 5 agents in parallel, all returned |\n| 16 | Drop-box pattern | Spawning | ✅ | ✅ Verified | Inbox→merge→clear cycle working |\n| 17 | Skill-aware routing | Spawning | ✅ | ✅ Verified | Skills dir, SKILL.md format, injection mechanism |\n| 18 | Routing table | Routing | ✅ | ✅ Verified | Matches roster, confirmed during add/remove |\n| 19 | Directive capture | Routing | ✅ | ✅ Verified | Preference captured to decisions/inbox/ |\n| 20 | Eager execution | Routing | ✅ | ✅ Verified | 3-agent parallel with anticipatory Scribe |\n| 21 | Orchestration logging | Routing | ✅ | ✅ Verified | Per-agent log entries with correct format |\n| 22 | GitHub repo connection | Issues | ✅ | ✅ Verified | Connected to bradygaster/squad, filed issues |\n| 23 | Issue triage | Issues | ✅ | ✅ Verified | Triaged #338-340, assigned squad:{member} labels |\n| 24 | Issue→PR lifecycle | Issues | ✅ | ⚠️ Setup | Needs real issue→branch→PR→merge cycle |\n| 25 | Label routing | Issues | ✅ | ✅ Verified | squad labels applied via gh CLI |\n| 26 | Auto-triggered ceremonies | Ceremonies | ✅ | ✅ Verified | Config valid; condition matching correct |\n| 27 | Manual ceremonies | Ceremonies | ✅ | ⚠️ Setup | Needs user-requested ceremony trigger |\n| 28 | Ceremony cooldown | Ceremonies | ✅ | ⚠️ Setup | Needs sequential ceremony trigger |\n| 29 | Ralph activation | Ralph | ✅ | ✅ Verified | Work-check scan executed on bradygaster/squad |\n| 30 | Work-check cycle | Ralph | ✅ | ✅ Verified | Scan→categorize→report working |\n| 31 | Idle-watch mode | Ralph | ✅ | ⚠️ Setup | Needs long-running session with periodic poll |\n| 32 | Watch mode | Ralph | ✅ | ⚠️ Setup | Needs `npx squad watch` exercise |\n| 33 | PRD intake | PRD Mode | ✅ | ✅ Verified | PRD.md created, referenced in decisions |\n| 34 | Lead decomposition | PRD Mode | ✅ | ✅ Verified | 50 features into P0-P3 tiers |\n| 35 | Work item routing | PRD Mode | ✅ | ✅ Verified | Priority-respecting parallel dispatch |\n| 36 | Human team members | Human & Copilot | ✅ | ⚠️ Setup | Needs human member add + pause test |\n| 37 | @copilot member | Human & Copilot | ✅ | ❌ Gap | **#339** — routing without roster entry |\n| 38 | @copilot auto-assign | Human & Copilot | ✅ | ❌ Gap | **#339** — not wired |\n| 39 | Skill extraction | Skills | ✅ | ✅ Verified | sdk-parity-testing skill extracted |\n| 40 | Skill confidence lifecycle | Skills | ✅ | ⚠️ Setup | Needs independent validation for bump |\n| 41 | Skills directory structure | Skills | ✅ | ✅ Verified | Correct format with YAML frontmatter |\n| 42 | Worktree awareness | Worktree & Git | ✅ | ⚠️ Setup | Needs multi-worktree environment |\n| 43 | Scribe git commits | Worktree & Git | ✅ | ✅ Verified | Multiple commits observed |\n| 44 | Merge drivers | Worktree & Git | ✅ | ✅ Verified | All 4 merge=union rules present |\n| 45 | Reviewer lockout | Reviewer | ✅ | ⚠️ Setup | Needs rejection scenario |\n| 46 | Deadlock handling | Reviewer | ✅ | ⚠️ Setup | Needs all-agents-locked scenario |\n| 47 | Client compatibility | Platform | ✅ | ⚠️ Setup | CLI confirmed; needs VS Code test |\n| 48 | MCP integration | Platform | ✅ | ✅ Verified | GitHub + Azure MCP detected |\n| 49 | Constraint budget | Platform | ✅ | ⚠️ Setup | Needs active constraint |\n| 50 | Multi-agent artifact | Platform | ✅ | ⚠️ Setup | Needs multi-agent deliverable |\n\n---\n\n## Known Gaps (Blocking Issues)\n\n| Issue | Description | Features Blocked |\n|-------|-------------|-----------------|\n| #337 | `squad.config.ts` ↔ `team.md` sync broken | #6, #8, #10 |\n| #338 | Ralph missing from generated config | #29–#32 (at SDK level) |\n| #339 | @copilot routing without roster entry | #37–#38 |\n\n---\n\n## Key Findings\n\n### What works well (SDK = markdown parity confirmed)\n- **Init & casting** — identical directory structure, correct universe selection, casting state files\n- **Agent spawning** — charter inline, model selection, parallel fan-out, drop-box pattern all working\n- **Routing** — routing table, directive capture, eager execution, orchestration logging\n- **Issues Mode** — repo connection, triage, label routing all working\n- **Ralph** — activation and work-check cycle functional (coordinator-level, not config-dependent)\n- **PRD Mode** — intake, decomposition, priority-aware routing\n- **Skills** — extraction, directory structure, SKILL.md format\n\n### What's broken (SDK-specific gaps)\n1. **Config sync (#337)** — the root cause. `squad.config.ts` is generated once at init and never updated. Add/remove member, Ralph, @copilot — all fail to update config.\n2. **Ralph in config (#338)** — Ralph is a built-in member but not included in generated config. Works at coordinator level but SDK consumers can't reference it.\n3. **@copilot wiring (#339)** — routing.md has @copilot rules pre-configured, but team.md roster and config are missing the entry. Routing references a non-existent member.\n\n### What needs specific test environments\n- **Issue→PR lifecycle (#24)** — needs a real issue pickup with branch/PR/merge\n- **Ceremonies (#27-28)** — needs multi-agent design task to trigger\n- **Human members (#36)** — needs human added to test coordinator pause\n- **Worktree (#42)** — needs `git worktree add` for multi-worktree\n- **Reviewer protocol (#45-46)** — needs review/rejection scenario\n- **VS Code (#47)** — needs Copilot Chat testing\n- **Constraints/artifacts (#49-50)** — need active constraint session\n\n### Bonus: EMU Auth Gotcha\nEnterprise Managed User (`bradyg_microsoft`) token interfered with GraphQL writes even when personal account (`bradygaster`) was active. `gh issue create` worked (REST?) but `gh issue edit` failed (GraphQL). Fix: `gh auth logout --user {emu_account}`. Possible `gh` CLI bug worth reporting.\n\n### Skill Extracted\nCreated `.squad/skills/sdk-parity-testing/SKILL.md` with 6 reusable patterns:\n1. Filesystem-first verification before active exercise\n2. Config-roster divergence detection\n3. Tiered test priority (P0→P3)\n4. Drop-box verification\n5. Issue-as-test-output pattern\n6. EMU auth gotcha\n\n---\n\n## MVP Exit Criteria\n\n1. ✅ All P0 features verified (Init, Team Mgmt, Spawning) — **except config sync (#337)**\n2. ✅ All P1 features verified (Routing, Issues, Ralph) — **except full PR lifecycle (#24)**\n3. ⚠️ Known gaps #337, #338, #339 need fixes or PRs\n4. ⚠️ 12 P2/P3 features need specific test setups (documented above)\n5. ✅ PRD updated with final status for every row\r\n","author":{"url":"https://github.com/bradygaster","@type":"Person","name":"bradygaster"},"datePublished":"2026-03-10T23:03:27Z","url":"https://github.com/github/squad/issues/341"}
| 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:e1879423-3e4e-1773-a402-35cf4b82a396 |
| current-catalog-service-hash | 81bb79d38c15960b92d99bca9288a9108c7a47b18f2423d0f6438c5b7bcd2114 |
| request-id | 8C10:2C69FC:1152B9:171AA4:6B0184AE |
| html-safe-nonce | d460484135d0a7d8ae8c5f9d397b5be4c354c8b38b0409b3066f81432a10f5cd |
| visitor-payload | eyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiI4QzEwOjJDNjlGQzoxMTUyQjk6MTcxQUE0OjZCMDE4NEFFIiwidmlzaXRvcl9pZCI6IjQ4ODY0MTMwMzIwODA2MzkxNTEiLCJyZWdpb25fZWRnZSI6ImlhZCIsInJlZ2lvbl9yZW5kZXIiOiJpYWQifQ== |
| visitor-hmac | 8667d83f782833f09ba12ee311ceac7a686691b5614555134de2c768d43183fe |
| hovercard-subject-tag | issue:4054678616 |
| 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/341/issue_layout |
| twitter:image | https://opengraph.githubassets.com/e35a8b5674c52d67fe2f141afab4aecf3a248c44ee29130a88fce753f027ce27/github/squad/issues/341 |
| twitter:card | summary_large_image |
| og:image | https://opengraph.githubassets.com/e35a8b5674c52d67fe2f141afab4aecf3a248c44ee29130a88fce753f027ce27/github/squad/issues/341 |
| og:image:alt | SDK-First Squad Feature Parity — Full Test Results Goal: Ensure squad init --sdk produces squads that work identically to regular markdown squads for all MVP use cases. Test bed: SdkSquad — Snake g... |
| 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