chore: switch docs watch to local-only automation

Author: hesreallyhim

.github/workflows/github-doc-watch.yml

@@ -133,3 +133,8 @@ temp/
 INTERNAL
 
 docs/planning/
+
+# Docs watch private/runtime artifacts
+docs/github-documentation/docs-check.json
+docs/github-documentation/docs-diff.md
+docs/github-documentation/docs-diff.patch

.gitignore

@@ -103,10 +103,27 @@ Windows is not supported (the action will fail fast with a clear error).
 - GitHub's primary rate limits appear to use fixed windows with reset times anchored to the first observed usage of the token (per resource bucket), rather than a rolling window. For `core`, e.g., this is 60 minutes from the first usage within an action. For other buckets, such as `search` the reset window is 60 seconds from the time of first use. (See [this document](./docs/RATE_LIMIT_TABLE.md) for a bucket-by-bucket breakdown.)
 - What happens after this reset window is crossed is that the "Amount Remaining" data is reset to the maximum for that bucket, and the "Reset Time" is also reset to the full reset-window duration from the time of polling. This is a major design constraint on an action such as the current one, because a polling-based measurement must be designed such that the gap between the last poll and the next reset time is minimized - any activity that happens after a given poll, and before the next reset, will be invisible to the poller. That is the justification for the strategy of 30-second polling, with some "extra polls" at the designated reset time - this allows for high-confidence tracking of API requests to buckets with 60-second reset windows. 
 
+## GitHub Docs Watch
+
+This repository uses a local-only docs-watch flow.
+
+Important copyright constraint: upstream GitHub docs bodies are **not** stored in this public repository. The tracked files under [`docs/github-documentation`](./docs/github-documentation) are metadata-only.
+
+Local commands:
+
+- `npm run sync:github-docs-state` (seed or refresh private baseline snapshots)
+- `npm run check:github-docs`
+- `npm run diff:github-docs`
+- `npm run docs-watch:local` (check + readable diff)
+
+Local outputs default to `.tmp/docs-watch/`.
+
+Recommended weekly automation: run `npm run docs-watch:local`, then have Codex review `.tmp/docs-watch/docs-diff.md`, classify impact, and open a draft fix PR when project changes are required.
+
 
 ## Disclaimer
 
-The statements made in this document, and the implementation decisions in the code, are made in strict adherence to the GitHub API and Actions documentation at the time of writing. In addition, our CI processes regularly check for updates to the core documents. Best efforts have been made for strict compliance with GitHub's policy recommendations and guidelines - however, we accept no responsibility for any penalties incurred by the use of this action.
+The statements made in this document, and the implementation decisions in the code, are made in strict adherence to the GitHub API and Actions documentation at the time of writing. In addition, our CI processes regularly check for updates to the core documents using metadata-only tracking in this public repository and private-state diffs for detailed review. Best efforts have been made for strict compliance with GitHub's policy recommendations and guidelines - however, we accept no responsibility for any penalties incurred by the use of this action.
 
 ## License
 

README.md

@@ -0,0 +1,27 @@
+# GitHub Docs Watch Metadata
+
+This directory stores **metadata only** for monitored GitHub documentation pages.
+
+Copyright policy constraint: upstream GitHub documentation bodies are intentionally not committed in this public repository.
+
+## Files
+
+- `rate-limit.md` and `rate-limits-for-the-rest-api.md`: frontmatter metadata (`redirect-link`, `content-sha256`) used for change detection.
+- No upstream Markdown body text is stored here.
+
+## Private state (required for full diff + LLM review)
+
+Readable diffs require a private local state directory that stores snapshot bodies outside this public repo.
+
+Example local state location:
+
+- `.tmp/docs-watch/state` (default for local scripts)
+
+## Local workflow
+
+1. (Optional, first run) `npm run sync:github-docs-state`
+2. `npm run check:github-docs`
+3. `npm run diff:github-docs`
+4. Ask Codex to review `.tmp/docs-watch/docs-diff.md` and classify project impact.
+
+Outputs are written under `.tmp/docs-watch/` by default.