Skip to content

Commit c8f7e91

Browse files
committed
docs: clarify runtime migration boundary
1 parent cf315dd commit c8f7e91

1 file changed

Lines changed: 1 addition & 0 deletions

File tree

AGENTS.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -64,6 +64,7 @@ Skills own workflows; root owns hard policy and routing.
6464
- Tests may use observed examples, but prod literals need a short contract reason.
6565
- Compatibility is opt-in. "Shipped" means reachable from a release Git tag; main/GitHub/PR/unreleased code is not shipped.
6666
- Refactor default: one canonical path. Delete the old path unless user explicitly wants compat or the shipped public contract is obvious and cited.
67+
- Core runtime consumes only current canonical shapes/config/data. Legacy or retired shapes normalize only in doctor/migration code before runtime; no runtime shims, aliases, or fallback readers.
6768
- Keep old behavior only for an explicit public API/config/plugin SDK/data contract, tagged upgrade path, security/migration boundary, dependency contract, or observed prod state.
6869
- If unsure, ask before preserving compat. Do not keep aliases, shims, fallback stacks, stale names, or obsolete tests just in case.
6970
- Tests alone do not make internals contracts. If compat stays, name the contract and migration/removal plan in code, test, or PR.

0 commit comments

Comments
 (0)