agents-maintenance

What problem does it solve?

Maintains consistency and correctness of agent instruction files (CLAUDE.md and AGENTS.md) across monorepos by detecting broken links, redundant or conflicting instructions, missing coverage, and outdated documentation that cause onboarding friction and runtime confusion.

Core Features & Use Cases

• Repository discovery: Finds candidate apps/packages that should have AGENTS.md based on package.json, tsconfig, src/, tests/, Dockerfile, and common monorepo paths.
• Pair & link validation: Verifies CLAUDE.md ↔ AGENTS.md pairs, enforces bidirectional links, and fixes or flags missing links.
• Content quality checks: Compares timestamps, detects redundancy vs conflicts, and evaluates instructions for clarity, completeness, and actionability.
• Interactive correction mode: Presents prompts to create templates, remove duplicates, add @override notes, and show diffs before saving.
• Use cases: Run after refactors, when adding/moving apps, during onboarding, or before releases to ensure agent docs are accurate and standardized.

Quick Start

Run agents-maintenance to scan the repository for missing or inconsistent CLAUDE.md and AGENTS.md files and receive an interactive report with suggested fixes.