VibeGeometry/AGENTS.md

# VibeGeometry Instructions

## Purpose

VibeGeometry is the repository shell for the CultGeometry 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:

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

## Ownership

- `crates/gamecult_geometry_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 CultGeometry CSG.
- Do not add root-level helper runtimes, prompt packs, visual translation
  corpora, or schema scaffolds.

## Commands

```powershell
git submodule update --init --recursive
cargo test
cargo clippy --all-targets --all-features
cargo run -p gamecult-geometry-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 CultGeometry 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.