# Repository Maintenance

> Systematic maintenance, debugging, updating, and health reporting for the agent factory codebase.

- Skill: `gitwalter/repository-maintenance` (Agent Skill)
- Install (CLI): `npx skillmds@latest add gitwalter/repository-maintenance`
- Raw SKILL.md: https://api.skillmd.com/api/skills/gitwalter/repository-maintenance/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: gitwalter (https://skillmd.com/u/gitwalter)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/gitwalter/repository-maintenance

---


# Repository Maintenance & Health Governance

This skill encompasses tools and workflows for maintaining repository integrity, validating metadata schemas, fixing structural drift, auditing catalog references, and publishing factory health metrics.

## When to Use
Use this skill when performing repository-wide code/doc audits, fixing broken links, cleaning schemas, retrofitting blueprints, or generating factory health reports.

## Prerequisites
- Conda environment setup.
- Access to root CLI utilities.

## Process

Follow these procedures for codebase maintenance and validation.

### Running Health Reports
Calculate codebase skill coverage and Plane Board statistics:
```bash
conda run -p D:\Anaconda\envs\cursor-factory python scripts/generate_health_report.py
```

### Repairing Structural Drift
To fix broken internal links and validate workflows:
```bash
conda run -p D:\Anaconda\envs\cursor-factory python scripts/maintenance/repair/fix_broken_links.py
```

## Best Practices
- **Backup Before Repair**: Always backup database and file configurations before applying structural fixes.
- **Check Constraints**: Ensure all knowledge additions validate against factory schemas.