VibeGeometry/AGENTS.md

VibeGeometry Instructions

Purpose

VibeGeometry is the repository shell for the vg-csg Rust work surface.

The previous scene-generation mission has been deleted from the live tree. Do not recreate it unless the user explicitly asks to recover a historical artifact from git history.

The live mission:

domain/tree intent
-> LOD-aware CSG hierarchy
-> camera/frustum selected cut
-> triangle and collider output

Ownership

• crates/vg_csg owns implementation.
• The root workspace owns only wiring, submodule state, and very small guidance.
• If a new domain-tree DSL, selected-cut planner, streaming mesh cache, or frustum query API is needed, start inside vg-csg.
• Do not add root-level helper runtimes, prompt packs, visual translation corpora, or schema scaffolds.

Commands

git submodule update --init --recursive
cargo test
cargo clippy --all-targets --all-features
cargo run -p vg_csg --release --example csg_perf_fixture

Discipline

• Keep the runtime path legible: input tree, selected cut, brush/CSG lowering, emitted triangles, and timing evidence.
• Prefer tests and performance receipts inside vg-csg over root-level notes.
• Preserve exact parity only for public behavior the crate claims to mirror.
• RealtimeCSG is a reference seam, not an idol.
• Do not let historical scene-generation work become a live dependency again.