doc-invalidation-checker

# Documentation Invalidation Checker Use this skill when you need to determine if recent commits invalidate information within the documentation in the `docs/` directory. ## Steps to Perform Analysis 1. **Retrieve Recent Commits**: Execute the `get_recent_commits.py` script to fetch the recent commits with their diffs: ```bash agents/scripts/get_recent_commits.py 5 ``` 2. **Identify Relevant Documentation**: Look at the modified files and descriptions in the commit diff. Identify which files in `docs/` discuss the modified modules or concepts. 3. **Invoke the Subagent for AI Analysis**: Use the `invoke_subagent` tool to call a subagent with the `pro` model tier. Provide the subagent with: - The commit message and diff. - The content of the relevant file(s) from `docs/`. 4. **Subagent Analysis Prompt**: The subagent should receive a prompt like: > Compare this commit diff with the documentation file `[doc_path]`. Does > this commit make any statement, step, or configuration in the documentation > obsolete, incorrect, or deprecated? If yes, specify exactly what section is > invalidated and provide recommended text edits. 5. **Document and Present**: Collate the invalidation findings into a walkthrough report for update. ## Tools Used - **[get_recent_commits.py](../../scripts/get_recent_commits.py)**: Retrieves recent commits and their diffs.