Detect documentation drift, score confidence, and orchestrate refresh via generator plugins (interpath for product docs, interdoc for code docs)
You are monitoring documentation freshness. Follow these steps.
Read doc-watch/references/watchables.md to understand the watchable registry format, then read the project's config/watchables.yaml to get the list of documents to monitor.
Read doc-watch/phases/detect.md and evaluate each watchable's signals. For each signal, check whether the triggering condition has occurred since the doc was last updated.
Read doc-watch/phases/assess.md and compute a confidence tier for each watchable based on its accumulated signal weights.
Read doc-watch/phases/refresh.md and take the appropriate action based on confidence:
| Confidence | Action |
|---|---|
| Certain | Auto-refresh silently |
| High | Auto-refresh with brief note |
| Medium | Suggest refresh via AskUserQuestion |
| Low | Report drift score only |
This skill supports three modes (set by the invoking command):