caddy-migration
Auto-generated from project docs
North Star
Booklet Status
| Booklet | Status | Branch | Notes |
|---|---|---|---|
| B1 | DRAFT | booklet/caddy-migration-b1 | Staged migration — 5 steps with verification gates |
| ID | Type | Deliverable | Priority |
| ---- | ------ | ------------- | ---------- |
| B1-S0 | prep | Archive dead /var/www/ dirs to /root/backups/archived-sites/ | P0 |
| B1-S1 | test | Add wildcard block serving test.hitcreate.io ONLY | P0 |
| B1-S2 | migrate | Remove 5 dead project blocks from Caddyfile | P0 |
| B1-S3 | migrate | Remove Bolt experiment blocks in batches of 5 | P0 |
| B1-S4 | verify | Full verification pass | P0 |
Recent Decisions
| Date | Decision | Rationale |
|---|---|---|
| ------ | ---------- | ----------- |
| 2026-03-31 | Project kickstarted | INCIDENT-035 proved bulk Caddyfile edits are dangerous. Needs proper project treatment. |
| 2026-03-31 | Classification: I (Infrastructure), Bucket C | Internal capability, no revenue impact. 20% cap applies. |
| 2026-03-31 | 5-step staged approach | Each step isolated, verified, rollback-ready. Lesson from INCIDENT-035: never change >10 lines at once. |
| 2026-03-31 | Wildcard uses dns cloudflare with CLOUDFLARE_DNS_TOKEN | Token already in Caddy systemd env (INCIDENT-034 resolution). Module already installed. |
| 2026-03-31 | Verification script mandatory | INCIDENT-035 root cause #1: no post-deploy verification. Script must run after every reload. |
Source: /root/projects/caddy-migration/