Skip to content

docs(prd): add PRD 0006 — Route alerts so they keep being read - #55

Merged
ralyodio merged 1 commit into
masterfrom
docs/prd-0006-alert-system
Jul 28, 2026
Merged

docs(prd): add PRD 0006 — Route alerts so they keep being read#55
ralyodio merged 1 commit into
masterfrom
docs/prd-0006-alert-system

Conversation

@ralyodio

Copy link
Copy Markdown
Contributor

Specification for the alert-system core module, listed in PRD.md and not yet specified.

Every module already depends on this one and it does not exist: spend-guard routes through it, code-scanner calls ctx.alert() in all four subsystems. The calls compile and the daemon runs, but nothing decides where an alert goes or whether it is a duplicate.

Alert fatigue is the primary failure mode of the whole product — a detection nobody reads is identical to one that never fired, so every module's work on precision is undone if routing sends 400 messages to one channel. The hard parts are deduplication by incident identity and escalation on change rather than repetition; delivery is trivial by comparison.

Spec only — no implementation in this PR.

Every module already depends on this one and it does not exist: spend-guard routes through it, code-scanner calls ctx.alert() in all four subsystems. The calls compile and the daemon runs, but nothing decides where an alert goes or whether it is a duplicate.

Alert fatigue is the primary failure mode of the whole product — a detection nobody reads is identical to one that never fired, so every module's work on precision is undone if routing sends 400 messages to one channel. The hard parts are deduplication by incident identity and escalation on change rather than repetition; delivery is trivial by comparison.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@ralyodio
ralyodio merged commit ef31372 into master Jul 28, 2026
8 checks passed
@ralyodio
ralyodio deleted the docs/prd-0006-alert-system branch July 28, 2026 17:43
@github-actions

Copy link
Copy Markdown

vu1nz Security Review

0 finding(s) in PR #?

No security issues found.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant