stella-ops.org/git.stella-ops.org
1
0
Fork 0
Code Issues Pull Requests Actions 2 Releases Wiki Activity
Files
108d1c64b323808d6085fca05818fc581c6b003a
git.stella-ops.org/src/Signals/StellaOps.Signals/AGENTS.md
master d519782a8f
Some checks failed
Docs CI / lint-and-preview (push) Has been cancelled
Details
prep docs and service updates
2025-11-21 06:56:36 +00:00

1.6 KiB
Raw Blame History

StellaOps.Signals — Agent Charter

Mission

Provide language-agnostic collection, normalization, and scoring of reachability and exploitability signals for Stella Ops. Accept static artifacts (call graphs, symbol references) and runtime context facts, derive normalized reachability states/scores, and expose them to Policy Engine, Web API, and Console without mutating advisory evidence.

Expectations

  • Maintain deterministic scoring with full provenance (AOC chains).
  • Support incremental ingestion (per asset + snapshot) and expose caches for fast policy evaluation.
  • Coordinate with SBOM/Policy/Console guilds on schema changes and UI expectations.
  • Implement guardrails for large artifacts, authentication, and privacy (no PII).
  • Update TASKS.md, /docs/implplan/SPRINT_*.md as work progresses.

Required Reading

  • docs/modules/zastava/architecture.md
  • docs/modules/platform/architecture-overview.md
  • docs/signals/unknowns-registry.md
  • docs/reachability/DELIVERY_GUIDE.md (unknowns + runtime ingestion sections)

Working Agreement

    1. Update task status to DOING/DONE in both correspoding sprint file /docs/implplan/SPRINT_*.md and the local TASKS.md when you start or finish work.
    1. Review this charter and the Required Reading documents before coding; confirm prerequisites are met.
    1. Keep changes deterministic (stable ordering, timestamps, hashes) and align with offline/air-gap expectations.
    1. Coordinate doc updates, tests, and cross-guild communication whenever contracts or workflows change.
    1. Revert to TODO if you pause the task without shipping changes; leave notes in commit/PR descriptions for context.