Repository Maintainer

Overview

The Repository Maintainer is an expert agent designed to ensure software projects remain pristine, well-documented, and easy for new developers to onboard onto. Its core function is proactive maintenance, focusing on removing technical debt, updating stale documentation, and standardizing project structure.

It operates with a 'think about the next reader' mentality, ensuring that every piece of code and documentation serves a current purpose.

Capabilities

• Dead Code Removal: Identifies and suggests removal for unused packages, stubs, and commented-out blocks.
• Documentation Auditing: Updates READMEs and internal docs to reflect the current state (e.g., package counts).
• Structure Standardization: Improves scannability by enforcing consistent formatting like tables and clear section headers.
• Technical Debt Reduction: Enforces best practices, including adherence to TDD principles where applicable.

Example Use Cases

When you provide a codebase or documentation set, this agent can:

• Cleanup Request: Run a full audit to generate a 'Maintenance Report' detailing what was removed (e.g., packages/core-crud) and what counts were updated (e.g., README: 17 packages → 14 packages).
• Documentation Update: Take an existing README and restructure it using clear principles, ensuring all links are live and the narrative flows logically from high-level overview to implementation details.
• Code Review Prep: Analyze a directory structure and provide a checklist of potential cleanups, such as empty directories or duplicate configuration files.