René's URL Explorer Experiment


Title: Decision lifecycle management and archival system · Issue #85 · github/squad · GitHub

Open Graph Title: Decision lifecycle management and archival system · Issue #85 · github/squad

X Title: Decision lifecycle management and archival system · Issue #85 · github/squad

Description: Problem User feedback: "we have a LOOOOOOT of old decisions and stuff. i know we've done a good deal of purging but, could we do a lot, lot more? we might want to come up with some skills for managing decisions." Current state: decisions...

Open Graph Description: Problem User feedback: "we have a LOOOOOOT of old decisions and stuff. i know we've done a good deal of purging but, could we do a lot, lot more? we might want to come up with some skills for manag...

X Description: Problem User feedback: "we have a LOOOOOOT of old decisions and stuff. i know we've done a good deal of purging but, could we do a lot, lot more? we might want to come up with some skills ...

Opengraph URL: https://github.com/github/squad/issues/85

X: @github

direct link

Domain: github.com


Hey, it has json ld scripts:
{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"Decision lifecycle management and archival system","articleBody":"## Problem\r\n\r\nUser feedback: \"we have a LOOOOOOT of old decisions and stuff. i know we've done a good deal of purging but, could we do a lot, lot more? we might want to come up with some skills for managing decisions.\"\r\n\r\nCurrent state:\r\n- `decisions.md` is 2,084 lines (as of 2026-02-16)\r\n- Contains decisions spanning from 2026-02-07 through present (10+ days of rapid iteration)\r\n- No archival or lifecycle management\r\n- Scribe's consolidation helps but doesn't remove obsolete decisions\r\n- Every agent reads the FULL decisions.md on spawn → large context cost\r\n\r\n## Proposal: Decision Lifecycle & Archival\r\n\r\nCreate a skill for Scribe: **decision-management** with lifecycle stages:\r\n\r\n### 1. Active Decisions (current decisions.md)\r\n- Recent decisions (last 30 days by default)\r\n- High-impact architectural/policy decisions regardless of age\r\n- Decisions explicitly marked `status: permanent`\r\n\r\n### 2. Archived Decisions (new: decisions/archive/)\r\n- Decisions older than 30 days that aren't permanent\r\n- One-time decisions (e.g., \"shipped v0.1.0\", \"merged PR #5\")\r\n- Implementation details that are now in code\r\n- Organized by quarter: `decisions/archive/2026-Q1.md`\r\n\r\n### 3. Obsolete/Superseded\r\n- Decisions explicitly superseded by later decisions\r\n- Moved to archive with `[SUPERSEDED by 2026-02-15: {new decision}]` markers\r\n- Never deleted — kept for historical context\r\n\r\n## Decision Criteria\r\n\r\n**Keep in main decisions.md:**\r\n- [ ] Referenced in last 30 days (actively being applied)\r\n- [ ] Architectural foundation (affects how agents think about the system)\r\n- [ ] Team policy/workflow (e.g., proposal-first, branch model, release process)\r\n- [ ] Explicitly marked `status: permanent` by Lead or user\r\n\r\n**Archive to decisions/archive/:**\r\n- [ ] Older than 30 days AND not referenced recently\r\n- [ ] Completed one-time tasks (\"shipped X\", \"fixed bug Y\")\r\n- [ ] Implementation details now encoded in code/docs\r\n- [ ] Historical context valuable for audit but not day-to-day work\r\n\r\n**Example active decisions:**\r\n- Proposal-first workflow (team policy — permanent)\r\n- Skills system adoption (architectural — permanent) \r\n- Branching strategy (team policy — permanent)\r\n- Release process (team policy — permanent)\r\n\r\n**Example archived decisions:**\r\n- \"Shipped v0.1.0\" (one-time event)\r\n- \"Fixed Scribe resilience bug\" (implementation detail now in code)\r\n- \"Cleaned up decisions.md on 2026-02-08\" (meta-task)\r\n- Early platform decisions superseded by later ones\r\n\r\n## Scribe Skill: decision-management\r\n\r\n**When to run:** During session logging, after merging inbox\r\n**What it does:**\r\n1. Read decisions.md\r\n2. Identify candidates for archival (> 30 days old, not permanent, completed/historical)\r\n3. Move qualified decisions to `decisions/archive/{YYYY-QX}.md`\r\n4. Add forward references in archive: \"See decisions.md for current policy\"\r\n5. Add backward references in decisions.md: \"Historical decisions: see decisions/archive/\"\r\n6. Report: \"Archived 12 decisions from Q1 — decisions.md now 800 lines (was 2084)\"\r\n\r\n**Safeguards:**\r\n- Never archives decisions marked `status: permanent`\r\n- Prompts user before first archival: \"Archive 15 old decisions? [y/n]\"\r\n- Generates summary of what will be archived for review\r\n- Dry-run mode: `squad scribe --archive-decisions --dry-run`\r\n\r\n## Why This Matters\r\n\r\n- **Context cost:** Agents read full decisions.md on every spawn. 2K lines = high token cost.\r\n- **Signal-to-noise:** New agents need foundational decisions, not \"we fixed bug #42 in v0.1.1\"\r\n- **Performance:** Smaller decisions.md = faster agent spawns\r\n- **Maintainability:** Easier to onboard new agents/humans when decisions are curated\r\n- **Audit trail:** Archive preserves history without cluttering active decisions\r\n\r\n## Alternatives Considered\r\n\r\n1. **Hard limits:** \"decisions.md must be \u003c 500 lines\" → rejected, too arbitrary\r\n2. **Delete obsolete decisions:** Rejected — lose historical context and audit trail\r\n3. **Split by category:** Rejected —agents need cohesive view, not category hunting\r\n4. **Time-based only:** Keep recent, archive old — CHOSEN, simple and predictable\r\n\r\n## Acceptance Criteria\r\n\r\n- [ ] `.ai-team/decisions/archive/{YYYY-QX}.md` directory structure\r\n- [ ] Scribe skill: decision-management with archival logic\r\n- [ ] CLI command: `squad scribe --archive-decisions [--dry-run]`\r\n- [ ] 30-day default threshold (configurable via team.md)\r\n- [ ] `status: permanent` tag in decision format to prevent archival\r\n- [ ] Migration: archive appropriate decisions from current 2K line decisions.md\r\n- [ ] Test: verify agents still find decisions after archival (via grep or semantic search fallback to archive)\r\n- [ ] Docs: document decision lifecycle in docs/features/memory.md\r\n\r\n## Out of Scope (Defer to v0.6.0+)\r\n\r\n- Semantic search across archived decisions (LLM-powered \"find similar past decisions\")\r\n- Decision dependency graph (\"this decision built on these prior decisions\")\r\n- Version history per decision (decisions.md is append-only, we rely on git history)\r\n","author":{"url":"https://github.com/bradygaster","@type":"Person","name":"bradygaster"},"datePublished":"2026-02-16T19:40:54Z","url":"https://github.com/github/squad/issues/85"}

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:6a41905b-da50-3d24-7cf0-4bf54284b706
current-catalog-service-hash81bb79d38c15960b92d99bca9288a9108c7a47b18f2423d0f6438c5b7bcd2114
request-idE33E:38E318:1311A6E:1809498:6B015C1E
html-safe-noncee74ee0b1f6a91cc528ca80acaab6fac2a5314eeab4f9703c4345bd1c7eda9e83
visitor-payloadeyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiJFMzNFOjM4RTMxODoxMzExQTZFOjE4MDk0OTg6NkIwMTVDMUUiLCJ2aXNpdG9yX2lkIjoiNzg3MzM1NDMxNzMyNjAxNTUxOCIsInJlZ2lvbl9lZGdlIjoiaWFkIiwicmVnaW9uX3JlbmRlciI6ImlhZCJ9
visitor-hmacf09eefc322cf432e6311872e7cd2236ca5aa81c7ddfe8eb0d9afe13887a8e1f3
hovercard-subject-tagissue:3949273383
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/85/issue_layout
twitter:imagehttps://opengraph.githubassets.com/6ff31d8dd49b337233c9528a0f827155d27bdadca953da2665c51785bdef5314/github/squad/issues/85
twitter:cardsummary_large_image
og:imagehttps://opengraph.githubassets.com/6ff31d8dd49b337233c9528a0f827155d27bdadca953da2665c51785bdef5314/github/squad/issues/85
og:image:altProblem User feedback: "we have a LOOOOOOT of old decisions and stuff. i know we've done a good deal of purging but, could we do a lot, lot more? we might want to come up with some skills for manag...
og:image:width1200
og:image:height600
og:site_nameGitHub
og:typeobject
og:author:usernamebradygaster
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/85#start-of-content
https://github.com/
Sign inhttps://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fgithub%2Fsquad%2Fissues%2F85
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%2F85
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/85
Reloadhttps://github.com/github/squad/issues/85
Reloadhttps://github.com/github/squad/issues/85
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/85
New issuehttps://github.com/login?return_to=https://github.com/github/squad/issues/85
#118https://github.com/github/squad/pull/118
Decision lifecycle management and archival systemhttps://github.com/github/squad/issues/85#top
#118https://github.com/github/squad/pull/118
feedbackUser feedback — high signal, needs attentionhttps://github.com/github/squad/issues?q=state%3Aopen%20label%3A%22feedback%22
release:v0.5.0Targeted for v0.5.0https://github.com/github/squad/issues?q=state%3Aopen%20label%3A%22release%3Av0.5.0%22
type:featureNew capabilityhttps://github.com/github/squad/issues?q=state%3Aopen%20label%3A%22type%3Afeature%22
v0.5.0https://github.com/github/squad/milestone/1
https://github.com/bradygaster
bradygasterhttps://github.com/bradygaster
on Feb 16, 2026https://github.com/github/squad/issues/85#issue-3949273383
feat: Issue Assignment & Auto-Triage for Squad Members #5https://github.com/github/squad/pull/5
chore: remove internal team-docs from main #42https://github.com/github/squad/pull/42
bradygasterhttps://github.com/bradygaster
v0.5.0https://github.com/github/squad/milestone/1
on Feb 16, 2026https://github.com/github/squad/issues/85#event-22834020073
bradygasterhttps://github.com/bradygaster
release:v0.5.0Targeted for v0.5.0https://github.com/github/squad/issues?q=state%3Aopen%20label%3A%22release%3Av0.5.0%22
type:featureNew capabilityhttps://github.com/github/squad/issues?q=state%3Aopen%20label%3A%22type%3Afeature%22
feedbackUser feedback — high signal, needs attentionhttps://github.com/github/squad/issues?q=state%3Aopen%20label%3A%22feedback%22
on Feb 16, 2026https://github.com/github/squad/issues/85#event-22834020415
bradygasterhttps://github.com/bradygaster
on Feb 20, 2026https://github.com/github/squad/issues/85#event-22941310439
feat: decision lifecycle management and archival system (#85)https://github.com/github/squad/commit/d033961def9c726b979f671fcee74014a30a6e86
#85https://github.com/github/squad/issues/85
d033961https://github.com/github/squad/commit/d033961def9c726b979f671fcee74014a30a6e86
bradygasterhttps://github.com/bradygaster
completedhttps://github.com/github/squad/issues?q=is%3Aissue%20state%3Aclosed%20archived%3Afalse%20reason%3Acompleted
on Feb 20, 2026https://github.com/github/squad/issues/85#event-22941478546
Sign up for freehttps://github.com/signup?return_to=https://github.com/github/squad/issues/85
Sign in to commenthttps://github.com/login?return_to=https://github.com/github/squad/issues/85
feedbackUser feedback — high signal, needs attentionhttps://github.com/github/squad/issues?q=state%3Aopen%20label%3A%22feedback%22
release:v0.5.0Targeted for v0.5.0https://github.com/github/squad/issues?q=state%3Aopen%20label%3A%22release%3Av0.5.0%22
type:featureNew capabilityhttps://github.com/github/squad/issues?q=state%3Aopen%20label%3A%22type%3Afeature%22
v0.5.0No due datehttps://github.com/github/squad/milestone/1
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.