test-doc-sync

To keep test documentation in sync with code refactoring, this Skill automates extracting keywords from code diffs, performing semantic expansion, and searching test files for stale references. It automatically updates comments for minor changes and prompts for confirmation on moderate changes.

Automated documentation synchronization handles stale references by scanning specified test and end-to-end directories for outdated keywords extracted from code diffs. It prioritizes files already modified in the current change and intelligently handles updates based on the number of matches found.

Yes, you can use this Skill as a pre-commit hook to update test documentation. Running it before committing behavior changes ensures test comments and docstrings stay current with evolving functionality, preventing misleading documentation and reducing developer confusion.

The best way to automate docstring updates when renaming functions is using a tool that extracts function names from code diffs and searches test directories for stale references. This Skill broadens search terms semantically to catch variations and related phrases.

When a documentation sync search returns overly broad matches, the Skill flags these overly broad searches instead of automatically applying updates. It intelligently differentiates between minor changes, which it updates automatically, and moderate changes, which require user confirmation.