# Isis Architecture Decision Records (ADRs)

This directory tracks Isis-specific architecture decisions required to close
remediation gaps.

## ADR Index

| Number                                                                     | Title                                                                         | Status   | Date       |
| -------------------------------------------------------------------------- | ----------------------------------------------------------------------------- | -------- | ---------- |
| [ADR-0001](ADR-0001-queueing-model-and-job-envelope-contract.md)           | Queueing Model and Job Envelope Contract                                      | Accepted | 2026-02-21 |
| [ADR-0002](ADR-0002-workflow-schema-canonicalization-and-compatibility.md) | Workflow Schema Canonicalization and Compatibility Policy                     | Accepted | 2026-02-21 |
| [ADR-0003](ADR-0003-runpod-serverless-execution-strategy.md)               | RunPod Serverless Execution Strategy and Governance                           | Accepted | 2026-02-21 |
| [ADR-0004](ADR-0004-runpod-endpoint-provisioning-mechanism.md)             | RunPod Endpoint Provisioning Mechanism                                        | Accepted | 2026-02-22 |
| [ADR-0005](ADR-0005-api-contract-parity-and-sdk-deprecation-policy.md)     | API Contract Parity and SDK Deprecation Policy                                | Accepted | 2026-02-22 |
| [ADR-0006](ADR-0006-canonical-human-video-contracts.md)                    | Canonical Human-Video Contracts (Phase 182)                                   | Accepted | 2026-09-09 |
| [ADR-0008](ADR-0008-open-3d-studio-capability-ownership.md)                | Open 3D Studio Capability Ownership, Registries and Provider Boundary         | Proposed | 2026-09-14 |
| [ADR-0009](ADR-0009-meshy-agent-channels.md)                               | Meshy Agent Channels — MCP Server, CLI, Skill Pack, Blender and Unity Plugins | Accepted | 2026-09-15 |
| [ADR-0010](ADR-0010-model-library-and-cache-volume.md)                     | Hetzner Model Library with a Fixed Least-Recently-Used Cache Volume on RunPod | Accepted | 2026-09-13 |

## Scope

These ADRs are the normative baseline for:

- queueing and execution orchestration
- workflow schema canonicalization and versioning
- RunPod pay-per-second serverless strategy and controls
- RunPod endpoint lifecycle provisioning control plane
- API contract parity and SDK deprecation governance
- canonical human-video request, capability, job-state, measurement, and
  release-proof contracts
- where model weights live, how the RunPod cache is sized, and what leaves it

## Related Program Artifacts

- `ISIS_TODOS.md`
- `docs/domains/isis/remediation/ISIS_REMEDIATION_EPIC.md`
- `docs/domains/isis/remediation/ISIS_REMEDIATION_BACKLOG.md`
- `docs/domains/isis/remediation/ISIS_FINDING_OWNERSHIP.md`
- `docs/domains/isis/remediation/ISIS_RISK_BOARD.md`
