Title: Extract cold-path sections from squad.agent.md into satellite files · Issue #98 · github/squad · GitHub
Open Graph Title: Extract cold-path sections from squad.agent.md into satellite files · Issue #98 · github/squad
X Title: Extract cold-path sections from squad.agent.md into satellite files · Issue #98 · github/squad
Description: Problem squad.agent.md is ~27K tokens / ~108K chars / ~1,900 lines. It's loaded as the system prompt on every turn of every conversation. Users are experiencing "response was interrupted due to a server error. retrying" loops — even on s...
Open Graph Description: Problem squad.agent.md is ~27K tokens / ~108K chars / ~1,900 lines. It's loaded as the system prompt on every turn of every conversation. Users are experiencing "response was interrupted due to a s...
X Description: Problem squad.agent.md is ~27K tokens / ~108K chars / ~1,900 lines. It's loaded as the system prompt on every turn of every conversation. Users are experiencing "response was interrupted d...
Opengraph URL: https://github.com/github/squad/issues/98
X: @github
Domain: github.com
{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"Extract cold-path sections from squad.agent.md into satellite files","articleBody":"## Problem\n\n`squad.agent.md` is ~27K tokens / ~108K chars / ~1,900 lines. It's loaded as the system prompt on every turn of every conversation. Users are experiencing \"response was interrupted due to a server error. retrying\" loops — even on simple chat turns with no agents spawned. The system prompt alone consumes too much of the context window.\n\n## Proposed Solution — Satellite File Extraction\n\nExtract cold-path sections from `squad.agent.md` into satellite files that the coordinator reads on demand via `view` tool calls when specific features are triggered.\n\n### Hot path (~7-10K tokens, stays in squad.agent.md)\n- Coordinator identity + refusal rules\n- Init/Team mode gate\n- Routing logic + trigger tables\n- Response mode selection + model selection\n- Spawn templates (standard + lightweight)\n- Anti-patterns list\n- **One-line trigger summaries** for every cold-path feature with `read {file} before executing` pointers\n\n### Cold path → satellite files in `.github/agents/squad/`\n| Section | Est. tokens | Trigger |\n|---------|-------------|---------|\n| Casting & Persistent Naming (tables, algorithm) | ~3K | Init mode, adding members |\n| Ralph — Work Monitor | ~2.5K | \"Ralph go\", \"keep working\" |\n| Ceremonies | ~2K | Ceremony requests, auto-triggers |\n| GitHub Issues Mode | ~2K | Issue commands |\n| PRD Mode | ~1.5K | \"here's the PRD\" |\n| Human Team Members | ~1K | \"add {name} as {role}\" |\n| Copilot Coding Agent | ~1.5K | \"add copilot\" |\n| Client Compatibility details | ~1K | VS Code detection |\n\n### Implementation notes\n- Satellite files live in `.github/agents/squad/` alongside `squad.agent.md`\n- `index.js` copy logic needs to recursively copy `.github/agents/squad/` to consumer repos\n- Platform loads ONE `.agent.md` file — satellites must be explicitly read via `view` tool (each costs one tool call)\n- Each extracted feature keeps a 1-2 line trigger description in the hot prompt so the LLM never forgets a capability exists\n- VS Code: same behavior, no platform-specific issues\n- Estimated reduction: **70%+** (from ~27K to ~7-10K tokens)\n\n### Risks\n- **False negatives**: If trigger descriptions are too terse, coordinator may skip loading a satellite when it should. Needs empirical testing.\n- **Latency**: First turn of a cold-path feature adds one tool call. Acceptable tradeoff vs. server errors.\n\n### Why bundle with v0.5.0\nThe `.ai-team/ → .squad/` rename (#69) already touches every path reference in `squad.agent.md`. Doing extraction simultaneously avoids rewriting paths twice.\n\n## Team consensus (from discussion 2026-02-19)\n- **Keaton (Lead)**: Target 8-10K hot path. Move whole sections out intact — don't compress. Ship casting tables first.\n- **Verbal (Prompt Engineer)**: Tiered prompting with trigger-gated lazy loading. Keep one-line summaries of every capability in hot path.\n- **Fenster (Core Dev)**: Mechanically straightforward. Flag `index.js` copy logic as real work. Prototype with 2-3 satellites first.","author":{"url":"https://github.com/bradygaster","@type":"Person","name":"bradygaster"},"datePublished":"2026-02-19T21:57:27Z","url":"https://github.com/github/squad/issues/98"}
| 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:061531fb-8e79-97f1-8eeb-a8062e5e2f89 |
| current-catalog-service-hash | 81bb79d38c15960b92d99bca9288a9108c7a47b18f2423d0f6438c5b7bcd2114 |
| request-id | C912:4BB79:2164B6A:2A9CC23:6B017DF4 |
| html-safe-nonce | f474e16228f67f12f864e7a0f40f3c32eb112bc6ca54417b355c20f453a8c322 |
| visitor-payload | eyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiJDOTEyOjRCQjc5OjIxNjRCNkE6MkE5Q0MyMzo2QjAxN0RGNCIsInZpc2l0b3JfaWQiOiI4ODkwODgxOTkwMTUzMzA1NTg4IiwicmVnaW9uX2VkZ2UiOiJpYWQiLCJyZWdpb25fcmVuZGVyIjoiaWFkIn0= |
| visitor-hmac | f6cb3da0cf1ae7ca50ca4fcfee3cf61612da9905ac132023fbd2947639ff703d |
| hovercard-subject-tag | issue:3965324919 |
| 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/98/issue_layout |
| twitter:image | https://opengraph.githubassets.com/2a4155d054fa181a06f12d04f3d9b4f345043fb44e7dcdd960a8b743948bd642/github/squad/issues/98 |
| twitter:card | summary_large_image |
| og:image | https://opengraph.githubassets.com/2a4155d054fa181a06f12d04f3d9b4f345043fb44e7dcdd960a8b743948bd642/github/squad/issues/98 |
| og:image:alt | Problem squad.agent.md is ~27K tokens / ~108K chars / ~1,900 lines. It's loaded as the system prompt on every turn of every conversation. Users are experiencing "response was interrupted due to a s... |
| 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