diff --git a/tech_docs/its_the_new_style_design.md b/tech_docs/its_the_new_style_design.md index 0b55632..68b5f30 100644 --- a/tech_docs/its_the_new_style_design.md +++ b/tech_docs/its_the_new_style_design.md @@ -1,3 +1,90 @@ +────────────────────────────────────────────── +SYMPHONY-IN-DNS +A playful yet practical naming grammar that satisfies all four axioms and the six meta-themes above. +────────────────────────────────────────────── + +1. The Clock-face /24 + Each subnet is a 12-hour dial. + .1–.12 → static hand (always metal) + .129–.254 → mirrored DHCP hand (fleet) + .127 is the silent 6 o’clock tick (never assigned). + The center of the dial (.0 and .255) are network and broadcast, the invisible pivots. + +2. Piano-key Roles (white keys only) + C = core (router/firewall) + D = data (database) + E = edge (load-balancer) + F = fleet-host (KVM / LXC metal) + G = gitops (CI runners) + A = app (generic workload) + B = backup + (If more are needed we borrow from the next octave, but 88 total hosts per role/zone is the ceiling.) + +3. Black-key Sequence + 01–88 padded to two digits. + Together with the white-key role this gives exactly 88 “piano” hosts per zone/role. + +4. Monospaced Zen + All tokens are either 1 or 2 characters; dashes are fixed. + Example: C-01, F-42, A-88. + In 10-pt DejaVu Sans Mono every hostname forms a 7-character block before the first dot. + +5. Prime Silence + Any IP whose last octet is prime is intentionally unassigned. + This carves quiet gaps into the otherwise symmetrical dial. + +6. Roman-serial Minimalism + Hostnames before the first dot are never longer than three visual glyphs: + <2-letter role><2-digit seq> + Everything after the first dot is context, never identity. + +7. Mirror-fold DNS + Forward and reverse zones are palindromic in cadence. + Example: + A-17.infra.mycorp.net ↔ 17.255.0.10.in-addr.arpa + Read either direction the beat is identical: A-seventeen-dot-infra / dot-seventeen-A. + +8. Mondrian Palette (zones) + infra (black) for infrastructure control plane + lan (red) for trusted internal services + dmz (blue) for untrusted / public ingress + guest (yellow) reserved for future lab boxes + No other zones will ever stain the canvas. + +────────────────────────────────────────────── +FULL GRAMMAR +-..mycorp.net + +role : C|D|E|F|G|A|B (white-key) +seq : 01–88 (black-key) +zone : infra|lan|dmz|guest + +────────────────────────────────────────────── +EXAMPLES + +Metal (static hand, .1–.12) +F-01.infra.mycorp.net → KVM host at 10.0.0.1 +C-02.infra.mycorp.net → router at 10.0.0.2 + +Fleet (mirrored DHCP hand, .129–.254) +A-17.lan.mycorp.net → LXC container at 10.0.0.145 +D-31.dmz.mycorp.net → staging Postgres VM at 10.0.0.159 + +Silence +10.0.0.11 (prime) is intentionally empty, giving the dial its quiet breath. + +────────────────────────────────────────────── +Spoken Haiku +Every FQDN is ≤ 17 syllables when read aloud: + +“A-seventeen-dot-lan-dot-mycorp-dot-net” +(5-7-5 cadence if you wish to keep it strict.) + +────────────────────────────────────────────── +Deploy it, print it in a fixed-width font, and the rectangle is flawless; listen to it and the rhythm is symmetrical. + +--- + Let’s park the tooling and simply **sweep the room for context we may have dropped**. Below is a quiet, point-by-point reconciliation of every layer we have spoken about, from the first line of `dnsmasq` to the last haiku syllable. If anything is missing, we’ll surface it now before we move forward.