history-hygiene

Record only final confirmed decisions and outcomes in history files.

3.1k|475|Updated Feb 6, 2026
One-click install
npx skills add https://github.com/bradygaster/squad --skill history-hygiene
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: history-hygiene
Source: https://github.com/bradygaster/squad/tree/main/.squad/skills/history-hygiene
Command: npx skills add https://github.com/bradygaster/squad --skill history-hygiene

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill prevents the accumulation of stale or incorrect information in history logs, which can mislead future AI agents and lead to repeated errors.

Core Features & Use Cases

  • Accurate Record Keeping: Ensures that only final, confirmed decisions and outcomes are recorded in history files.
  • Decision Integrity: Prevents intermediate or reversed decisions from polluting the historical record.
  • Use Case: When a team decides to update a project's version, this Skill ensures the history log reflects the final version number, not an earlier, discarded one, preventing downstream confusion.

Quick Start

Use the history-hygiene skill to record the final decision on the project migration target.

Frequently Asked Questions about history-hygiene

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I ensure history logs accurately record only final confirmed decisions?

To ensure history logs accurately record only final confirmed decisions, you need a process that filters out intermediate states and immediately updates entries upon reversal. This prevents stale or reversed information from polluting the historical record and misleading future agents.

Why does stale information in history logs mislead future AI agents?

Stale information in history logs misleads future AI agents because they rely on these records for context. If logs contain intermediate, discarded, or reversed decisions instead of final states, agents may repeat errors, follow abandoned paths, and make incorrect assumptions during downstream tasks.

What is the best way to maintain decision integrity in team collaboration documentation?

The best way to maintain decision integrity in team collaboration documentation is to enforce strict recording patterns that capture only confirmed, final outcomes. This requires updating or removing previous entries immediately when a decision is reversed to prevent downstream confusion.

How do I stop reversed decisions from polluting project history files?

To stop reversed decisions from polluting project history files, update the logs immediately upon any reversal to reflect the current confirmed state. Removing intermediate or discarded options from the record ensures the history file represents only the final decision.

When do I need to update history logs to prevent misleading AI agents?

You need to update history logs to prevent misleading AI agents whenever a previously recorded decision is reversed, modified, or finalized. Immediate updates ensure the historical record strictly mirrors confirmed outcomes and prevents stale data from accumulating.

Can I use history hygiene patterns for project migration target documentation?

Yes, you can use history hygiene patterns for project migration target documentation. They ensure the history log reflects the final, confirmed migration target rather than earlier discarded options, preventing downstream confusion and repeated errors.