# schema  

**Scope:** OpenAPI schema contract.  
**Audience:** API users and contributors.  
**Guarantees:** Schema file is authoritative.  
**Non-Goals:** Client SDK generation.  
Why: This doc exists to record its single responsibility for review.  

## Overview  
This doc defines one responsibility.  
Architecture components are defined in [../architecture/architecture.md](../architecture/architecture.md).  
Read [overview.md](overview.md) before edits.  
Read [../../meta/DOCS_STYLE.md](../meta/DOCS_STYLE.md) for context.  

## Contracts  
Each statement is a contract.  
Contracts align with [api/v1/schema.yaml](https://github.com/bijux/agentic-proteins/blob/main/api/v1/schema.yaml).  
Contracts link to [overview.md](overview.md) and [../../meta/DOCS_STYLE.md](../meta/DOCS_STYLE.md).  

## Invariants  
Invariants describe stable behavior.  
Checks align with [api/v1/schema.yaml](https://github.com/bijux/agentic-proteins/blob/main/api/v1/schema.yaml).  
Invariants align with [overview.md](overview.md).  

## Failure Modes  
Failures are explicit and tested.  
Failure coverage aligns with [api/v1/schema.yaml](https://github.com/bijux/agentic-proteins/blob/main/api/v1/schema.yaml).  
Failures align with [../../meta/DOCS_STYLE.md](../meta/DOCS_STYLE.md).  

## Extension Points  
Extensions require tests and docs.  
Extensions are tracked in [overview.md](overview.md).  
Extensions align with [api/v1/schema.yaml](https://github.com/bijux/agentic-proteins/blob/main/api/v1/schema.yaml).  

## Exit Criteria  
This doc becomes obsolete when the surface ends.  
The replacement is linked in [../../meta/DOCS_STYLE.md](../meta/DOCS_STYLE.md).  
Obsolete docs are removed.  

Code refs: [api/v1/schema.yaml](https://github.com/bijux/agentic-proteins/blob/main/api/v1/schema.yaml).  
