Summary

Scaffolds the Guardrails docs surface for the ADP GA push. Beta deliverable (master Week 3, May 4–8): single concept page covering the INPUT/OUTPUT phase model, the three evaluator types (PII / Toxicity / Custom webhook), violation framing, and attachment scope — fully written and ready to ship as best-effort beta content. 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.

• Beta page (concept-only): governance/pages/guardrails/index.adoc — anchors on RFC 0002 Phase 5; resource-model details left as TODO markers pending team-ai's post-pivot answer (cloudv2 commits e0a1ba0cee and 7eff2ecbbf restructured the proto after the phase5-aigw-guardrails branch was cut).
• GA stubs: create-guardrail.adoc (how-to), types-reference.adoc (per-type config schema reference), violations.adoc (read + troubleshoot violations), cost-tracking.adoc (per-evaluator cost shape + capping knobs).
• Nav: flat governance:guardrails.adoc replaced under Trust & Governance with a Guardrails parent + 5 children (Overview / Create / Types / Violations / Cost).
• Cleanup: deleted the 3-line governance/pages/guardrails.adoc placeholder.

Refs: DOC-2113 · Confluence plan · master plan workflow #5

Doc owner: Joyce Fee (per 2026-04-21 Confluence comment); Michele drafted this scope.

Per-page status:

Open Questions tracked in Confluence (26 items, grouped A–D):

• Group A (5 items) — API surface & resource model. Block GA pages.
• Group B (5 items) — Evaluator behavior. Needed for violations.adoc and types-reference.adoc polish.
• Group C (5 items) — Cross-cutting integration with Transcripts, Budgets, and Governance Dashboard.
• Group D (4 items) — Standalone-ADP wording, persona vocabulary, nav-label alignment, partial-include cleanup at GA.

Known transient-broken xref: cost-tracking.adoc cross-links to xref:governance:dashboard/index.adoc (Governance Dashboard sub-folder). That page is being added in adp-docs PR #5 and resolves once #5 merges. Same pattern as Budgets PR #6.

Out of scope (separate workstreams):

• Governance dashboard (workflow Consolidate Overview, retire LA admonition, add section landings #8 DOC-2116) — adp-docs PR docs(governance): add Governance Dashboard pages for ADP GA #5
• Token budgets & limits (workflow docs(governance): rewrite Token budgets and limits page for ADP GA #6 DOC-2114) — adp-docs PR docs(governance): rewrite Token budgets and limits page for ADP GA #6
• Kill switch (governance/kill-switch.adoc) — BYOC-only; not a numbered workflow

Preview pages

• Guardrails Overview (beta concept page) (new)

Test plan

• Confirm Trust & Governance nav renders the Guardrails sub-section with 5 children
• Walk the Overview page cold and confirm a first-time reader can answer: what a guardrail is, the three evaluator types, where violations show up
• Confirm the four GA stubs render with their TODO outlines visible
• (Master Week 2 pre-flight) Ping team-ai for the post-pivot Guardrail resource shape so GA-page drafting can begin in master Week 3
• (Master Weeks 4–6) Walk live aigwctl guardrail flow (or ADP UI if it ships) to fill TODO markers
• Watch for adp-docs PR docs(governance): add Governance Dashboard pages for ADP GA #5 to merge so the dashboard cross-link resolves
• (Master Weeks 7–8) Editorial pass via docs-team-standards:review; remove adp-la.adoc partial includes at GA

🤖 Generated with Claude Code