docs(prd): refine PRD + add SRE-centric React UI overhaul with permalinks - #29
Merged
Merged
Conversation
…inks Multi-agent refine-requirements pass over docs/reqs/main.md plus a new forward-looking workstream, reviewed across PM/Tech-Lead/Designer cycles. Refinement (folded in from completed-implementation context): - Detection: FR5 rate-vs-cumulative + infra denylist + 4σ floor; FR8 persisted cooldown (30m Completed / 60m Failed); FR9 ewma_warmup_samples semantics - Lifecycle: FR11 concurrency cap (defer-not-drop); FR13 orphaned-Running reconcile; NFR12 no false-positive burst on restart - UI: FR22/23/26/27 states; FR41-44 sidebar state machine; FR32 auto-refresh - New NFR18 (WCAG 2.1 AA, focus-visible, prefers-reduced-motion) - Measurable outcomes: two-clocks timing, evidence-backed pass condition, 3/3 run protocol; new Open Questions Q1-Q3 (deferred, non-blocking) New section - SRE-Centric React UI Overhaul (Phase 3 / v0.2.0): - Incremental Flask-BFF migration, incident-triage hero first - First-seconds information model; FR45-53, NFR19-24; DoDs + success metrics - FR48 blast radius gated on RFC 0001 Phase 3 (later increment) - FR51 component library on existing dark-first tokens -> /design-sync input - FR53 permalinks: per-surface URL-encoded state, deep-link via BFF shell - Open Questions R1-R6 (R2 resolved: Flask BFF) Co-Authored-By: Claude Opus 4.8 <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
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.
What
A docs-only change to
docs/reqs/main.md: a multi-agent refinement of the existing PRD plus a new forward-looking workstream. No code changes.1. Refinement of the existing (delivered) requirements
Folds decisions discovered during implementation back into the PRD so it's falsifiable and self-consistent. All resolved from existing context (architecture spec, UX spec, completed plan) — no scope changes to delivered work.
ewma_warmup_samplessemantics.Runningreconcile; NFR12 no false-positive burst on restart.focus-visible,prefers-reduced-motion).2. New section — SRE-Centric React UI Overhaul (Phase 3 / v0.2.0)
A forward-looking workstream, sequenced after the Phase 1 DoD.
/design-syncpass (this is the React layer whose absence currently blocks design-sync).#step), deep-linked via the BFF serving the React shell; ephemeral chrome (sidebar, scroll) stays local.Why
Review process
Each part went through a
refine-requirements-style multi-agent review (Product Manager / Tech Lead / Designer) with a second verification cycle; findings were resolved before commit (e.g., FR48/RFC-0001 dependency, BFF routing precedence, permalink per-surface state, design-token continuity).Notes for the reviewer
docs/plans/main.mdis intentionally untouched.