agents-maintenance

To validate CLAUDE.md and AGENTS.md files across a monorepo, run a scan to discover candidate directories and check bidirectional links, timestamp consistency, and content quality. The scan outputs an interactive report flagging broken links, redundancies, and missing coverage.

Fixing broken links and conflicting agent documentation uses interactive correction templates that detect redundancies and outdated guidance. The tool presents prompts to remove duplicates, add override notes, and show diffs before saving the repaired files.

To find missing AGENTS.md files during monorepo refactors, scan for candidate apps and packages using indicators like package.json, tsconfig, src/, tests/, and Dockerfile. The scan identifies directories lacking instruction files and suggests templates to ensure complete coverage.

Monorepo agent documentation validation works for release preparation and onboarding by ensuring per-package documentation is accurate and standardized. It detects missing coverage, mislinked instructions, and outdated guidance that cause runtime confusion and onboarding friction.

Timestamp checks and content quality validation detect outdated guidance and evaluate instructions for clarity, completeness, and actionability. This ensures agent documentation remains synchronized with code changes and provides consistent, reliable instructions across all packages.