docs(governance): add Governance Dashboard pages for ADP GA#5
Merged
Conversation
Greenfield Governance Dashboard pages for the Agentic Data Plane GA (2026-06-15), aligned to the Governance V0 PRD (Blair McKee, 2026-04-20) and RFC 006 "Governance Without Governator" (Chris Chapman, 2026-04-27). Phased per PRD V0/V1 split: * Beta (2026-05-15, V0) ships governance/dashboard/index.adoc — a reading guide for the V0 single-page Overview. Covers all five widgets (summary cards, token spend by LLM provider, events timeline, agents table, MCP servers table), persona-by-persona reading sections (CIO/CFO, CISO, Head of Trust, FDE), the transcript deep-link investigation pattern, and three empty states. Microcent cost framing lifted verbatim from RFC 006. Agent state badge mapping covers all 7 states from AgentRegistryService. * GA (2026-06-15, V1) layers in two more pages stubbed in this commit: governance/dashboard/agent-network.adoc (interactive topology graph) and governance/dashboard/violations.adoc (authorization denial feed). Both stubs render a "Coming at GA" panel and cross-link back to the index so nav resolves cleanly. Other changes: * Replace the flat governance/dashboard.adoc placeholder (4-line stub) with a sub-folder structure (dashboard/index + dashboard/agent-network + dashboard/violations). * Update modules/ROOT/nav.adoc Trust & Governance section: add a "Governance dashboard" sub-section with three children. Guardrails, Budgets, and Kill switch entries unchanged. * TODO markers on persona vocabulary (PRD names HoT/CIO/CFO/CISO/FDE; page metadata uses canonical docs-team-standards personas evaluator/platform_admin/app_developer until alignment is confirmed), on V0-prototype-only items (sign-in URL, IAM mapping, time-range selector, error-count source, tool-invocation source), and on the V1 forward-look section (topology + violations design specs not yet written; "What's coming at GA" needs revision once they land). Master plan and Confluence companion plan updated in v17 of the master ADP plan and at page 1882292252 respectively. Refs: DOC-2116 PRD: apps/adp-ui/docs/prds/001-governance-v0.md (cloudv2 feat/governance-prd-and-rfc branch) RFC: adp/rfcs/006-governance-without-governator.md (same branch) Plan: https://redpandadata.atlassian.net/wiki/spaces/DOC/pages/1882292252 Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
✅ Deploy Preview for redpanda-agentic-data-plane ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
This was referenced Apr 28, 2026
micheleRP
added a commit
that referenced
this pull request
Apr 29, 2026
Beta deliverable (master Week 3, May 4-8): single concept page covering INPUT/OUTPUT phase model, the three evaluator types (PII / Toxicity / Custom webhook), violation framing, and attachment scope. Anchors on RFC 0002 Phase 5; resource-model details left as TODO markers pending team-ai's post-pivot answer. GA deliverables (master Weeks 4-6): four pages stubbed with full outlines and TODO markers keyed to specific Open Questions in the Confluence companion plan, so live walkthroughs on adp-production can resolve them in place: - create-guardrail.adoc — how-to for configuring + attaching - types-reference.adoc — config schema reference per evaluator - violations.adoc — read & troubleshoot violations - cost-tracking.adoc — per-evaluator cost shape + capping Nav: replaces the flat governance:guardrails.adoc placeholder under Trust & Governance with a Guardrails parent + 5 children. The 3-line governance/pages/guardrails.adoc placeholder is deleted in this commit. Cross-link to governance:dashboard/index.adoc is transient-broken until adp-docs PR #5 (Governance Dashboard) merges; same pattern as Budgets PR #6. Refs: DOC-2113. Plan: https://redpandadata.atlassian.net/wiki/spaces/DOC/pages/1881702438 Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com> # Conflicts: # modules/ROOT/nav.adoc
8 tasks
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.
Summary
Greenfield Governance Dashboard pages for the Agentic Data Plane GA (2026-06-15), aligned to the Governance V0 PRD (Blair McKee, 2026-04-20) and RFC 006: Governance Without Governator (Chris Chapman, 2026-04-27). Implements workflow #8 (DOC-2116) per the Governance Dashboard companion plan.
Preview pages
What this PR does
governance/dashboard/index.adoc— Beta deliverable (V0). Reading guide for the V0 single-page Overview. 8 sections: Prerequisites, Open the dashboard, Reading each widget (5 sub-sections — summary cards, token spend by LLM provider, events over time, agents, MCP servers), Reading the dashboard for your role (4 persona sub-sections — CIO/CFO, CISO, Head of Trust, demo-readiness), Investigate via transcript deep-links, Empty states, What's coming at GA, Next steps.AgentRegistryService(Running,Stopped,Starting/Creatingtransient,Stopping/Deletingtransient,Degradedw/ state_reason,Failedw/ state_reason).governance/dashboard/agent-network.adoc— GA stub. Renders a "Coming at GA" panel + cross-links to the V0 overview and the violations stub.governance/dashboard/violations.adoc— GA stub. Same shape as agent-network.governance/dashboard.adoc— 4-line placeholder, superseded by the sub-folder structure.modules/ROOT/nav.adoc— Trust & Governance section now has aGovernance dashboardsub-section with 3 children (Read the overview / Agent Network / Authorization denials and violations). Guardrails / Budgets / Kill switch entries unchanged. Coordinates with the Guardrails companion plan which will modify the same Trust & Governance section in a separate PR.Status
adp-productiononce the V1 design + UI surface lands. Master Weeks 4–6 sequencing per the companion plan.Open questions / known issues
The V0 prototype lands on
adp-production2026-05-08 per the PRD milestone — most TODOs resolve via that walkthrough. The 18 open design questions are catalogued in the companion plan (groups A–D); the highlights:evaluator,platform_admin,app_developer) in the:personas:field and surfaces the PRD names in the persona-section headings only.// TODO:markers on each page flag the alignment question for docs-team-standards.// TODO:markers, resolve via V0 prototype walkthrough.agent-network.adocandviolations.adocare stubs — full content arrives in subsequent commits Master Weeks 4–6.Test plan
npm run build && npm run serve) renders the Trust & Governance > Governance dashboard sub-section with 3 children; index page resolves all xrefs (transcripts, byoa-telemetry, create-agent, mcp:index).adp-production(lands 2026-05-08); confirm widget descriptions match the live UI; capture annotated screenshot.agent-network.adocandviolations.adocstubs with V1 walkthroughs (Master Weeks 4–6).docs-team-standards:reviewon every new page.adp-la.adocpartial includes at GA (Master Weeks 7–8).🤖 Generated with Claude Code