history-hygiene

Record final outcomes to history.md after explicit confirmation.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

History files (.md files tracking decisions, spawns, outcomes) are read cold by future agents. Stale or incorrect entries poison decision-making downstream. The Kobayashi incident proved this: history said "Brady decided v0.6.0" when Brady had reversed that to v0.8.17. Future spawns read the wrong truth and repeated the mistake.

Core Features & Use Cases

  • Record the final outcome: log what actually happened, not what was requested or proposed.
  • Wait for confirmation before writing to history: avoid premature entries.
  • Update entry immediately on reversals: reflect changes whenever a decision is reversed.
  • One read = one truth: history should be the single source of truth for future agents.

Quick Start

Confirm the final outcome and append it to history.md, updating any prior entry if the decision reverses.

Frequently Asked Questions about history-hygiene

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

FAQPage Schema
How do I record final outcomes in history files without logging stale decisions?

To prevent stale decision-tracking entries, this Skill enforces final-state logging by waiting for explicit confirmation before writing to history.md and immediately updating any prior entry when a decision is reversed.

Why does my team-collaboration history show a proposed decision instead of the final outcome?

Team-collaboration history files often incorrectly log proposed or intermediate requests instead of the final outcome. This Skill solves the problem by enforcing final-state logging, ensuring future agents consulting the single source of truth read what actually happened, not what was initially requested.

What is the best way to maintain a single source of truth for decision-tracking across agents?

Maintaining a single source of truth for decision-tracking requires enforcing final-state logging in history.md. This Skill records only confirmed outcomes and immediately updates entries when decisions reverse, ensuring future agents read accurate history.

Can I update a history.md entry automatically when a team decision is reversed?

You can update a history.md entry automatically when a decision is reversed. This Skill immediately modifies prior entries to reflect the reversal, ensuring the single source of truth remains accurate for future agents.

When should I not write intermediate requests to decision-tracking history files?

You should avoid writing intermediate requests to decision-tracking history files until the final outcome is confirmed. This Skill waits for explicit confirmation before writing, preventing premature entries from corrupting downstream agent decisions.