Skip to content

docs(governance): add Governance Dashboard pages for ADP GA#5

Merged
micheleRP merged 1 commit intomainfrom
adp-governance-dashboard-rewrite
Apr 29, 2026
Merged

docs(governance): add Governance Dashboard pages for ADP GA#5
micheleRP merged 1 commit intomainfrom
adp-governance-dashboard-rewrite

Conversation

@micheleRP
Copy link
Copy Markdown
Contributor

@micheleRP micheleRP commented Apr 28, 2026

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.
    • Microcent cost framing (1 cent = 100 microcents, $1 = 10,000 microcents) lifted verbatim from RFC 006.
    • Agent state badge mapping covers all 7 states from AgentRegistryService (Running, Stopped, Starting/Creating transient, Stopping/Deleting transient, Degraded w/ state_reason, Failed w/ state_reason).
    • 3 learning objectives (observable verbs: identify, choose, investigate — covering awareness/comprehension/skill).
  • 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.
  • Delete governance/dashboard.adoc — 4-line placeholder, superseded by the sub-folder structure.
  • Update modules/ROOT/nav.adoc — Trust & Governance section now has a Governance dashboard sub-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

  • Pre-beta (May 15): docs commit to GA only — the V0 reading guide in this PR is best-effort if it lands by then, not a beta deliverable. The two GA stubs render "Coming at GA" panels in the meantime.
  • GA (2026-06-15): stubs filled with live walkthrough content from adp-production once the V1 design + UI surface lands. Master Weeks 4–6 sequencing per the companion plan.
  • Plan: https://redpandadata.atlassian.net/wiki/spaces/DOC/pages/1882292252

Open questions / known issues

The V0 prototype lands on adp-production 2026-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:

  • Persona vocabulary mismatch. The PRD names HoT (Head of Trust), CIO/CFO, CISO, and FDE; this PR uses canonical docs-team-standards personas (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.
  • V1 design specs missing. Agent topology graph and authorization denial feed are V1 PRD one-liners; no design doc exists yet. GA pages blocked on those landing.
  • Microcent cost framing may simplify in the UI before GA. If so, the prose loosens.
  • Time-range selector defaults, dimension toggle UX, error-count source, tool-invocation source — all flagged with // TODO: markers, resolve via V0 prototype walkthrough.
  • agent-network.adoc and violations.adoc are stubs — full content arrives in subsequent commits Master Weeks 4–6.
  • Master plan was updated to follow the PRD/RFC in v17 (2026-04-28) — pre-beta scope for Consolidate Overview, retire LA admonition, add section landings #8 shifted from "topology + violations + auth denials" (originally listed) to V0's "summary cards + provider breakdown + fleet + activity"; topology + violations moved to GA per PRD; "policy editing from dashboard" pushed to V2 (post-GA, out of scope).

Test plan

  • Local build (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).
  • Walk the V0 prototype on adp-production (lands 2026-05-08); confirm widget descriptions match the live UI; capture annotated screenshot.
  • PRD AC walkthrough: a CIO can answer "how much did we spend?" within 30 seconds (AC-1); a CISO can see every agent + MCP server (AC-3); a HoT can find the agent with the highest error count (AC-4); an FDE can demo cold in under 2 minutes (AC-9). Per PRD §"Acceptance Criteria."
  • Confirm transcript deep-link target paths resolve once workflow docs(governance): scaffold Guardrails pages for ADP GA #7 (Transcripts) PR Reapply PR #560: Transcripts documentation rewrite for ADP GA #3 merges and stabilizes the URL pattern.
  • Resolve persona vocabulary alignment with docs-team-standards.
  • Fill agent-network.adoc and violations.adoc stubs with V1 walkthroughs (Master Weeks 4–6).
  • Editorial pass via docs-team-standards:review on every new page.
  • Remove adp-la.adoc partial includes at GA (Master Weeks 7–8).

🤖 Generated with Claude Code

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>
@netlify
Copy link
Copy Markdown

netlify Bot commented Apr 28, 2026

Deploy Preview for redpanda-agentic-data-plane ready!

Name Link
🔨 Latest commit 184294f
🔍 Latest deploy log https://app.netlify.com/projects/redpanda-agentic-data-plane/deploys/69f11bcb1696270008b15ba2
😎 Deploy Preview https://deploy-preview-5--redpanda-agentic-data-plane.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@micheleRP micheleRP marked this pull request as ready for review April 29, 2026 01:18
@micheleRP micheleRP requested a review from a team as a code owner April 29, 2026 01:18
@micheleRP micheleRP merged commit f6b37f0 into main Apr 29, 2026
4 checks passed
@micheleRP micheleRP deleted the adp-governance-dashboard-rewrite branch April 29, 2026 14:43
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
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