docs(runbook): add Cloudflare wiki policy controls - #500
Conversation
Document read-only inspection, privacy-safe evidence, and approval-gated rollback and restoration for the public wiki. Refs #459 Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
There was a problem hiding this comment.
Pull request overview
Adds a new organization runbook that helps maintainers inspect Cloudflare controls affecting the public Z-Shell wiki (read-only by default), compare deployed behavior against repository-owned crawler/Content-Signal policy, and safely execute/verify a Pages rollback and forward restoration when explicitly approved.
Changes:
- Introduces a read-only-first inspection procedure covering Pages deployments, AI Crawl Control, analytics, and logging surfaces.
- Documents a public-safe evidence template and a clear security/privacy boundary for what can be recorded publicly vs. restricted systems.
- Defines a rollback decision checklist, approval requirements, and post-change verification/restoration steps.
💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.
There was a problem hiding this comment.
Pull request overview
Copilot reviewed 2 out of 2 changed files in this pull request and generated no new comments.
Suppressed comments (1)
runbooks/cloudflare-wiki-policy.md:41
- The security boundary section allows publishing “public response headers” (lines 31–33), but this bullet forbids publishing “request or response headers” (lines 40–41). That reads as a contradiction and could cause operators to avoid recording the specific public headers the runbook later requires.
Consider narrowing this bullet to prohibit raw headers captured from general-traffic logs (or other restricted sources), while still allowing the small public-safe header subset from explicit curl checks.
- client IP addresses, cookies, request or response headers, referrers, or raw
user-agent strings from general traffic; or
Distinguish whitelisted public response headers from restricted traffic data and mark Web Analytics retention values as documentation-only references. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
There was a problem hiding this comment.
Pull request overview
Copilot reviewed 2 out of 2 changed files in this pull request and generated no new comments.
Suppressed comments (1)
runbooks/cloudflare-wiki-policy.md:72
- The “public-safe template” is shown inside a fenced ```text block, but it contains a Markdown table. If someone pastes it verbatim into an issue, the table won’t render and is harder to read; the runbook should explicitly say to remove the code fence (or otherwise paste it as Markdown) so the table renders.
Copy this public-safe template:
```text
Summary
Content-Signalpolicy.Verification
CI=true trunk check --no-fix --filter=-gitleaks runbooks/cloudflare-wiki-policy.mdpython3 scripts/validate-agent-policy.pypython3 -m unittest scripts/test_validate_agent_policy.py -vgitleaksbinary locally.Instruction impact review
z-shell/.github.runbooks/cloudflare-wiki-policy.mdis the correct canonical owner for this procedure..github/instructions/mcp-plugins.instructions.mdremains capability guidance; the runbook owns the operational procedure..github/instruction-surfaces.jsonnow routes the runbook forcloudflare-wiki-policyandcloudflare-pages-rollbacktasks.Agent handoff
No handoff needed.
Fixes: #459