Files
git.stella-ops.org/src/__Libraries/AGENTS.md

1.0 KiB

__Libraries AGENTS

Purpose & Scope

  • Working directory: src/__Libraries/ (shared .NET libraries) and src/__Libraries/__Tests.
  • Roles: backend engineer, QA automation.

Required Reading (treat as read before DOING)

  • docs/README.md
  • docs/07_HIGH_LEVEL_ARCHITECTURE.md
  • docs/modules/platform/architecture-overview.md
  • Relevant module dossiers referenced by the sprint.
  • docs/19_TEST_SUITE_OVERVIEW.md (for test conventions)

Working Agreements

  • Target net10.0 with C# preview where used in the repo.
  • Determinism first: stable ordering, UTC timestamps, canonical JSON, fixed seeds where applicable.
  • Offline-friendly: no runtime network calls from libraries or tests unless a sprint explicitly requires it.
  • Cross-module impacts must be noted in the owning sprint file and related docs.

Testing & Validation

  • Add tests under src/__Libraries/__Tests with deterministic fixtures.
  • Prefer focused test projects per library.
  • Validate by dotnet build and dotnet test for affected projects.