Issue
Output Breaks the Next Step
The AI output looks acceptable by itself but cannot be used by the next tool, workflow step, parser, reviewer, or downstream consumer.
What This Looks Like
The AI produces an answer, file, field, payload, or structured response that appears usable to the user, but the next step cannot consume it. A parser may reject it, a workflow may stop, a tool may fail, or a reviewer may be unable to continue because the output does not meet the next consumer’s requirements.
Why It Matters
AI output often sits in a chain. If the next step cannot use it, the answer is not operationally complete even if it looks reasonable in isolation. This can create hidden breakage where the user only discovers the issue after trying to pass the output into another system.
Structural Signal
The output crosses one boundary successfully but fails at the next interface. The issue is not only whether the output is understandable; it is whether the output fits the declared requirements of the downstream consumer.
Common Triggers
- The prompt optimizes for readable output instead of downstream compatibility
- The next step expects stricter structure than the user-facing answer provides
- Required fields, formats, labels, or delimiters are not preserved
- The answer mixes explanation with machine-consumable output
- The tool or workflow consumer has constraints not visible in the prompt
- A valid-looking answer violates a parser, importer, schema, or handoff contract
When to Use This Issue
Use this Issue when the AI output fails because the next workflow step, tool, parser, importer, or downstream consumer cannot use it as produced.
When Not to Use This Issue
Do not use this Issue when the output is simply factually wrong, incomplete for the user, or poorly written. Use it when the failure appears at the handoff into the next step.
Category
Primary Pattern
Declared Patterns
Compatibility Violation
A structural condition where a graph, object, behavior, or runtime state exceeds a declared compatibility envelope without an authorized exception.
Interface Mismatch
A structural condition where observed interface behavior, shape, or exchange differs from the declared interface contract.
Schema Breakage
A structural condition where an instance, graph, payload, or object violates the type, shape, or rule requirements of a declared schema.
Derived Primary Lenses
Compatibility Envelope Lens
Determines whether structure fits within declared runtime, platform, version, or support constraints.
Interface Contract Lens
Compares declared interface structure to observed runtime structure to detect contract deviations.
Invariant Lens
Verifies that declared invariants are structurally enforceable and not contradicted by observed structure.
Derived Secondary Lenses
Boundary Compliance Lens
Evaluates observed structure against declared boundary posture, including allow, block, and exception rules.
Conflict Lens
Detects mutually incompatible constraints, claims, states, or declarations that cannot be simultaneously satisfied.
Normalization Lens
Transforms structurally equivalent variants into a canonical form to prevent false divergence.
Related AI-Adjacent Issues
Agent Uses Old Tool Schema
An agent, prompt, workflow, or integration continues using an older tool schema after the tool contract has changed.
Generated Output Changed Hidden Metadata
Generated output changes hidden metadata, identifiers, references, state, or system fields that affect later behavior but are not obvious in the visible output.
Too Many Workflows Depend on One Tool
Many workflows, agents, checks, or downstream paths depend on one tool, connector, API, or integration, creating a shared point of failure.
Tool Call Caused Hidden Downstream Change
A tool call causes a downstream state, workflow, metadata, record, or integration change that is not visible at the point of action.
Search Intents
- output breaks the next step
- AI output fails downstream
- response cannot be used by next tool
- AI output breaks workflow
- output looks right but next step fails
- downstream parser rejects AI output