# Shared Integration Docs

Status: Canonical landing page

Shared adapter concepts that apply across OpenClaw, PydanticAI, SpringAI/HTTP, and LangChain.

## Start here
- `concepts.md`
- `contracts.md`
- `troubleshooting-common.md`
- `validation-common.md`

## Canonical source references
- `../../public_surface.md`
- `../../canonical_paths.md`
- `../../integration_contract.md`
- `../../contracts/http_api.v1.json`
- `../../core_adapters_architecture.md`

## What this folder is for
- common write-path contract language
- common runtime retrieval semantics
- common hydration terminology
- common status/limitations framing

## What this folder is not for
- adapter-specific setup details (kept in each adapter folder)
- historical migration playbooks (kept under `docs/archive/`)
