docs: fix risk_tier vocabulary mismatch and add eval-level governance docs#1183
Merged
docs: fix risk_tier vocabulary mismatch and add eval-level governance docs#1183
Conversation
… docs (#1182) - Align agentv-governance skill to use short-form risk_tier values (high | limited | minimal) matching shipped examples and docs - Fix dead link in enterprise-governance.mdx (agent-eval-layers was stale) - Add eval-level governance section to enterprise-governance.mdx covering the governance: block shape, merge semantics, agentv-governance skill, and compliance-lint Action Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Deploying agentv with
|
| Latest commit: |
bdeadbf
|
| Status: | ✅ Deploy successful! |
| Preview URL: | https://284c389c.agentv.pages.dev |
| Branch Preview URL: | https://docs-1182-governance-fixes.agentv.pages.dev |
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
1 participant
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.
Closes #1182
Summary
agentv-governanceskill to use short-formrisk_tiervalues (prohibited | high | limited | minimal) matching all shipped red-team examples. Updatedeu-ai-act-risk-tiers.md,lint-rules.md,governance-yaml-shape.md, andSKILL.md. The skill was previously flagging valid evals as violations.enterprise-governance.mdx—[governance metadata]pointed to./agent-eval-layers/which has no governance content. Now links to the new#eval-level-governancesection on the same page.enterprise-governance.mdxcovering thegovernance:block YAML shape, merge semantics, theagentv-governanceskill (both authoring and CI modes), and the compliance-lint GitHub Action.Acceptance signals
enterprise-governance.mdxfixedeu-ai-act-risk-tiers.mdandlint-rules.mdin the skill usehigh | limited | minimalenterprise-governance.mdxdocuments the eval-levelgovernance:block shapeagentv-governanceskill and compliance-lint Action mentioned in docsbun run validate:examplespasses — 56/56 ✓Red/green UAT
Red (before):
lint-rules.mdRule 6 listedhigh_risk | limited_risk | minimal_riskas the only valid values. Any existing eval withrisk_tier: high(all 17 red-team suites) would produce a false lint violation.Green (after): Rule 6 now lists
high | limited | minimal. The "Common mistakes" section now correctly guides users from long-form (high_risk) to short-form (high), matching the actual field values in every shipped example.