Title: Pluggable Backends for Tasks, History, and Decisions · Issue #162 · github/squad · GitHub
Open Graph Title: Pluggable Backends for Tasks, History, and Decisions · Issue #162 · github/squad
X Title: Pluggable Backends for Tasks, History, and Decisions · Issue #162 · github/squad
Description: Most of this was written by Keaton Squad uses markdown files for agent state: history.md, decisions.md, and the decisions/inbox/ drop-box pattern. This works and it's the right default, but some teams may want queryable backends, auto-co...
Open Graph Description: Most of this was written by Keaton Squad uses markdown files for agent state: history.md, decisions.md, and the decisions/inbox/ drop-box pattern. This works and it's the right default, but some te...
X Description: Most of this was written by Keaton Squad uses markdown files for agent state: history.md, decisions.md, and the decisions/inbox/ drop-box pattern. This works and it's the right default, but som...
Opengraph URL: https://github.com/github/squad/issues/162
X: @github
Domain: github.com
{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"Pluggable Backends for Tasks, History, and Decisions","articleBody":"> *Most of this was written by Keaton*\n\nSquad uses markdown files for agent state: `history.md`, `decisions.md`, and the `decisions/inbox/` drop-box pattern. This works and it's the right default, but some teams may want queryable backends, auto-compaction, or integration with external trackers they already use.\n\nI have been toying around with [beads](https://github.com/steveyegge/beads), and I would like to propose the idea of a **skill-based plugin model** so teams can choose their own backends for Tasks, History, and Decisions, without changing the coordinator or agent prompts. Markdown stays the default. Teams that want something else (like beads, GitHub Issues, or Linear) just swap a skill file.\n\n## The Interface: Tracking Table + Skills\n\nEach team's `team.md` gets a `## Tracking` section that maps concerns to backend skills:\n\n```markdown\n## Tracking\n\n| Concern | Backend | Skill |\n|---------|---------|-------|\n| Tasks | beads | `.squad/skills/tasks-beads/SKILL.md` |\n| Decisions | github | `.squad/skills/decisions-github/SKILL.md` |\n```\n\nAt spawn time, the coordinator:\n\n1. Reads the tracking table from `team.md`\n2. Loads each skill file's `## Spawn Prompt Block`\n3. Injects these blocks into the agent's prompt\n\nThe agent doesn't know or care what backend is behind the commands — they just follow the injected instructions.\n\n## Example: Different Backends for Tasks\n\n**Beads backend** (`tasks-beads/SKILL.md`):\n\n```markdown\n## Spawn Prompt Block\n\nReady work: run `bd ready --json`\nYour history: `bd list -a {agent-name} --status closed --json`\nClose a task: `bd close {id} --reason \"Done: {summary}\" --json`\n```\n\n**GitHub Issues backend** (`tasks-github/SKILL.md`):\n\n```markdown\n## Spawn Prompt Block\n\nReady work: `gh issue list -R {repo} --label \"ready\" --json`\nYour history: `gh issue list -R {repo} --assignee \"@me\" --state closed --json`\nClose a task: `gh issue close {id} -c \"Done: {summary}\"`\n```\n\n**Markdown backend** (`tasks-markdown/SKILL.md`):\n\n```markdown\n## Spawn Prompt Block\n\nReady work: see `tasks.md` under \"## Ready\"\nYour history: grep agent name in `history.md`, collect closed items\nClose a task: append to `history.md` under your section\n```\n\nSame concern (Tasks), completely different backend. Coordinator and agents don't change.\n\n## What the Agent Sees\n\nAt spawn, the agent gets injected blocks like this — they never see the skill file or the tracking table:\n\n```\nTASK CONTEXT:\n Ready work: run `bd ready --json`\n Your assigned work: check `bd list --status open --json` for items you claimed\n Your work history: run `bd list -a {name} --status closed --json`\n\n TASK OUTPUT:\n When you complete a task: `bd close {id} --reason \"Done: {summary}\" --json`\n\nDECISION CONTEXT:\n Active decisions: `gh issue list -R {repo} --label \"decision\" --state open --json`\n\n DECISION OUTPUT:\n When you make a team-relevant decision:\n `gh issue create -R {repo} --label \"decision\" --title \"{title}\" --body \"...\"`\n```\n\nNotice: tasks on beads, decisions on GitHub Issues. Mix and match.\n\n## What Changes\n\n| Current | With Pluggable Backends |\n|---------|------------------------|\n| `history.md` (per agent) | Backend-specific — backends that support compaction can auto-manage this |\n| `decisions.md` + `decisions/inbox/` | Agents write directly to their backend — no inbox, no Scribe merge |\n| Scribe merges inbox, summarizes history | Those responsibilities move to the backend (or disappear entirely) |\n\nWhat stays: agent charters, orchestration logs, session archives.\n\n## Open Questions\n\n1. **Skill interface spec** — what fields must a skill's `## Spawn Prompt Block` define so the coordinator can reliably inject them? Do we need a schema?\n2. **Migration tooling** — how do we help existing teams import markdown history into a new backend?\n3. **Fallback behavior** — if a skill is missing or misconfigured, should the coordinator warn, fail, or fall back to markdown?\n4. **Scribe's role** — with history summarization and decision merging potentially handled by backends, does Scribe shrink to just orchestration logs and session archives?\n\nLabels: `enhancement`, `architecture`, `discussion`","author":{"url":"https://github.com/EmmittJ","@type":"Person","name":"EmmittJ"},"datePublished":"2026-03-01T03:06:28Z","url":"https://github.com/github/squad/issues/162"}
| 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:7990224d-afee-4402-ad5c-4d35b129ac62 |
| current-catalog-service-hash | 81bb79d38c15960b92d99bca9288a9108c7a47b18f2423d0f6438c5b7bcd2114 |
| request-id | C5E2:2757EE:7D3C4:A6168:6B015D4F |
| html-safe-nonce | 17606bdd0ed70f4483f9045034f06d4b5a1b9c3b6782e73d3bf0706abd9e0d77 |
| visitor-payload | eyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiJDNUUyOjI3NTdFRTo3RDNDNDpBNjE2ODo2QjAxNUQ0RiIsInZpc2l0b3JfaWQiOiI1MzU1NzA1OTE1MDMzMDgzMjE1IiwicmVnaW9uX2VkZ2UiOiJpYWQiLCJyZWdpb25fcmVuZGVyIjoiaWFkIn0= |
| visitor-hmac | a8289636768c7ad072e8f6761390d19bfc28580ebf42965f76c0e273bf70b41c |
| hovercard-subject-tag | issue:4006081613 |
| 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/162/issue_layout |
| twitter:image | https://opengraph.githubassets.com/3e1bc51e08ba73e136c7429ed395aef2eded4c7a5f78b1524dfa7cc7bf5a2bc4/github/squad/issues/162 |
| twitter:card | summary_large_image |
| og:image | https://opengraph.githubassets.com/3e1bc51e08ba73e136c7429ed395aef2eded4c7a5f78b1524dfa7cc7bf5a2bc4/github/squad/issues/162 |
| og:image:alt | Most of this was written by Keaton Squad uses markdown files for agent state: history.md, decisions.md, and the decisions/inbox/ drop-box pattern. This works and it's the right default, but some te... |
| og:image:width | 1200 |
| og:image:height | 600 |
| og:site_name | GitHub |
| og:type | object |
| og:author:username | EmmittJ |
| 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