repository-maintenance

name	repository-maintenance
description	Systematic maintenance, debugging, updating, and health reporting for the agent factory codebase.
type	skill
version	1.0.0
category	routing
agents	["project-operations-specialist","master-system-orchestrator"]
knowledge	["factory-maintenance.json"]
scripts	["scripts/debug/audit_skills.py","scripts/debug/debug_braces.py","scripts/debug/debug_json_errors.py","scripts/debug/debug_knowledge_test.py","scripts/debug/diagnose_structure.py","scripts/debug/fix_knowledge.py","scripts/debug/fix_skills.py","scripts/debug/fix_trailing_commas.py","scripts/debug/normalize_knowledge.py","scripts/debug/verify_abap_templates.py","scripts/debug/verify_fastapi_templates.py","scripts/debug/verify_frontend_templates.py","scripts/debug/verify_skills.py","scripts/generate_health_report.py","scripts/maintenance/audit/audit_catalog.py","scripts/maintenance/audit/audit_refs.py","scripts/maintenance/audit/audit_skill_metadata.py","scripts/maintenance/audit/skill_reference_validator.py","scripts/maintenance/catalog/generate_catalogs.py","scripts/maintenance/catalog/generate_mapping.py","scripts/maintenance/catalog/reconstruct_catalog.py","scripts/maintenance/enforce_tmp_usage.py","scripts/maintenance/induction/drafting_engine.py","scripts/maintenance/induction/factory_induction.py","scripts/maintenance/knowledge_audit.py","scripts/maintenance/link_checker.py","scripts/maintenance/memory/formalize_workflow_memory.py","scripts/maintenance/predictive_slicing.py","scripts/maintenance/proactive_synthesis.py","scripts/maintenance/reconcile_memory.py","scripts/maintenance/reorganize_docs.py","scripts/maintenance/repair/deduplicate_components.py","scripts/maintenance/repair/fill_skill_gaps.py","scripts/maintenance/repair/fix_all_schemas.py","scripts/maintenance/repair/fix_artifact_naming.py","scripts/maintenance/repair/fix_broken_links.py","scripts/maintenance/repair/fix_knowledge_structure.py","scripts/maintenance/repair/fix_pattern_schema.py","scripts/maintenance/repair/fix_rag.py","scripts/maintenance/repair/fix_renames.py","scripts/maintenance/repair/fix_script_references.py","scripts/maintenance/repair/fix_skill_frontmatter.py","scripts/maintenance/repair/fix_skill_structure.py","scripts/maintenance/repair/fix_workflow_formatting.py","scripts/maintenance/repair/fuzzy_link_repair.py","scripts/maintenance/repair/move_workflows.py","scripts/maintenance/repair/rename_docs.py","scripts/maintenance/repair/repair_docs.py","scripts/maintenance/repair/sanitize_links.py","scripts/maintenance/repair/smart_migrate.py","scripts/maintenance/repair/standardize_doc_links.py","scripts/maintenance/repair/structural_remediation.py","scripts/maintenance/repair/update_blueprint_versions.py","scripts/maintenance/retrofit_assets.py","scripts/maintenance/sync/apply_knowledge_updates.py","scripts/maintenance/sync/apply_skill_updates.py","scripts/maintenance/sync/enrich_bundles.py","scripts/maintenance/sync/map_knowledge_to_skills.py","scripts/maintenance/sync/map_skills_to_agents.py","scripts/maintenance/sync/sync_catalog.py","scripts/maintenance/sync/sync_global_workflows.py","scripts/maintenance/sync/sync_memory_index.py","scripts/maintenance/sync/sync_script_registry.py","scripts/maintenance/sync/sync_upstream.py","scripts/maintenance/sync/sync_workflow_catalog.py","scripts/maintenance/sync/total_enrichment.py","scripts/maintenance/sync_memory.py","scripts/updates/blueprint_version_updater.py","scripts/updates/changelog_generator.py","scripts/updates/notification_system.py","scripts/updates/source_aggregator.py","scripts/updates/update_engine.py"]
tools	[]
related_skills	[]
references	[]
settings	{"auto_approve":false,"timeout_seconds":300}

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.