Adapter Python Public Library¶
Refine one reusable-library profile into Python runtime, structural, and import-surface guidance.
Generated example
This page is generated from evaluations/scenarios/adapter-python-public-library.yaml. The scenario YAML remains the executable source of truth.
Request¶
Repository evidence¶
No repository signals.
Expected resolution¶
| Resolution layer | Expected |
|---|---|
| Profile | — |
| Modifiers | — |
| Language adapters | — |
| Framework adapters | — |
Normalized context¶
Skill modes¶
None.
Conflict decisions¶
None.
Significant decisions¶
None.
Principles under test¶
Forbidden outcomes¶
- Use a cast as evidence that external data is valid.
- Publish implementation modules as the accidental supported import surface.
Scenario source¶
schema_version: 0.10.0
id: adapter-python-public-library
description: Refine one reusable-library profile into Python runtime, structural,
and import-surface guidance.
input:
profile: reusable-library
language_adapter: python
task: Publish a parsing library with a small supported public API for independent
consumers.
expected:
resolution: parse-domain-values-and-stabilize-imports
guidance:
- Parse external values into domain objects because annotations do not enforce runtime
contracts.
- Use a narrow consumer-owned Protocol only where independent implementations are
required.
- Treat documented import paths and public exceptions as compatibility commitments.
active_principles:
- parse-dont-validate
- dependency-inversion-principle
- backward-compatibility
forbidden:
- Use a cast as evidence that external data is valid.
- Publish implementation modules as the accidental supported import surface.
principles_under_test:
- parse-dont-validate
- dependency-inversion-principle
- backward-compatibility