history-hygiene

Standardize project decision logs to record only final confirmed outcomes.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill prevents decision-making errors caused by stale or contradictory documentation in project history files.

Core Features & Use Cases

  • Outcome-Focused Logging: Ensures only final, confirmed decisions are recorded, preventing confusion from intermediate states.
  • Truth Verification: Provides a standardized pattern for updating history when decisions are reversed or corrected.
  • Use Case: When a team member reverses a technical decision, this Skill guides the agent to update the history file to reflect the final outcome rather than leaving the initial, now-incorrect request in the logs.

Quick Start

Use the history-hygiene skill to audit the current history.md file and ensure all entries reflect final outcomes rather than intermediate requests.

Frequently Asked Questions about history-hygiene

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

FAQPage Schema
How do I maintain accurate project history files and prevent stale decision logs?

To maintain accurate project history files, standardize documentation by enforcing the recording of final, confirmed outcomes over intermediate states. This prevents downstream agents from operating on contradictory data caused by reversed technical decisions.

What is the best way to update technical logs when a decision is reversed?

The best way to update technical logs after a decision reversal is to apply confirmation-based logging, immediately updating the project history file to reflect the final outcome rather than leaving the initial, now-incorrect request in the logs.

How do I audit decision journals to ensure they reflect final outcomes?

Auditing decision journals involves reviewing history files to verify that all entries document final, confirmed decisions instead of intermediate requests. This standardization pattern ensures downstream agents operate on accurate data.

Why does stale documentation in project history files cause decision-making errors?

Stale documentation in project history files causes decision-making errors because contradictory logs leave incorrect intermediate requests visible. Downstream agents then process invalid data, leading to execution based on reversed technical decisions.

Can I use confirmation-based logging for technical logs in any collaborative project?

Yes, confirmation-based logging applies to technical logs, decision journals, and project history files across collaborative projects. It requires strict adherence to immediate updates upon decision reversal to maintain a single source of truth.

What are the limitations of relying on intermediate states in project documentation?

Relying on intermediate states in project documentation creates confusion and contradictory history files. This approach fails to provide a single source of truth, causing downstream agents to execute on inaccurate data when decisions are reversed.