From 83eaf12d6a2c2ae78f4e31d5c5c185409bc34b77 Mon Sep 17 00:00:00 2001 From: jyviko <2501648+jyviko@users.noreply.github.com> Date: Wed, 21 Oct 2026 08:48:47 -0400 Subject: [PATCH] AGENTS.md: the kernel does geometry, sugar lives above it The owner's rule for the kernel-smlib branch: the kernel runs exact operations and refuses what it cannot do exactly; sizes, standards tables, defaults, pre-checks and conveniences live in the engine and doc. Threads as the example: a helical sweep in the kernel, while the size table, the off-size refusal and multi-start threads are sugar. Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01QWhMwdqJYQKQq8RCLSL1LT --- AGENTS.md | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/AGENTS.md b/AGENTS.md index c61b87a60..f574d7ebd 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -24,6 +24,13 @@ solidcore's API (ADR 0002). Until it merges back, these rules differ from `main` `crates/smlib/src/ffi.rs` and its child modules `ffi/*.rs`, one per area of the C API. To build with SMLib, run `scripts/fetch-smlib.sh` (the fork at `crates/smlib/SMLIB_REV`), then add `--features solidcraft-kernel/smlib`. Without the feature nothing C++ is built and `solidcraft-smlib` answers every call with `NotBuilt`. +- **The kernel does geometry; sugar lives above it.** The kernel (SMLib, solidcore) runs exact + operations on a B-rep (booleans, blends, shell and offset, sweeps, a helical sweep, surface + intersection, measure, checks), takes strict inputs and refuses what it can't do exactly; it never + guesses or resizes. Sizes, standards tables, defaults, pre-checks and conveniences belong to the + engine and doc. A thread is a helical sweep in the kernel; its ISO size table, the check that + refuses a thread off its hole's or shaft's size, and multi-start threads (an array of helical + sweeps) are sugar. - **wasm is not checked** on this branch until the owner decides it. - **OpenCASCADE is never read, built or linked**, including usd-brep's former OCCT translators. - **No CI runs** for pull requests into this branch for now (owner).