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 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01QWhMwdqJYQKQq8RCLSL1LT
This commit is contained in:
jyvikoandClaude Opus 5.5 committed 2026-10-21 08:48:47 -04:00
1 parent bfe85e1eb1
commit 83eaf12d6a
1 file changed
+7
+7
View File
@@ -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).