git.stella-ops.org/bench/AGENTS.md

bench/AGENTS.md

Purpose & Scope

• Working directory: bench/ (benchmarks, golden corpus, determinism fixtures).
• Roles: QA engineer, performance/bench engineer, docs contributor.

Required Reading (treat as read before DOING)

• docs/README.md
• docs/19_TEST_SUITE_OVERVIEW.md
• bench/README.md
• Sprint-specific guidance for corpus/bench artifacts.

Working Agreements

• Deterministic artifacts: stable ordering, fixed seeds, UTC timestamps.
• Offline-friendly: no network dependencies in benchmarks unless explicitly required.
• Keep fixtures and manifests ASCII and reproducible; avoid oversized binaries when possible.

Validation

• Validate manifests/fixtures with local scripts when available.
• Document any new fixtures in bench/README.md or sprint notes.