neat-freak

Reconcile agent memory and project documentation against the current codebase.

Updated May 26, 2026
One-click install
npx skills add https://github.com/XWIlluDelu/agent-share --skill neat-freak-xwilludelu
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: neat-freak
Source: https://github.com/XWIlluDelu/agent-share/tree/main/lib/neat-freak
Command: npx skills add https://github.com/XWIlluDelu/agent-share --skill neat-freak-xwilludelu

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Prevents knowledge rot by reconciling end-of-session agent memory and project documentation (CLAUDE.md, README, and docs/) so future agents and teammates always work from accurate, non-conflicting sources.

Core Features & Use Cases

  • OCD-level knowledge cleanup: Removes or migrates outdated, bloated, or mis-scoped content (especially historical narratives that don’t belong in CLAUDE.md).
  • Cross-layer alignment: Ensures the agent-memory layer, project root rules (CLAUDE.md/AGENTS.md), and external-facing docs/readme stay consistent and match the current codebase.
  • Rigorous, complete reconciliation: Performs a forced inventory of memory files and all markdown/doc files for every involved project, then applies a change-to-documents mapping so nothing is missed.
  • Cross-platform handoff readiness: Designed to work across Claude Code, OpenAI Codex, OpenCode, and OpenClaw with appropriate memory-path handling.

Quick Start

Ask your AI to run the neat-freak sync by saying: sync up.

Frequently Asked Questions about neat-freak

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

FAQPage Schema
How do I keep agent memory and project documentation synced with the current codebase?

To keep agent memory and project documentation synced, you need to reconcile files like CLAUDE.md and README against the current codebase. This process removes outdated content and ensures future agents work from accurate, non-conflicting sources.

What is the best way to prevent knowledge rot in multi-project repositories during handoff?

Preventing knowledge rot during handoff requires cross-layer alignment of agent memory and project rules. By performing a complete inventory of markdown files and applying deterministic edits, you ensure teammates and agents receive consistent, accurate project knowledge.

Does cross-platform agent handoff work across Claude Code and OpenAI Codex?

Cross-platform agent handoff works across Claude Code, OpenAI Codex, OpenCode, and OpenClaw by applying appropriate memory-path handling. This ensures knowledge consistency and proper documentation reconciliation regardless of the specific AI coding environment.

How do I clean up outdated and bloated documentation in my repository?

To clean up outdated and bloated documentation, you must enforce file size constraints and anti-bloat rules. This removes or migrates mis-scoped historical narratives from root rule files, keeping project documentation concise and strictly relevant.

When do I need to reconcile agent memory and docs?

You need to reconcile agent memory and docs during dev milestones, stale-doc reports, conflicting-memory incidents, and teammate or agent handoffs. This end-of-session cleanup guarantees knowledge consistency before context is lost or transferred.