gitwalter 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:
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:
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.