docs(runbooks): add runbook spec, template, index and 6 first-batch runbooks; light-enhance existing 10

- RUNBOOKS.md: repo-level spec (six-field model, naming, safety, maturity path)
- runbooks/_template.md + README.md: standard template and 16-entry routing index
- new: issue-to-merge, fix-ci, release, rollback, network-change, network-recovery
- light-enhance 10 existing runbooks with Purpose/Scope/Safety headers
- AGENTS.md: point step 3 at index/spec, add runbook execution rules
- docs/agent-runbook-guide.md: archive of Manus AI guide
This commit is contained in:
windyboy
2026-08-17 15:59:46 +08:00
parent 047ac03346
commit b0c01b2551
21 changed files with 1140 additions and 2 deletions
+15
View File
@@ -1,5 +1,14 @@
# AdGuard Home health — dns.windy.lan
## Purpose
Read-only health check of the AdGuard Home LAN DNS service.
## Scope
- Applicable: [dns.windy.lan](../hosts/dns.windy.lan.md) (`192.168.66.36`).
- Read-only: does not expose query-log contents or secrets; does not change configuration.
This runbook is read-only. It does not expose query-log contents or secrets.
Routine checks run through Ansible on demand:
@@ -58,3 +67,9 @@ a known-bad-signature test; an enabled DO bit alone is not validation.
Private PTR forwarding is intentionally absent because the EdgeRouter does
not currently answer private PTR requests.
## Safety
- Read-only: never change the DNS policy or the `agh-ui-access.service` nftables rule during this check.
- Do not infer a broken DNS policy from an empty `allowed_clients`.
- If live state conflicts with an expected value, `STOP` and report.