Skip to content

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