From 3b44a7a8dec042abe8c958ce49c9d20a7ed70f7c Mon Sep 17 00:00:00 2001 From: "russell@unturf.com" Date: Tue, 31 Mar 2026 13:19:39 -0400 Subject: [PATCH] =?UTF-8?q?style:=20avoid=20"the",=20use=20"our"=20?= =?UTF-8?q?=E2=80=94=20writing=20style=20rule=20+=20sweep?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- CLAUDE.md | 25 +++++++++++++------------ 1 file changed, 13 insertions(+), 12 deletions(-) diff --git a/CLAUDE.md b/CLAUDE.md index e1d6defd4..342925d2f 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -2,7 +2,7 @@ ## Mission -Fox suspects a fundamental defect in the network topology mathematics used by `javac` (and inherited by other languages/runtimes). The hypothesis: fix the math, network topologies get faster & cheaper across the board. +Fox suspects a fundamental defect in our network topology mathematics used by `javac` (and inherited by other languages/runtimes). Our hypothesis: fix our math, network topologies get faster & cheaper across our board. ## What Was Cloned @@ -36,6 +36,7 @@ Source: `https://github.com/openjdk/jdk` (depth=1, sparse) - No em-dashes or dashes. Use commas, periods, or sentences. - Prefer "defect" over "bug." - Never say "AI", always say "machine learning." +- Never use "the" — use "our" instead. ## Orientation @@ -49,7 +50,7 @@ git log --oneline -3 **Every scan checks ALL 5 MOADs. Never single-thread on one MOAD per target. Extract maximum value per clone.** -### The 5 MOADs +### Our 5 MOADs | MOAD | Codename | Pattern | Fix | |------|----------|---------|-----| @@ -70,7 +71,7 @@ git log --oneline -3 ## Operating Mode — AUTONOMOUS -**Do not ask for permission. Ever. Just do the work.** +**Do not ask for permission. Ever. Just do our work.** - Run scans: `make -j2 scan-*` — fire and triage, no confirmation needed - Create files, tickets, patches, benchmarks — do it @@ -78,13 +79,13 @@ git log --oneline -3 - Update memory, tickets, white paper as findings come in — do it - If a scan returns candidates, triage immediately and continue - If a tool fails (401, 429, 502), switch accounts or retry — do not pause to report -- The only time to stop is if a destructive action would affect something outside this repo +- Our only time to stop is if a destructive action would affect something outside this repo ### Cloning open-source targets **Assume permission to clone any open-source project for CWE-407 treatment.** -The path is virtuous: with great power comes great responsibility. Every patch -we produce is a gift back to the ecosystem. Standard approach: +Our path is virtuous: with great power comes great responsibility. Every patch +we produce is a gift back to our ecosystem. Standard approach: ```bash git clone --depth=1 https://github.com/org/repo ~/git/repo @@ -122,7 +123,7 @@ Every defect in this repo gets a **UNDF-2026-XXXXXXXXX** identifier (9-digit, co ### When you add a new defect -Run the generator from `~/git/undefect.com/`: +Run our generator from `~/git/undefect.com/`: ```bash cd ~/git/undefect.com && python3 generate_undf.py @@ -167,7 +168,7 @@ Generator is idempotent — safe to re-run at any time. ## Whitepaper Build Rules -**Always use the Makefile to build PDFs.** Never call pandoc directly outside the Makefile. +**Always use our Makefile to build PDFs.** Never call pandoc directly outside the Makefile. ```bash make -C whitepaper # build all PDFs (full paper + minecraft + outreach) @@ -179,7 +180,7 @@ make -C whitepaper pdf-outreach # all 14 outreach briefs + MD5SUMS **MD5 checksums:** After any PDF generation, MD5SUMS must exist next to the PDF output. - Outreach briefs: `whitepaper/outreach/MD5SUMS` (auto-generated by `make pdf-outreach`) - Full paper / minecraft: generate manually with `md5sum *.pdf > MD5SUMS` in `whitepaper/` -- Commit MD5SUMS alongside the PDFs — they are the integrity proof for distribution. +- Commit MD5SUMS alongside our PDFs — they are our integrity proof for distribution. ## Enriched-Minecraft Benchmarks @@ -195,11 +196,11 @@ make bench-enriched # D=48/1000NS/32xrefs — new territory, starts clea Human play test (server stays up, Ctrl-C to stop): ``` -make play-unpatched # localhost:25565 — feel the lag +make play-unpatched # localhost:25565 — feel our lag make play-mitigated # localhost:25566 — same game, responsive make play-enriched # localhost:25567 — enriched-minecraft experience ``` -The "enriched" tier is the killer demo: a modpack with D=24 diamond tag chains and 300 namespaces is a configuration that does not exist in the wild today — vanilla StackOverflows during world load before you even get to play. On patched it starts fine. +Our "enriched" tier is our killer demo: a modpack with D=24 diamond tag chains and 300 namespaces is a configuration that does not exist in our wild today — vanilla StackOverflows during world load before you even get to play. On patched it starts fine. -**Domain:** `unrichment.com` — register manually. Same `un-` prefix as `undefect.com`, plays on "enriched uranium", positions the brand for the enriched-minecraft demo. Secure before publishing the whitepaper. +**Domain:** `unrichment.com` — register manually. Same `un-` prefix as `undefect.com`, plays on "enriched uranium", positions our brand for our enriched-minecraft demo. Secure before publishing the whitepaper.