Enhance help sync test to verify subcommand documentation
Author: bjcoombsCreated Jan 17, 2026Updated Jul 10, 2026
Labelsdocumentationenhancementgood first issuemedium-priorityarea:cli
Summary
Follow-up to #1594. The current help sync test only checks if commands exist in help documentation, not if their subcommands/options are correctly documented.
Problem
PR #1593 fixed outdated help documentation where:
tagsshowed old commands (add-tag,use-tag) instead of new subcommand structure (tags add,tags use)listwas missing new options (--watch,--ready,--blocking)
The test in #1595 wouldn't catch these issues because it only verifies command existence.
Proposed Enhancement
Add verification that:
tagssubcommands are documented (tags add,tags use,tags remove,tags rename,tags copy,tags list)- Key command options are documented (e.g.,
listshows--watch,--ready,--blocking)
Dependencies
- Requires #1593 to be merged first (or branch from it)
Related
- #1588 - Original help outdated issue
- #1593 - Fix for outdated help
- #1594 - Original test issue
- #1595 - Basic help sync test PR
Source: eyaltoledano/claude-task-master