Repository Maintainer

Overview

This skill turns disorganized codebases ("polluted roots," "orphan scripts") into structured, readable repositories. It prioritizes LLM-Readability (creating explicit context maps) and Safety (using a reversible migration manifest).

Use this skill when:

• A repository has too many files in the root directory.
• Documentation is missing, outdated, or scattered.
• An LLM struggles to find relevant context due to noise.
• You need to "refactor" the file structure without breaking git history.

Workflow

1. The Audit (Discovery)

First, analyze the repository to understand "Hot" (frequently changed) vs "Cold" (stale) zones.

• Run scripts/scaffold_manifest.py to generate a draft manifest.
• Identify the "blood flow" (dependencies): Does main.py import that messy script?
• Output: A mental model of the current chaos.