engineering/java-topology
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

style: avoid "the", use "our" — writing style rule + sweep

Browse source
This commit is contained in:
russell@unturf.com 2026-03-31 13:19:39 -04:00
parent 3a755ecf01
commit 3b44a7a8de
1 changed files with 13 additions and 12 deletions
Download patch file Download diff file Expand all files Collapse all files

25
CLAUDE.md
View file

@ -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.