Skip to content
cccskills
FreePublished on GitHub

history-hygiene

Guides agents to record confirmed final outcomes in history.md and correct entries when decisions change. This keeps handoff records clear enough for future agents to understand what actually happened without checking other files.

OriginalShow the original description

Record final outcomes to history.md, not intermediate requests or reversed decisions

See how to install

Good for

  • Recording confirmed task outcomes
  • Correcting a decision that was reversed
  • Preparing history for an agent handoff
  • Reviewing records for outdated decisions

Files included (1)

  • SKILL.md1.6 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Context

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.

Patterns

  • Record the final outcome, not the initial request.
  • Wait for confirmation before writing to history — don't log intermediate states.
  • If a decision reverses, update the entry immediately — don't leave stale data.
  • One read = one truth. A future agent should never need to cross-reference other files to understand what actually happened.

Examples

✓ Correct:

  • "Migration target: v0.8.17 (initially discussed as v0.6.0, corrected by Brady)"
  • "Reverted to Node 18 per Brady's explicit request on 2024-01-15"

✗ Incorrect:

  • "Brady directed v0.6.0" (when later reversed)
  • Recording what was requested instead of what actually happened
  • Logging entries before outcome is confirmed

Anti-Patterns

  • Writing intermediate or "for now" states to disk
  • Attributing decisions without confirming final direction
  • Treating history like a draft — history is the source of truth
  • Assuming readers will cross-reference or verify; they won't

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Coordinate work across AI agents with shared rules for locating team files, recording decisions and their reasons, and requesting help. It also defines who owns revisions after a reviewer rejects an artifact.

  • Locate team files across separate working directories
  • Record decisions that affect other agents
  • Request input from another specialist
github/gh-aw5.4KUpdated Oct 19, 2026

agent-conduct

FreeSummary

Set shared development rules for an agent team: keep specific agent names out of product code, tests, and CI configuration, verify affected tests before finishing, and record lessons learned from mistakes.

  • Share development rules across multiple agents
  • Keep team-specific agent names out of code and tests
  • Check affected tests before declaring work complete
github/gh-aw5.4KUpdated Oct 19, 2026

Routes requests to design, create, update, debug, or upgrade GitHub Agentic Workflows to the appropriate instructions. It helps the agent select a workflow-specific procedure and apply any additional rules defined for the repository.

  • Designing a new workflow through questions
  • Investigating failed runs and recurring errors
  • Upgrading workflows and addressing deprecations
github/gh-aw5.4KUpdated Oct 19, 2026

Prepare architecture proposals before implementation so the team can agree on a direction. Organize evidence, technical choices, effects on existing work, risks, and the first release’s scope into a document with clear recommendations and decision owners.

  • Proposing a major architecture change
  • Replanning milestones after a foundation change
  • Comparing technical options before seeking approval
github/gh-aw5.4KUpdated Oct 19, 2026

Update the gh-aw-firewall version used by gh-aw, rebuild generated files, and review release notes and configuration schemas, which define valid settings. It guides related code and test updates while identifying follow-up work that remains.

  • Updating the firewall version used by gh-aw
  • Reviewing release notes for integration changes
  • Checking configuration schema differences
github/gh-aw5.4KUpdated Oct 19, 2026

Review git and gh operations in gh-aw workflows to check credential availability for each repository. Identify missing token handoffs, risky expansions of limited checkouts, and error handling needed where credentials are intentionally unavailable.

  • Reviewing git operations after repository checkout
  • Checking tokens for private cross-repository access
  • Reviewing sparse and shallow checkout changes
github/gh-aw5.4KUpdated Oct 19, 2026

See all skills by github

Report a problem with this skill