René's URL Explorer Experiment


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

direct link

Domain: github.com


Hey, it has json ld scripts:
{"@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-profiling0
react-import-mapreact,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-controllervoltron_issues_fragments
route-actionissue_layout
fetch-noncev2:7990224d-afee-4402-ad5c-4d35b129ac62
current-catalog-service-hash81bb79d38c15960b92d99bca9288a9108c7a47b18f2423d0f6438c5b7bcd2114
request-idC5E2:2757EE:7D3C4:A6168:6B015D4F
html-safe-nonce17606bdd0ed70f4483f9045034f06d4b5a1b9c3b6782e73d3bf0706abd9e0d77
visitor-payloadeyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiJDNUUyOjI3NTdFRTo3RDNDNDpBNjE2ODo2QjAxNUQ0RiIsInZpc2l0b3JfaWQiOiI1MzU1NzA1OTE1MDMzMDgzMjE1IiwicmVnaW9uX2VkZ2UiOiJpYWQiLCJyZWdpb25fcmVuZGVyIjoiaWFkIn0=
visitor-hmaca8289636768c7ad072e8f6761390d19bfc28580ebf42965f76c0e273bf70b41c
hovercard-subject-tagissue:4006081613
github-keyboard-shortcutsrepository,issues,copilot
google-site-verificationApib7-x98H0j5cPqHWwSMm6dNU4GmODRoqxLiDzdx9I
octolytics-urlhttps://collector.github.com/github/collect
analytics-location///voltron/issues_fragments/issue_layout
fb:app_id1401488693436528
apple-itunes-appapp-id=1477376905, app-argument=https://github.com/_view_fragments/issues/show/github/squad/162/issue_layout
twitter:imagehttps://opengraph.githubassets.com/3e1bc51e08ba73e136c7429ed395aef2eded4c7a5f78b1524dfa7cc7bf5a2bc4/github/squad/issues/162
twitter:cardsummary_large_image
og:imagehttps://opengraph.githubassets.com/3e1bc51e08ba73e136c7429ed395aef2eded4c7a5f78b1524dfa7cc7bf5a2bc4/github/squad/issues/162
og:image:altMost 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:width1200
og:image:height600
og:site_nameGitHub
og:typeobject
og:author:usernameEmmittJ
hostnamegithub.com
expected-hostnamegithub.com
Nonecc5dfdd32f62ebd3223cab3af3aa2b268d3605218237326a48a99d1efd89495c
turbo-cache-controlno-preview
go-importgithub.com/github/squad git https://github.com/github/squad.git
octolytics-dimension-user_id9919
octolytics-dimension-user_logingithub
octolytics-dimension-repository_id1151205052
octolytics-dimension-repository_nwogithub/squad
octolytics-dimension-repository_publictrue
octolytics-dimension-repository_is_forkfalse
octolytics-dimension-repository_network_root_id1151205052
octolytics-dimension-repository_network_root_nwogithub/squad
turbo-body-classeslogged-out env-production page-responsive
disable-turbofalse
browser-stats-urlhttps://api.github.com/_private/browser/stats
browser-errors-urlhttps://api.github.com/_private/browser/errors
release8c77c9e8439031ad54c75a250694842892f693e1
ui-targetfull
theme-color#1e2327
color-schemelight dark
react-app-nameissues

Links:

Skip to contenthttps://github.com/github/squad/issues/162#start-of-content
https://github.com/
Sign inhttps://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fgithub%2Fsquad%2Fissues%2F162
GitHubRepository hosting, code review, and collaborationhttps://github.com/platform
CopilotAI coding agent for tasks, projects, and automated workhttps://github.com/features/copilot
ActionsCI/CD and automationhttps://github.com/features/actions
Code QualityQuality analysis, fixes, and enforcementhttps://github.com/features/code-quality
CodespacesCloud development environmentshttps://github.com/features/codespaces
Code SecurityVulnerability detection and remediationhttps://github.com/security/advanced-security/code-security
Secret ProtectionSecret scanning and leak preventionhttps://github.com/security/advanced-security/secret-protection
All Featureshttps://github.com/features
Documentationhttps://docs.github.com/en
Traininghttps://learn.github.com/skills
Certificationshttps://learn.github.com/credentials
Build with Copilothttps://github.com/features/ai
Customize Copilothttps://docs.github.com/en/copilot/how-tos/copilot-on-github/customize-copilot/customize-copilot-overview
Integrationshttps://github.com/marketplace
Trending reposhttps://github.com/trending
GitHub Sponsorshttps://github.com/open-source/sponsors
Developer articleshttps://github.com/resources/articles
ChangelogYour source for the latest features, improvements, and fixes across GitHub products, all in one place.https://github.blog/changelog/
Enterpriseshttps://github.com/enterprise
Teamhttps://github.com/team
Startupshttps://github.com/enterprise/startups
Nonprofitshttps://github.com/solutions/industry/nonprofits
Healthcarehttps://github.com/solutions/industry/healthcare
Financial serviceshttps://github.com/solutions/industry/financial-services
Manufacturinghttps://github.com/solutions/industry/manufacturing
Governmenthttps://github.com/solutions/industry/government
See all industrieshttps://github.com/solutions/industry
Why GitHubhttps://github.com/why-github
Customer Storieshttps://github.com/customer-stories
Business insightshttps://github.com/solutions/executive-insights
Trust Centerhttps://github.com/trust-center
GitHub Advanced SecurityEnterprise-grade code securityhttps://github.com/security/advanced-security
Copilot for businessEnterprise-grade AI featureshttps://github.com/features/copilot/copilot-business
Premium SupportEnterprise-grade 24/7 supporthttps://github.com/enterprise/premium-support
Documentationhttps://docs.github.com/en
Resource centerhttps://github.com/resources
Bloghttps://github.blog/
Events & webinarshttps://github.com/resources/events
Community Forumhttps://github.com/orgs/community/discussions
Customer Storieshttps://github.com/customer-stories
Integrationshttps://github.com/marketplace
Customer supporthttps://help.github.com/
Traininghttps://learn.github.com/skills
GitHub Statushttps://www.githubstatus.com/
Abouthttps://github.com/about
Partnershttps://github.com/partners
Changeloghttps://github.blog/changelog/
GitHub UniverseThe event for developers, by developers — talks, workshops, and what’s next for GitHub.https://githubuniverse.com/
Pricinghttps://github.com/pricing
Sign inhttps://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fgithub%2Fsquad%2Fissues%2F162
Sign uphttps://github.com/signup?ref_cta=Sign+up&ref_loc=header+logged+out&ref_page=%2F%3Cuser-name%3E%2F%3Crepo-name%3E%2Fvoltron%2Fissues_fragments%2Fissue_layout&source=header-repo&source_repo=github%2Fsquad
Reloadhttps://github.com/github/squad/issues/162
Reloadhttps://github.com/github/squad/issues/162
Reloadhttps://github.com/github/squad/issues/162
githubhttps://github.com/github
squadhttps://github.com/github/squad
Codehttps://github.com/github/squad
Issues108 (108)https://github.com/github/squad/issues
Pull requests26 (26)https://github.com/github/squad/pulls
Discussionshttps://github.com/github/squad/discussions
Actionshttps://github.com/github/squad/actions
Projectshttps://github.com/github/squad/projects
Security and qualityhttps://github.com/github/squad/security
Insightshttps://github.com/github/squad/insights
https://github.com/github/squad
New issuehttps://github.com/login?return_to=https://github.com/github/squad/issues/162
New issuehttps://github.com/login?return_to=https://github.com/github/squad/issues/162
Pluggable Backends for Tasks, History, and Decisionshttps://github.com/github/squad/issues/162#top
release:deferDeferred past next releasehttps://github.com/github/squad/issues?q=state%3Aopen%20label%3A%22release%3Adefer%22
https://github.com/EmmittJ
EmmittJhttps://github.com/EmmittJ
on Mar 1, 2026https://github.com/github/squad/issues/162#issue-4006081613
beadshttps://github.com/steveyegge/beads
https://github.com/bradygaster
bradygasterhttps://github.com/bradygaster
on Mar 1, 2026https://github.com/github/squad/issues/162#issuecomment-3981192738
@EmmittJhttps://github.com/EmmittJ
https://github.com/EmmittJ
EmmittJhttps://github.com/EmmittJ
on Mar 2, 2026https://github.com/github/squad/issues/162#issuecomment-3981358051
@bradygasterhttps://github.com/bradygaster
https://github.com/EmmittJ
EmmittJhttps://github.com/EmmittJ
on Mar 5, 2026https://github.com/github/squad/issues/162#issuecomment-4001688503
@bradygasterhttps://github.com/bradygaster
#191https://github.com/github/squad/pull/191
EmmittJhttps://github.com/EmmittJ
on Mar 6, 2026https://github.com/github/squad/issues/162#event-23317641321
docs: add skill system design proposal (refs github#162)https://github.com/EmmittJ/squad/commit/bb13de2c9f11e06060699d462e9ae868d50f957a
github#162https://github.com/github/squad/issues/162
bb13de2https://github.com/EmmittJ/squad/commit/bb13de2c9f11e06060699d462e9ae868d50f957a
docs: add skill system design proposal (refs github#162)https://github.com/EmmittJ/squad/commit/9212c228e86963a3785da97d3b2cf7c2bd741bbe
github#162https://github.com/github/squad/issues/162
9212c22https://github.com/EmmittJ/squad/commit/9212c228e86963a3785da97d3b2cf7c2bd741bbe
bradygasterhttps://github.com/bradygaster
release:deferDeferred past next releasehttps://github.com/github/squad/issues?q=state%3Aopen%20label%3A%22release%3Adefer%22
on Mar 6, 2026https://github.com/github/squad/issues/162#event-23337185277
https://github.com/bradygaster
bradygasterhttps://github.com/bradygaster
on Mar 7, 2026https://github.com/github/squad/issues/162#issuecomment-4014894981
bradygasterhttps://github.com/bradygaster
not plannedhttps://github.com/github/squad/issues?q=is%3Aissue%20state%3Aclosed%20archived%3Afalse%20reason%3Anot-planned
on Mar 7, 2026https://github.com/github/squad/issues/162#event-23348086138
jonibahttps://github.com/joniba
on Mar 26, 2026https://github.com/github/squad/issues/162#event-23952073400
Investigate: Sentinel-Synthetics G2 cert compatibility (github#162)https://github.com/joniba/squad/commit/5429339d03aacd3251b7b4ff9de5c46576a348cd
github#162https://github.com/github/squad/issues/162
5429339https://github.com/joniba/squad/commit/5429339d03aacd3251b7b4ff9de5c46576a348cd
Merge pull request github#164 from jbenami_microsoft/squad/162-synthe…https://github.com/joniba/squad/commit/573216a4b5aa0fe91fc191d2a3b55fe05bab2951
github#164https://github.com/github/squad/issues/164
573216ahttps://github.com/joniba/squad/commit/573216a4b5aa0fe91fc191d2a3b55fe05bab2951
Sign up for freehttps://github.com/signup?return_to=https://github.com/github/squad/issues/162
Sign in to commenthttps://github.com/login?return_to=https://github.com/github/squad/issues/162
release:deferDeferred past next releasehttps://github.com/github/squad/issues?q=state%3Aopen%20label%3A%22release%3Adefer%22
https://github.com
Termshttps://docs.github.com/site-policy/github-terms/github-terms-of-service
Privacyhttps://docs.github.com/site-policy/privacy-policies/github-privacy-statement
Securityhttps://github.com/security
Statushttps://www.githubstatus.com/
Communityhttps://github.community/
Docshttps://docs.github.com/
Contacthttps://support.github.com?tags=dotcom-footer

Viewport: width=device-width


URLs of crawlers that visited me.