lessons-learned-validator

Lessons-learned validation enforces mandatory Problem → Solution → Example structure, checks file size limits (2,000 lines), verifies naming conventions, and ensures prevention-focused language across your documentation repository. Run the validator against your lessons file before committing updates.

The validator enforces consistent naming conventions, Problem/Solution/Example structure, prevention-focused language, cross-references, multi-file headers, and maximum 2,000-line file size limits to maintain knowledge quality and readability across your lessons repository.

Yes, the validator automatically detects files approaching or exceeding 2,000 lines and guides multi-file splitting procedures, preventing context overload while maintaining consistent format and naming standards across split files.

The validator checks supported role naming, enforces documentation structure requirements, validates file organization protocols, and confirms prevention-focused language compliance—identifying gaps before changes are committed to your repository.

The validator flags files at or near the 2,000-line threshold and provides guidance on multi-file management strategies, ensuring your documentation stays organized, searchable, and maintainable across the repository.

Yes, the validator applies to Phase 5 finalization, new lesson additions, and existing files regardless of size, enforcing consistent standards across your entire lessons-learned documentation repository using standard bash utilities.