[kishuxz]

CONVENTIONS.md existed to explain which scaffolding conventions came from a reference project and which the brief overrode. That framing is useful to nobody but the author now. The conventions themselves still bind, so they move. The provenance goes.

Moved into CONTRIBUTING.md

All fifteen conventions, rewritten without the comparisons:

Convention	Kept because
ESM everywhere, .js on relative imports	A contributor adding a file has to match it
Packages resolve to src/index.ts, not dist/	Explains why there is no build step
engines, Node 20, packageManager	Setup
Strict beyond strict: true, with the five flags named	noUncheckedIndexedAccess is load-bearing for messages[]
ESLint, deliberately no formatter, plus the style rules that replace one	Tells you what the lint gate does and does not cover
Vitest configured once at the root	Tells you where to add a test
File-header block comments explaining the decision	The house style for new source files
Colon-namespaced scripts, plain verbs at top level	Naming a new script
Root scripts delegate to the owning package	Where a CLI is actually defined
Precise, greppable CLI failure output	The output is the gate on every corpus edit
Tolerant reads, strict writes	Why the validator reports all failures at once
Static invariants enforced by tests, not review	Directly answers "do I need a test for this"
Docs formatting	Writing a new document
.context/ is gitignored	Workspace hygiene

Dropped

• the reference-project narrative and every comparison clause
• the "Where the brief overrode gstack" table
• three decisions-log rows that recorded only that provenance: the Bun-to-pnpm/Vitest switch, and the no-linter position with its later reversal

The dropped table listed Node 20 + pnpm, Vitest, the packages/* + apps/* shape, and strict TypeScript. Every one of those survives elsewhere in the same file, in the engines convention, the Vitest convention, the Layout block and the strict-tsconfig convention, so nothing operational was lost. The no-linter reversal nets out to "ESLint yes, formatter no", which the Conventions prose now states directly.

The remaining ten decisions-log rows are design constraints a contributor still has to work within (spans validated inside ThreadSchema, UTF-16 offsets, bucket in the thread_id prefix, split stored per thread, quoted-substring authoring, IoU matching, three thresholds, prediction format living in eval, generated fixtures, committed results/). They move intact.

References removed

• CONTRIBUTING.md, both places: the Conventions pointer and the document-index row
• the README stopped linking to it when the document index moved in the previous PR
• PR bodies Phase 1: schema, monorepo scaffold, corpus #1, Phase 1e: ESLint, CI, and the contribution standard #14, Phase 1e: ESLint, CI, and the contribution standard #16 edited to drop their links

Zero CONVENTIONS or gstack references remain anywhere in the repo.

Verification

• pnpm check: 229 tests passing
• pnpm validate: 200 threads, 273 loops, 510 spans, all resolve. PASS
• No em or en dashes introduced

Scaffolding-era leftovers found elsewhere are reported in the PR discussion rather than changed here, per the brief.

🤖 Generated with Claude Code

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
openloop-bench	Ready	Preview	Aug 15, 2026 8:39am