interface-contract-designerlisted

# Interface Contract Designer ## Purpose Focused expert for interface and contract design: endpoint/RPC/CLI surface shape, request/response schema, versioning strategy, error/status contracts, pagination, idempotency, and backward compatibility. Prevents an interface change from shipping with an unconsidered breaking-change risk or an inconsistent contract shape. This is a power skill, not a lifecycle phase. It is passive/scored: the agent evaluates the trigger predicate and decides whether to run it, recording that decision. ## Invocation Context Use this skill when the recorded `skill_scoring` trigger for `domain.interface-contract-designer` evaluates true: `path~contract_globs OR touches_contract` — i.e. the diff touches a file matching a contract glob (OpenAPI/proto/route/handler/CLI-arg spec) or `repo-profile.yaml`'s `paths.public_contracts` is affected. Do not invoke it for changes with no contract-shaped surface (e.g., internal-only refactors that touch no request/response boundary). ## What To Load **Foundation** (confirm in context; load if not already present): - Root `AGENTS.md` - `workflow/router.md` - `workflow/lifecycle.md` - `workflow/rules.md` **Minimum for invocation**: - This file - `references/output-schema.md` **Before starting work**: - The route file matching the touched contract's shape (`references/{rest,graphql,grpc,websocket,cli,sdk-library}.md`) — selected from the diff's file signals, not chosen arbitrarily - `workflow/config/repo-profile