You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Optimize personal squad docs to encourage git-first usage (prevent data loss) #937
"I kind of think we should optimize all the docs on personal squads to encourage people to use git primarily because without it, you will suffer loss."
What this means
Personal squads store state in .squad/ — agent history, decisions, orchestration logs, skills. Without git:
Session state is ephemeral (lost on context window reset)
No cross-session memory persistence
No branch-level isolation of team state
No recovery from accidental deletions or bad decisions
Investigation needed
Audit current docs — which pages mention git? Which don't but should?
Identify gaps — where do we assume git without saying so? Where do we describe workflows that silently depend on committed .squad/ state?
Propose minimal doc changes — add git-first guidance with minimal touches (warnings, callouts, a "Why Git?" section)
Acceptance criteria
Audit of all docs pages re: git mentions completed
List of pages that need git-first callouts
Single PR with minimal doc changes that make git usage front-and-center for personal squads
Each changed page includes a clear warning about data loss without git
Activity
docs: optimize personal squad docs for git-first usage
docs: optimize personal squad docs for git-first usage
docs: optimize personal squad docs for git-first usage
docs: optimize personal squad docs for git-first usage (github#955)
docs: optimize personal squad docs for git-first usage (#955)