history-hygiene

Record final decision outcomes to history.md and update entries on reversals.

1|Updated Apr 18, 2026
One-click install
npx skills add https://github.com/DeDuva/squad --skill history-hygiene-deduva
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: history-hygiene
Source: https://github.com/DeDuva/squad/tree/main/packages/squad-cli/templates/skills/history-hygiene
Command: npx skills add https://github.com/DeDuva/squad --skill history-hygiene-deduva

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

History files track decisions, spawns, and outcomes, but often capture intermediate states or reversals. This Skill ensures history.md reflects final outcomes, providing a reliable single source of truth for future agents.

Core Features & Use Cases

  • Record the final outcome of decisions to history.md, ensuring a clean, auditable archive.
  • Update history entries immediately when a decision is reversed, preventing stale records.
  • Maintain a succinct, goal-oriented history for team alignment and project audits.

Quick Start

Log only final outcomes to history.md and update entries promptly when reversals occur.

Frequently Asked Questions about history-hygiene

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

FAQPage Schema
What should be recorded in a decision log to maintain a reliable audit trail?

Record only final outcomes to history.md, excluding intermediate requests or draft states, to maintain a clean and auditable decision log for future agents.

How do I update team collaboration history when a project decision is reversed?

Update history.md entries immediately when a decision is reversed to prevent stale records and ensure the final direction accurately reflects the current truth.

Why does my documentation include unconfirmed draft states in the history file?

Documentation includes draft states when intermediate requests are logged; history.md should avoid logging unconfirmed states and only store final outcomes for team alignment.

Can I use history.md to track intermediate requests for project decisions?

No, history.md is designed to document final outcomes only. It should not track intermediate requests, ensuring a succinct, goal-oriented history for project audits.

What is the best way to maintain a single source of truth for team collaboration outcomes?

Record final outcomes to history.md and update entries immediately upon reversals, avoiding unconfirmed draft states, to maintain a reliable single source of truth for team collaboration.