Repository navigation
docs: development plan — eBPF node profiling - #26
Merged
Merged
Conversation
Living, slice-by-slice development plan realizing ADR 0011, as the shared source of truth so parallel work does not diverge. Records the 7 invariants every slice holds, the cross-cutting constraints and which slice owns each (no-symbol-egress-incl-logs, kernel-version-is-a-proxy, two-mode e2e, flag→config forward), and per-slice specs (goal/scope/files/signatures/ config/manifest/tests/acceptance/PR-must-state/deps). Notes the known landmines: slice 6 must publish a top-N snapshot rather than race the single-owner Accumulator; slice 5 keys profiles by capture interval (not a wall-clock bucket) so rotation never silently supersedes; slice 3 creates a GPL dir only if it vendors GPL source, NOTICE unconditionally. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
The living, slice-by-slice development plan realizing ADR 0011 — shared source of truth so implementation across slices doesn't diverge. Docs only.
What it pins
kernel_too_oldvsbtf_absent→ slices 2/3; (c) two-mode e2e (gate-refusal everywhere + capture on Linux+BTF) → slice 7; forward:-enable-ebpfmaster switch, config additive in slice 6.Landmines it heads off
Accumulator— the poller publishes a top-N snapshot into an atomic; the handler reads only that.start–end, not a wall-clock bucket — otherwise rotation silently supersedes earlier captures.NOTICEunconditional. An empty dir+LICENSE would mislead auditors.This is a plan (mutable), not an ADR — updated as slices land.
🤖 Generated with Claude Code