Title: bug(doctor): add .github/agents/squad.agent.md existence check · Issue #533 · github/squad · GitHub
Open Graph Title: bug(doctor): add .github/agents/squad.agent.md existence check · Issue #533 · github/squad
X Title: bug(doctor): add .github/agents/squad.agent.md existence check · Issue #533 · github/squad
Description: Summary \squad doctor\ checks .squad/\ infrastructure (team.md, routing.md, agents/, casting/, decisions.md) but does NOT check for .github/agents/squad.agent.md\ — the file that GitHub Copilot uses to discover the squad agent. This mean...
Open Graph Description: Summary \squad doctor\ checks .squad/\ infrastructure (team.md, routing.md, agents/, casting/, decisions.md) but does NOT check for .github/agents/squad.agent.md\ — the file that GitHub Copilot use...
X Description: Summary \squad doctor\ checks .squad/\ infrastructure (team.md, routing.md, agents/, casting/, decisions.md) but does NOT check for .github/agents/squad.agent.md\ — the file that GitHub Copilot use...
Opengraph URL: https://github.com/github/squad/issues/533
X: @github
Domain: github.com
{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"bug(doctor): add .github/agents/squad.agent.md existence check","articleBody":"## Summary\n\n\\squad doctor\\ checks \\.squad/\\ infrastructure (team.md, routing.md, agents/, casting/, decisions.md) but does NOT check for \\.github/agents/squad.agent.md\\ — the file that GitHub Copilot uses to discover the squad agent.\n\nThis means a user can have a fully healthy \\.squad/\\ setup but Copilot won't see the agent because the discovery file is missing. Doctor reports green when the most user-visible thing is broken.\n\n## Reproduction\n\n1. Delete \\.github/agents/squad.agent.md\\ from a squad repo\n2. Run \\squad doctor\\ — reports all green (or only unrelated failures)\n3. Open Copilot — squad agent not available\n\n## Expected Behavior\n\nDoctor should check:\n- [ ] \\.github/agents/squad.agent.md\\ exists\n- [ ] File is non-empty and contains the version stamp\n- [ ] If missing, suggest: \\Run 'squad upgrade' to restore the agent file\\\n\n## Context\n\nDiscovered while debugging a user's setup where Copilot couldn't see the squad agent. The fix was \\squad upgrade\\ but doctor didn't surface the problem.\n\nAlso note: the user tried \\squad update\\ (doesn't exist) — doctor or the unknown-command handler could suggest \\squad upgrade\\ as a did-you-mean.","author":{"url":"https://github.com/bradygaster","@type":"Person","name":"bradygaster"},"datePublished":"2026-03-23T00:21:48Z","url":"https://github.com/github/squad/issues/533"}
| 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:ca517dd7-f17e-2c38-968d-a2d87f022a62 |
| current-catalog-service-hash | 81bb79d38c15960b92d99bca9288a9108c7a47b18f2423d0f6438c5b7bcd2114 |
| request-id | C636:5128:1180A6:1756EE:6B015FD0 |
| html-safe-nonce | ac3db128a49b502e8f36ae6a9132d0b1d19da2772fbea012132a9ee9f9c9ef14 |
| visitor-payload | eyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiJDNjM2OjUxMjg6MTE4MEE2OjE3NTZFRTo2QjAxNUZEMCIsInZpc2l0b3JfaWQiOiIxMzEwODY4NTEyMTAwNjcxNDQwIiwicmVnaW9uX2VkZ2UiOiJpYWQiLCJyZWdpb25fcmVuZGVyIjoiaWFkIn0= |
| visitor-hmac | 775eaec3038c808d25ea2cbcf2ef612669eb68280ab189617ad63468f8701eb2 |
| hovercard-subject-tag | issue:4117479184 |
| 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/533/issue_layout |
| twitter:image | https://opengraph.githubassets.com/82c983be4f65956cdcedcf8b1ca2613f3bdf1ca80977a838177452c0428e2b13/github/squad/issues/533 |
| twitter:card | summary_large_image |
| og:image | https://opengraph.githubassets.com/82c983be4f65956cdcedcf8b1ca2613f3bdf1ca80977a838177452c0428e2b13/github/squad/issues/533 |
| og:image:alt | Summary \squad doctor\ checks .squad/\ infrastructure (team.md, routing.md, agents/, casting/, decisions.md) but does NOT check for .github/agents/squad.agent.md\ — the file that GitHub Copilot use... |
| 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