docs: Add nap, reskill, and compact behavior documentation#448
Merged
bradygaster merged 7 commits intobradygaster:devfrom Mar 18, 2026
Merged
docs: Add nap, reskill, and compact behavior documentation#448bradygaster merged 7 commits intobradygaster:devfrom
bradygaster merged 7 commits intobradygaster:devfrom
Conversation
Developer-oriented guide explaining:
- Directory structure (.squad/agents/{name}/)
- charter.md format and parsing
- history.md append-only learnings
- Casting system (registry, policy, history)
- Relationship between .squad/ runtime and SDK source
- How an agent 'exists' (charter + roster + routing)
- Alumni pattern for retired agents
- Cross-agent context propagation
Requested by Brady via Dina. Addresses the question: 'What does it mean
on disk to be a Squad agent?'
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Adds a new feature page documenting context hygiene commands based on community confusion about whether shutting down Squad is equivalent to a nap (it is not). Key points documented: - Nap = /compact: actively summarizes and compacts memory files - Shutting down preserves files as-is (no compaction occurs) - Reskill re-examines and validates agent skills - Reskill currently requires running from source (symlink) - Combined command example for both behaviors with reporting Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Document all 9 diagnostic checks from the doctor command source code with their exact warning/failure messages and resolution steps. Update cli.md example output to match real doctor output format. Cross-link cli.md doctor section to the full troubleshooting reference. Addresses docs-opportunities item #8. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Stripped agent-on-disk.md and agent-inclusive-sdlc.md to keep PR focused on nap/reskill/compact behavior per Brady's preference for sparse docs. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
diberry
force-pushed
the
squad/docs-nap-reskill-compact
branch
from
4031b49 to
402281b
Compare
KalebCole
pushed a commit
to KalebCole/squad
that referenced
this pull request
Mar 17, 2026
Session: 2026-02-24T0430-prs-merged Requested by: Brady Changes: - Merged 6 decision inbox files into decisions.md (Cheritto, Fenster, Kovash, Marquez, McManus, Waingro) - Deleted all inbox files (now empty) - Created .squad/identity/prd-next-waves.md (4-wave execution plan: A=Polish, B=Reliability, C=Testing, D=Delight) - Updated .squad/identity/now.md to reflect Wave A focus - Created session log: .squad/log/2026-02-24T0430-prs-merged.md PRs merged this session: bradygaster#444, bradygaster#445, bradygaster#446, bradygaster#447 Issues closed: bradygaster#400, bradygaster#389, bradygaster#417, bradygaster#391, bradygaster#402, bradygaster#405, bradygaster#404, bradygaster#407, bradygaster#431, bradygaster#429 Issues filed: bradygaster#448-bradygaster#459 (Wave A Polish items) Process directive: All work through PRs with squad member review before merge Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
KalebCole
pushed a commit
to KalebCole/squad
that referenced
this pull request
Mar 17, 2026
…gaster#448, bradygaster#450) (bradygaster#464) - Unify agent status labels to bracket style [WORK] [STREAM] [ERR] [IDLE] across AgentPanel compact mode, AgentPanel normal mode, and /agents command - Add phase prop to ThinkingIndicator: 'connecting', 'routing', 'thinking' - Phase determines default label when no activityHint is provided - App.tsx passes phase='connecting' when SDK not yet connected, 'routing' otherwise Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
The PR added docs/features/context-hygiene.md but the test's EXPECTED_FEATURES array was not updated, causing the count assertion to fail (expected 34, got 35). Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Documenting the nap/reskill/compact behaviors based on community confusion about whether shutting down Squad nightly is equivalent to a nap (it's not).
New file:
docs/features/context-hygiene.mdKey points:
Updated file:
docs/reference/config.mdAdded a new .squad/ - Required vs Optional Files section covering:
squad init, with purpose and editability)