karanmrn/karanagentskills/domain-dns-ops

Domain/DNS Ops (Peter)

This skill is a thin router: use ~/Projects/manager as truth, run the repo scripts, follow the checklists.

Source of truth (read first)

• ~/Projects/manager/DOMAINS.md (domain -> target map; registrar hints; exclusions)
• ~/Projects/manager/DNS.md (Cloudflare onboarding + DNS/redirect checklist)
• ~/Projects/manager/redirect-worker.ts + ~/Projects/manager/redirect-worker-mapping.md (worker redirects)

Golden path (new vanity domain -> Cloudflare -> redirect)

1. Decide routing model

• Page Rule redirect (small scale, per-zone).
• Rulesets / Bulk Redirects (account-level; needs token perms).
• Worker route (fallback; uses redirect-worker).

1. Cloudflare zone

• Create zone (UI), then confirm with cli4:
• cli4 --get name=example.com /zones

1. Nameservers

• If registrar = Namecheap: cd ~/Projects/manager && source profile && bin/namecheap-set-ns example.com emma.ns.cloudflare.com scott.ns.cloudflare.com
• If registrar = DNSimple: see ~/Projects/manager/DNS.md for delegation API notes.

1. DNS placeholders (so CF can terminate HTTPS)

• Proxied apex A + wildcard A → 192.0.2.1 (see ~/Projects/manager/DNS.md for exact cli4 calls).

1. Redirect

• If using Page Rules: use the cli4 --post ... /pagerules template from ~/Projects/manager/DNS.md.
• If using Worker: update mapping (~/Projects/manager/redirect-worker-mapping.md), deploy/bind routes per ~/Projects/manager/DNS.md.

1. Verify

• DNS: dig +short example.com @1.1.1.1 (expect CF anycast).
• HTTPS redirect: curl -I https://example.com (expect 301).

Common ops

• Cloudflare token sanity: follow the root secret rule; export only the needed Cloudflare token for one command.
• Disable “Block AI bots”: cd ~/Projects/manager && source profile && bin/cloudflare-ai-bots status / bin/cloudflare-ai-bots disable.

After edits (commit/push)

If you changed anything in ~/Projects/manager (docs, worker, scripts, mappings): commit there too.

1. Review: cd ~/Projects/manager && git status && git diff
2. Stage: git add <paths>
3. Commit (Conventional Commits): git commit -m "feat: …" / fix: / docs: / chore:
4. Push only when explicitly asked: git push origin main

Guardrails

• Don’t touch .md lore domains or steipete.md unless explicitly asked; check ~/Projects/manager/DOMAINS.md.
• Confirm registrar before debugging CF “invalid nameservers” (often “wrong registrar”).
• Prefer reversible steps; verify after each change (NS → DNS → redirect).