# Opaque Runtime Behavior

> A defect in which runtime behavior emerges from hidden reflection, registration or binding that nothing reports, so the runtime's structure and state cannot be inspected.

Record: `architecture:opaque-runtime-behavior`
Kind: anti-pattern
Layer: [Enforcement Core](https://banes-lab.com/records/layer/enforcement-core.md)
Severity: discouraged
Scope: runtime_extensibility, metaprogramming_modeling
Aliases: Opaque Runtime
Canonical: https://banes-lab.com/ontology#architecture-opaque-runtime-behavior

Listed in [Architecture principles](https://banes-lab.com/api/records/architecture.md), after [Manual-Only Governance](https://banes-lab.com/records/architecture/manual-only-governance.md) and before [Unowned Risk](https://banes-lab.com/records/architecture/unowned-risk.md).

## Repair

- Refactored by: add_manifest, log_binding_decisions, emit_runtime_topology, add_capability_declaration, add_discovery_validation
- Detected by: dynamic_binding_without_manifest, missing_startup_report, unlogged_plugin_loading, implicit_reflection_scan, untraceable_side_effect
- Violated by: Let runtime behavior emerge from hidden reflection, implicit registration, undocumented configuration, side effects, or untraced dynamic binding.
- Measured by: dynamic bindings without a manifest entry
- Enforced by: manifest validation, a startup report that lists every binding

## Severity

- [discouraged](https://banes-lab.com/records/vocabulary/severity-discouraged.md)

## Category

- [Anti-patterns](https://banes-lab.com/records/architecture-category/anti-patterns.md)

## Force

- [Metaprogramming modeling](https://banes-lab.com/records/force/metaprogramming-modeling.md)
- [Runtime extensibility](https://banes-lab.com/records/force/runtime-extensibility.md)

## Negated by

- [Introspection](https://banes-lab.com/records/architecture/introspection.md)

## Linked from

- [Seven controls, seven classes](https://banes-lab.com/software-architecture/decay/seven-controls-seven-classes.md)
- [Anti-patterns](https://banes-lab.com/ontology/principles/architecture-category-anti-patterns.md)
- [Metaprogramming / Language-Oriented Architecture](https://banes-lab.com/ontology/principles/architecture-category-metaprogramming-language-oriented-architecture.md)
- [Severity levels](https://banes-lab.com/ontology/schema/the-vocabulary-severity.md)
- [The forces](https://banes-lab.com/ontology/schema/the-forces.md)