history-hygiene

Record final project outcomes in history files after decision confirmation.

Updated Apr 12, 2026
One-click install
npx skills add https://github.com/barichter/squad --skill history-hygiene-barichter
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: history-hygiene
Source: https://github.com/barichter/squad/tree/main/.copilot/skills/history-hygiene
Command: npx skills add https://github.com/barichter/squad --skill history-hygiene-barichter

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill addresses the issue of maintaining an accurate and reliable project history by ensuring that only the final outcomes of decisions are recorded.

Core Features & Use Cases

  • Accurate Outcome Recording: Logs the final results of decisions, avoiding intermediate steps and reversing decisions from appearing.
  • Confirmation Before Logging: Emphasizes the importance of waiting for a decision's confirmation before logging to history, to avoid confusion or mistakes.
  • Final Truth in History: Ensures a clear single truth in historical records, reducing the need for cross-referencing by future team members.

Quick Start

Confirm the final decision before logging it in history.md. For example, 'After careful consideration, we've settled on migrating to Node 18.'

Frequently Asked Questions about history-hygiene

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

FAQPage Schema
How do I record only final project decisions in history files?

To record final project decisions accurately, you must confirm the ultimate outcome before logging it to history files. This prevents intermediate steps or reversed decisions from being misinterpreted as the final truth by future team members.

Why does logging intermediate project outcomes cause confusion in team collaboration?

Logging intermediate project outcomes creates confusion because team members may misinterpret unconfirmed or reversed decisions as the final truth. Waiting for confirmation before recording to history files ensures a clear single truth and reduces cross-referencing.

What is the best way to maintain project history when decisions can reverse?

The best way to maintain project history when decisions can reverse is to wait for final confirmation before logging. This ensures that only the ultimate decision is recorded, preventing incorrect intermediate outcomes from polluting historical records.

How do I prevent intermediate steps from appearing in decision logging?

You prevent intermediate steps from appearing in decision logging by enforcing confirmation before writing to history files. This practice guarantees that only the final, settled outcome is committed as the single truth for the team.

Do I need to confirm a decision before logging it to project history?

Yes, you need to confirm a decision before logging it to project history. Confirming the final outcome prevents the misinterpretation of intermediate or incorrect results as the ultimate decision, ensuring accurate knowledge retention.

When should I not use automated decision recording for project history?

You should not use automated decision recording when project decisions can still reverse or be reconsidered. Logging unconfirmed intermediate outcomes creates a misleading project history that requires future team members to cross-reference mistakes.