Title: Feature: Knowledge library — persistent team-wide storage for research and analysis · Issue #413 · github/squad · GitHub
Open Graph Title: Feature: Knowledge library — persistent team-wide storage for research and analysis · Issue #413 · github/squad
X Title: Feature: Knowledge library — persistent team-wide storage for research and analysis · Issue #413 · github/squad
Description: Problem statement Squad has four storage tiers: history.md (personal, compacted), decisions.md (team, choices only), skills/ (team, structured patterns), and wisdom.md (team, manual curation). Each serves a specific purpose and has const...
Open Graph Description: Problem statement Squad has four storage tiers: history.md (personal, compacted), decisions.md (team, choices only), skills/ (team, structured patterns), and wisdom.md (team, manual curation). Each...
X Description: Problem statement Squad has four storage tiers: history.md (personal, compacted), decisions.md (team, choices only), skills/ (team, structured patterns), and wisdom.md (team, manual curation). Each...
Opengraph URL: https://github.com/github/squad/issues/413
X: @github
Domain: github.com
{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"Feature: Knowledge library — persistent team-wide storage for research and analysis","articleBody":"## Problem statement\n\nSquad has four storage tiers: `history.md` (personal, compacted), `decisions.md` (team, choices only), `skills/` (team, structured patterns), and `wisdom.md` (team, manual curation). Each serves a specific purpose and has constraints that preserve its focus.\n\nWhen agents produce substantial work products — architecture redesigns, research reports, competitive analyses, deep audits — those documents get lost over time. A 10KB architecture analysis gets compacted to 3 sentences in history.md. A multi-session research effort vanishes when the session ends. Product docs get rewritten as the product evolves, erasing the original rationale. The team lacks long-term storage for substantial knowledge artifacts that survive compaction, session endings, and documentation rewrites.\n\nCommunity member @sturlath identified the same pain in #370: \"distributed knowledge that is hard to consolidate and read.\" That issue requests ADRs (architecture decision records) — a valuable use case, but part of a broader need for persistent team-wide knowledge storage.\n\n## Proposed solution\n\nAdd a `.squad/knowledge/` directory as **long-term storage** for substantial team documents:\n\n- **Preserves large work products** — research reports, architecture proposals, deep audits, and contextual analysis that would otherwise be lost to compaction or session death\n- **File naming:** `{author}-{topic-slug}.md` (e.g., `pao-docs-architecture.md`, `flight-deployment-patterns.md`)\n- **Never compacted** — deprecated rather than deleted (prepend `[DEPRECATED YYYY-MM-DD]` if obsolete)\n- **Not a dumping ground** — minimum ~2KB threshold; small notes belong in history.md or session artifacts\n- **Brownfield-aware** — agents discover where the repo already keeps its documentation and operate there for short-term content; `.squad/knowledge/` is only for substantial documents that don't fit anywhere existing\n- **Cold storage, not active memory** — files are not loaded at spawn time; agents access them when needed\n\n## Relationship to existing features\n\n- **Complements (doesn't replace) wisdom.md, skills/, decisions.md** — each has a distinct purpose; knowledge library fills the gap for substantial team-relevant analysis\n- **#370 (ADRs) is one use case** — knowledge library is the generalized answer that enables ADRs plus other research/analysis artifacts\n- **#162 (pluggable backends)** — future consideration if squad backends become pluggable\n- **#85 (decision lifecycle)** — knowledge library prevents `decisions.md` pollution by providing a home for analysis that isn't a decision\n\n## Key design decisions\n\n- **Long-term storage, not active documentation** — product docs, guides, and references belong in the repo's existing docs location; knowledge library is for preserving substantial research and analysis\n- **Framework convention** — provides where/how to store knowledge, not what to store\n- **Opt-in** — empty directory unless team uses it; no forced workflows\n- **Trust-based** — no quality gates on initial write (add later if needed)\n- **Discovery before creation** — agents must discover where the repo already keeps documentation and check existing knowledge sources before writing to avoid duplication\n- **Substantial work only** — research reports, architecture proposals, deep audits, competitive analyses; not small notes or status updates\n\n## References\n\nThis proposal generalizes the ADR concept requested in #370 into a broader knowledge library that can store ADRs, research findings, analysis, and contextual knowledge. Full proposal: `knowledge-library-proposal.md` in the project-squad working directory.\r\n","author":{"url":"https://github.com/diberry","@type":"Person","name":"diberry"},"datePublished":"2026-03-15T13:54:40Z","url":"https://github.com/github/squad/issues/413"}
| 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:d3e21799-1eb8-b640-9bb7-cdb998004df1 |
| current-catalog-service-hash | 81bb79d38c15960b92d99bca9288a9108c7a47b18f2423d0f6438c5b7bcd2114 |
| request-id | C15E:E9D16:10AE862:1522B1A:6B014EC8 |
| html-safe-nonce | 0cb01100c98c94145972dae3c5e4ffe2a60203376cc9300806b321967b8b345a |
| visitor-payload | eyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiJDMTVFOkU5RDE2OjEwQUU4NjI6MTUyMkIxQTo2QjAxNEVDOCIsInZpc2l0b3JfaWQiOiIzMjYyNDg3ODEzMDE4NDM5MzY4IiwicmVnaW9uX2VkZ2UiOiJpYWQiLCJyZWdpb25fcmVuZGVyIjoiaWFkIn0= |
| visitor-hmac | e530f3514ccf8e98f7f21e6bd7e8fb91c23d69089a86dd737ba06266ee63438d |
| hovercard-subject-tag | issue:4078426304 |
| 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/413/issue_layout |
| twitter:image | https://opengraph.githubassets.com/aacb5328e83f8c4cd73597f1401d88cba03a0b63e53e6c2dc509cb0decc10807/github/squad/issues/413 |
| twitter:card | summary_large_image |
| og:image | https://opengraph.githubassets.com/aacb5328e83f8c4cd73597f1401d88cba03a0b63e53e6c2dc509cb0decc10807/github/squad/issues/413 |
| og:image:alt | Problem statement Squad has four storage tiers: history.md (personal, compacted), decisions.md (team, choices only), skills/ (team, structured patterns), and wisdom.md (team, manual curation). Each... |
| og:image:width | 1200 |
| og:image:height | 600 |
| og:site_name | GitHub |
| og:type | object |
| og:author:username | diberry |
| 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 | canary-2 |
| theme-color | #1e2327 |
| color-scheme | light dark |
| react-app-name | issues |
Links:
Viewport: width=device-width