history-hygiene
Record reconciled final outcomes to history.md, not intermediate requests or obsolete claims
- License 许可
- MIT
- 所属仓库
- github/squad
- 最近更新
- 2026-11-15
- Stars
- ★ 3.4k
- Forks
- 520
01 前言 Front Matter
- name
- history-hygiene
- domain
- documentation, team-collaboration
- source
- earned (stale history reversal incident, team intervention)
- confidence
- high
- description
- Record reconciled final outcomes to history.md, not intermediate requests or obsolete claims
03 SKILL.md 正文
<!-- Generated by Squad from the Squad SDK (claude-plugin.ts). Do not edit: run node scripts/build-claude-plugin.mjs. -->
Context
History files are cold-start context, not the source of truth for live behavior. Stale or incorrect entries poison decision-making downstream. A stale-history incident proved that an old history claim can cause future spawns to repeat a reversed decision. Reconcile an operational claim with current implementation, workflows, tests, documentation, skills, and applicable decisions before acting on it.
Scope
- Activate when recording, correcting, or promoting finalized operational history.
- Allowed targets: the explicitly selected history file and a focused reusable skill when the rule applies beyond one role.
- Exclusions: intermediate requests, stale assignments, roster metadata, and unrelated cleanup.
Patterns
- Record the final outcome, not the initial request.
- Wait for confirmation before writing to history — don't log intermediate states.
- If a decision reverses, update the entry immediately — don't leave stale data.
- Link authority for operational facts. Name the current source or workflow when a lesson depends on live behavior.
- Promote reusable rules. Move procedures and incident lessons that future roles need into a focused skill; history should retain only the evidence and outcome.
- Record shipped guidance changes. A change to a shipped skill or template requires a changeset/changelog entry, unless the repository's documented skip label or equivalent release exception is present.
Examples
✓ Correct:
- "Migration target: v0.8.17 (initial target was later corrected before execution)"
- "Node runtime: follow the current
package.jsonengines.noderequirement"
✗ Incorrect:
- "Migration target: v0.6.0" (when that request was later reversed)
- Recording what was requested instead of what actually happened
- Logging entries before outcome is confirmed
Stop conditions
- Stop if the outcome is not confirmed or current authority disagrees with the proposed entry.
- Stop if the target history file or promoted skill is outside the explicit scope.
- Stop if a shipped skill/template change has no changeset or documented release exception.
Anti-Patterns
- Writing intermediate or "for now" states to disk
- Attributing decisions without confirming final direction
- Treating history as authoritative over live source or workflow behavior
- Copying dated assignments, status reports, or retired workarounds into a reusable skill
04 同仓库更多 Skills
windows-compatibility
Cross-platform path handling and command patterns
versioning-policy
SemVer rules for Squad's stable, preview, insider, and local package versions
tiered-memory
Three-tier agent memory model (hot/cold/wiki) for context reduction per spawn
test-discipline
Design assertions that prove the actual contract and fail on realistic regressions
squad
Squad's command catalog and interactive menu. Invoke via /squad (slash command) or natural language ("squad commands", "what can squad do", "show me squad options"). Presents categorized operations (Install & Upgrade, Team Management, Issues & PRs, Plugins & Skills, Model & Cost, Sessions & State) as an interactive picker. Routes to the right squad CLI command or the Squad coordinator agent.
squad-version-check
Internals of how @bradygaster/squad-cli stamps its version, how `squad upgrade` works (what it preserves vs overwrites), and how to probe the npm registry for the latest version from a coordinator prompt.