1.8 KiB
1.8 KiB
id, title, workspaceRoot, schedule, tools, mode, enabled, modelSelection, timeoutSeconds, maxIterations, tags, metadata
| id | title | workspaceRoot | schedule | tools | mode | enabled | modelSelection | timeoutSeconds | maxIterations | tags | metadata | |||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| documentation-check | Documentation Coverage Audit | /absolute/path/to/repo | 0 5 * * THU | run_commands,read_files,search_codebase | plan | false |
|
1800 | 25 |
|
|
Audit documentation coverage across the codebase:
-
Check public API documentation:
- Functions exported from public modules
- Classes and interfaces
- Type definitions and generics
- Decorators and annotations
-
Identify missing documentation:
- Public functions without JSDoc comments
- Complex functions without explanation
- Public types without descriptions
- Exported modules without README or header comments
-
Evaluate existing documentation quality:
- JSDoc comments without @param or @return tags
- Comments that are outdated or misleading
- Code samples in docs that may be broken
- Links in documentation that point to removed code
-
Analyze documentation structure:
- Main README quality and completeness
- Architecture documentation
- Contributing guide existence
- API reference documentation
- Changelog maintenance
Generate report with sections:
- Documentation coverage percentage by module
- Top 10 undocumented public APIs
- Types with missing descriptions
- Files with complex logic needing explanation
- Outdated documentation instances
Recommendations:
- High-priority items (public APIs without docs)
- Documentation style improvements
- Template suggestions for JSDoc
- Links that need updating
Use plan mode to suggest improvements without applying changes.