Repo Housekeep

Full-cycle repository maintenance: documentation sync, dead file removal, dependency updates, and research-driven cleanup. Works with any project — auto-detects tech stack, package manager, and structure.

Critical Rules

NEVER delete files without confirming they are truly unused. Check imports, references, git blame, and config entries before removing anything.

NEVER blindly upgrade a major version. Major bumps may have breaking changes. Research the changelog before upgrading.

README must reflect reality, not aspiration. Only document what currently exists in the codebase.

Commit each phase separately. Documentation, cleanup, and dependency updates are independent concerns.