VibeGeometry/AGENTS.md
2026-05-29 14:22:43 +01:00

45 lines
1.4 KiB
Markdown

# 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:
```text
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
```powershell
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.