Files
git.stella-ops.org/docs/implplan/AGENTS.md
master 8355e2ff75
Some checks failed
Docs CI / lint-and-preview (push) Has been cancelled
feat: Add initial implementation of Vulnerability Resolver Jobs
- Created project for StellaOps.Scanner.Analyzers.Native.Tests with necessary dependencies.
- Documented roles and guidelines in AGENTS.md for Scheduler module.
- Implemented IResolverJobService interface and InMemoryResolverJobService for handling resolver jobs.
- Added ResolverBacklogNotifier and ResolverBacklogService for monitoring job metrics.
- Developed API endpoints for managing resolver jobs and retrieving metrics.
- Defined models for resolver job requests and responses.
- Integrated dependency injection for resolver job services.
- Implemented ImpactIndexSnapshot for persisting impact index data.
- Introduced SignalsScoringOptions for configurable scoring weights in reachability scoring.
- Added unit tests for ReachabilityScoringService and RuntimeFactsIngestionService.
- Created dotnet-filter.sh script to handle command-line arguments for dotnet.
- Established nuget-prime project for managing package downloads.
2025-11-18 07:52:15 +02:00

3.0 KiB
Raw Blame History

AGENTS · docs/implplan (Coordination Sprints)

Purpose & Scope

  • Working directory: docs/implplan (sprint planning/coordination docs only). Cross-module edits must be explicitly noted in the relevant sprints Decisons & Risks.
  • Roles supported here: project manager, product manager, implementer (doc maintainer). No code changes are performed in this directory; focus on sprint plans, status, and cross-guild coordination.

Required Reading (treat as read before DOING)

  • docs/README.md
  • docs/07_HIGH_LEVEL_ARCHITECTURE.md
  • docs/modules/platform/architecture-overview.md
  • docs/implplan sprint template rules (see Section “Naming & Structure” below)
  • Any sprint-specific upstream docs linked from the current sprint file (e.g., crypto audit, replay runbooks, module architecture dossiers referenced in Dependencies/Prereqs sections)

Naming & Structure

  • Sprint filename format: SPRINT_<IMPLID>_<BATCHID>_<SPRINTID>_<topic>.md (see global charter §4.2). Normalize existing files to this format while preserving content and log the rename in Execution Log.
  • Internal template (required sections): Topic & Scope, Dependencies & Concurrency, Documentation Prerequisites, Delivery Tracker, Wave Coordination (if multi-wave), Wave Detail Snapshots, Interlocks, Upcoming Checkpoints, Action Tracker, Decisions & Risks (incl. risk table), Execution Log.
  • Status flow: TODO → DOING → DONE/BLOCKED. Flip status only when evidence is captured in the sprint doc.

Determinism & Metadata

  • Use UTC dates (YYYY-MM-DD) and include timezone labels for meetings if relevant.
  • Keep tables ordered deterministically (by task ID or due date). Avoid ad-hoc reshuffling.
  • When blocking, state the concrete dependency/document name and expected next signal/date.

Documentation Rules

  • For any design/advisory/platform decision surfaced here, update the canonical doc under docs/** (architecture, ADR, product advisory, etc.) and link it from Decisions & Risks.
  • Archival: completed tasks should flow to docs/implplan/archived/tasks.md as per sprint guidance.
  • Avoid external URLs unless already present; prefer relative doc links.

Cross-Module Coordination

  • Respect each modules AGENTS.md when touching module-specific sprint entries; do not change module instructions from here.
  • If a required module AGENTS.md is missing/outdated, mark the related task BLOCKED in that modules sprint and note it in Decisions & Risks here.

Ready-to-Start Checklist (per change)

  • Confirm template compliance of the sprint file youll edit.
  • Verify statuses reflect current reality before adding new actions.
  • Add Execution Log line summarizing what changed, with date and role.

Testing / Validation

  • No automated tests; validate by: (1) template conformance, (2) table integrity (columns align), (3) links resolve locally.

Contacts & Stand-ups

  • Follow sprint-specific checkpoint dates listed in “Upcoming Checkpoints”. Escalations are logged in Decisions & Risks, not via chat.