check-docs
Verify that all project documentation is accurate and up to date.
Steps
Read the current version. Open the root
package.jsonand note theversionfield. The Rust workspace version inCargo.toml(workspace.package.version) and the desktop app version inapps/desktop/src-tauri/tauri.conf.jsonmust match it.Check README.md.
- Confirm every command shown in README.md exists:
pnpmscripts (pnpm lint,pnpm test:cov, etc.) as scripts in the rootpackage.jsonor the relevant packagepackage.json;cargocommands (cargo test,cargo clippy,cargo run -p skillkeeper-cli, etc.) against the Rust workspace inCargo.toml. - Confirm the
--filternames (@skillkeeper/desktop,@skillkeeper/i18n) match thenamefields in the respectivepackage.jsonfiles. - Confirm the docs directory reference (
docs/) exists.
- Confirm every command shown in README.md exists:
Check docs/ navigation. Open
mkdocs.ymland verify:- Every file listed under
nav:exists underdocs/. - No nav entry points to a missing file.
- Every file listed under
Check documented CLI commands. For each command documented in
docs/(look for fenced code blocks withskillkeeperinvocations), verify the corresponding clap command still exists incrates/skillkeeper-cli/src/. Usecodegraph_searchor file inspection to confirm command names and option flags are present in the source.Check version references. Search
docs/andREADME.mdfor version strings. Any hardcoded version (e.g.,1.0.0) must match the version in rootpackage.json.Check CHANGES.md structure. Confirm the file carries its rules comment block, that
## Developmentis the first heading after it, and that previous release sections follow the## Version X.Y.Zheading format (no date). The block sits above## Developmenton purpose:release-notes.mjsextracts only from a## Versionheading to the next##, so anything above the first one never reaches a GitHub release.Report. List every issue found (missing files, broken nav links, stale commands, version mismatches). If everything is current, report "Docs are current." Do not edit documentation automatically -- propose corrections and let the developer apply them.