Simplify agent instructions and reorganize SOW backlog

KT
7d ago
+1997-1332

First PR in a stack. Merge it before #14.

Changes

  • Consolidates the agent instructions in AGENTS.md and simplifies the review policy: the gate is the test suite plus the project manager's own review.
  • Merges the release-tagging skill into project-release, moves the journal-compatibility validation recipes into a reference file, and removes the agent-orchestration skill.
  • Reorganizes the SOW backlog after the Netdata usage review:
    • closes the obsolete Netdata OTEL writer SOW;
    • supersedes SOW-0049 and SOW-0050 with SOW-0164;
    • merges SOW-0155 into SOW-0156;
    • adds SOW-0162 (C reader crate), SOW-0163 (v0.11.0 release) and SOW-0164 (Netdata SDK adoption).

No SDK or CLI code changes.

Summary by cubic

Simplifies the agent instructions and review policy, and reorganizes the SOW backlog after the Netdata usage review. No SDK or CLI code changes.

  • Consolidates agent instructions in AGENTS.md: the review gate is now the test suite plus the project manager's own whole-SOW self-review, dropping the external-reviewer requirement. Removes the agent-orchestration and release-tagging skills, rewrites project-journal-compatibility as invariants with validation recipes moved to a reference file, and refreshes stale lifecycle text, SOW status, and Netdata citations in the process docs — including separating completed from closed SOWs and qualifying the no-CGO goal to the SDKs.

Backlog Reorganization

  • Closes SOW-0048 as obsolete (Netdata's OTel backend no longer writes journal files).
  • Supersedes SOW-0049 and SOW-0050 with SOW-0164 (Netdata SDK-exclusive adoption and vendored journal removal), and repoints SOW-0047 follow-ups there. Records the decision that libsystemd stays where available.
  • Merges SOW-0155 into SOW-0156.
  • Adds SOW-0162 (publishable C reader crate), SOW-0163 (v0.11.0 release), SOW-0164, SOW-0169 (pin the stock journalctl oracle in the interoperability matrices, with revision-level evidence), and SOW-0170 (tracked, not scheduled Rust rewrite of Netdata's systemd-journal.plugin).
  • Records that v1.0.0 is not scheduled (SOW-0066) and repoints it to the API stability decision, and refreshes stale blockers in SOW-0045 and SOW-0071.

Summary by CodeRabbit

  • Documentation
    • Reorganized journal compatibility guidance and added validation recipes covering reader, writer, recovery, performance, and interoperability checks.
    • Consolidated project workflow and release guidance, updated repository boundaries and review procedures, and removed separate orchestration and release-tagging guides.
    • Updated project status and planning records, including completed, paused, superseded, and proposed work. These records describe plans and decisions, not completed product changes.