Issue
Actual Policy Differs From Declared Policy
The policy the AI or workflow actually follows differs from the policy that is documented, declared, displayed, or expected.
What This Looks Like
The documented, displayed, or declared policy says one thing, but the AI or workflow behaves according to another rule. The user may see an output, refusal, escalation, routing choice, or permission result that does not match the policy they were told applies.
Why It Matters
Policy mismatch breaks trust and auditability. Users rely on declared policy to understand what should happen, but the actual system behavior may be governed by a different version, hidden rule, product change, or implementation detail. This makes it hard to tell whether the policy, the system, or the expectation is wrong.
Structural Signal
The declared policy state and the observed governing behavior do not match. The issue is not merely that the user dislikes the policy; it is that the system appears to follow a different policy than the one declared.
Common Triggers
- Documentation is outdated relative to runtime behavior
- Product policy changes before public-facing text is updated
- A hidden or internal rule overrides the declared policy
- Different environments apply different policy versions
- The AI retrieves a policy statement that is no longer authoritative
- Workflow implementation does not match written policy language
When to Use This Issue
Use this Issue when the AI or workflow appears to follow a policy different from the documented, declared, displayed, or expected policy.
When Not to Use This Issue
Do not use this Issue when the policy is unclear but not contradicted by behavior. Do not use it for a one-off bad answer unless the observed behavior shows a mismatch between declared policy and actual governing rule.
Category
Primary Pattern
Declared Patterns
Contract Drift
A structural condition where a declared contract changes but connected structures, implementations, consumers, or expectations do not update in sync.
Authority-State Mismatch
A structural condition where observed system state no longer aligns with the declared authority state that is supposed to govern it.
Silent Mutation
A structural condition where a change occurs without a corresponding declared update, authority update, or version change.
Derived Primary Lenses
Convergence Lens
Compares parallel structural systems to determine whether they align under shared authority.
Determinism Lens
Evaluates whether identical structural inputs produce equivalent structural outputs across repeated executions.
Reconciliation Lens
Evaluates whether structural changes align with declared authority updates, version changes, or reconciliation rules.
Reference Stability Lens
Evaluates whether structural references, identifiers, nodes, and edges remain consistent across execution cycles or comparable states.
Derived Secondary Lenses
Related AI-Adjacent Issues
Documented Field Not Available at Runtime
A documented field, option, parameter, property, or capability is expected by the user or agent but is not available in the actual runtime.
Guardrail Applies to One Model Path Only
A guardrail, policy, validation rule, safety check, or workflow constraint applies to one model path, mode, runtime, or route but not another.
Low-Level Configuration Overrides Workflow Policy
A low-level configuration, product setting, connector rule, runtime option, or environment flag overrides the workflow policy the user expects to govern the task.
Permission Change Not Applied
A permission, approval, role, policy, or access change is made but the AI, agent, tool, or workflow continues behaving as if the old permission state still applies.
Runtime Behavior Does Not Match Docs
Documented behavior, fields, tool schemas, permissions, or runtime capabilities do not match what actually happens during use.
Search Intents
- actual policy differs from declared policy
- AI behavior does not match policy
- documented policy differs from actual behavior
- policy says one thing AI does another
- declared policy not followed
- runtime policy differs from docs