Integration Cookbook

Jump to bottom

David Ahmann edited this page Feb 10, 2026 · 1 revision

Integration Cookbook

Use one boundary pattern only: wrapper or sidecar. Execute tools only on allow.

Universal Recipe

Normalize framework payload to IntentRequest.
Run gait gate eval --policy ... --intent ... --json.
Execute side effects only if verdict is allow.
Persist trace and artifact paths under gait-out/.

Framework Recipes

OpenAI Agents: examples/integrations/openai_agents/
LangChain: examples/integrations/langchain/
AutoGen: examples/integrations/autogen/
OpenClaw: examples/integrations/openclaw/
AutoGPT: examples/integrations/autogpt/

Required Validation

make test-adapter-parity
make test-adoption

Skills and Provenance

Include skill_provenance in intents for skill-driven actions.
Validate trust and signatures with:

make test-skill-supply-chain

Canonical Contract Docs

docs/contracts/primitive_contract.md
docs/contracts/skill_provenance.md
docs/integration_checklist.md