agent-maintained-docs

To keep documentation updated automatically, this skill embeds descriptions in file headers and folder READMEs, then validates them using git hooks to ensure docs change alongside code.

The best way to enforce documentation updates is using pre-commit hooks like husky or lefthook to validate that file headers and folder READMEs are modified whenever source code changes are committed.

Pre-commit hooks validate file headers and folder READMEs by checking if documentation was updated alongside code changes, failing the commit if navigational aids for AI agents and developers are outdated.

Yes, you need git hooks for automated documentation generation enforcement, as this skill requires integration with tools like husky or lefthook to validate documentation currency at commit time.

Yes, you can make your codebase navigable for AI agents by embedding descriptions in file headers and folder READMEs, providing navigational aids that help agents understand evolving source trees.