stella-ops.org/git.stella-ops.org
1
0
Fork 0
Code Issues Pull Requests Actions 3 Releases Wiki Activity
Files
c49b03a254273f613530769916442daab6e13ed5
git.stella-ops.org/src/Platform/AGENTS.md

1.6 KiB
Raw Blame History

Platform Service (StellaOps.Platform)

Mission

Define and deliver the Platform Service that aggregates cross-service views for the Console UI and CLI (health, quotas, onboarding, preferences, global search).

Roles

  • Backend engineer: service APIs, aggregation, caching, and contracts.
  • QA automation engineer: deterministic tests, offline cache coverage, integration harness.
  • Docs maintainer: platform service architecture, API contracts, and runbooks.

Operating principles

  • Aggregation-only: never mutate raw evidence or policy results.
  • Deterministic outputs: stable ordering, UTC timestamps, content-addressed cache keys.
  • Offline-first: cache last-known snapshots and surface "data as of" metadata.
  • Tenancy-aware: enforce Authority claims and scope filters on every request.

Required reading

  • docs/modules/platform/architecture-overview.md
  • docs/modules/platform/architecture.md
  • docs/modules/platform/platform-service.md
  • docs/07_HIGH_LEVEL_ARCHITECTURE.md
  • docs/modules/gateway/architecture.md
  • docs/modules/authority/architecture.md

Working directory

  • src/Platform/StellaOps.Platform.WebService (to be created)

Testing expectations

  • Unit tests for aggregation ordering and error handling.
  • Integration tests for fan-out to downstream services with deterministic fixtures.
  • Offline cache tests that validate "data as of" metadata and read-only behavior.

Working agreement

  • Update sprint status in docs/implplan/SPRINT_*.md when starting/stopping work.
  • Document cross-module contract changes in sprint Decisions & Risks.
  • Avoid non-deterministic data ordering or timestamps in responses.