> ## Documentation Index
> Fetch the complete documentation index at: https://agent-compass.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> Understand the ownership, workflow, and completion criteria for an AgentCompass environment integration.

An environment integration exposes one execution provider through the shared `EnvironmentSession` contract. It owns
sandbox creation, command and file primitives, endpoints, resources, enforceable network policy, and cleanup while
remaining independent of benchmark scoring and harness behavior.

## Integration Boundary

Provider SDK calls, container commands, filesystem transfer, lifecycle timeouts, resource translation, and network
enforcement belong in the environment. Dataset parsing belongs in benchmarks; agent installation and execution belong
in harnesses; benchmark/provider image and workspace adaptation belongs in recipes.

## Integration Workflow

1. [Implement the environment contract](/en/developer_guide/environment_integration/code_implementation), including provider
   config, session primitives, lifecycle, resources, network enforcement, and precedence.
2. [Update public documentation](/en/developer_guide/environment_integration/documentation_update) with setup, parameters,
   supported capabilities, examples, and troubleshooting.
3. [Validate the integration](/en/developer_guide/environment_integration/validation_and_alignment) against a real provider,
   including primitive, override, resource, network, cleanup, and concurrency behavior.

## Completion Gate

* The provider implements every required session primitive with consistent semantics.
* Startup failure, cancellation, and normal close leave no owned sandbox resources behind.
* Advertised resources and network modes have enforcement-level evidence.
* Explicit selectors and resource values survive recipe and provider resolution.
* Real single-task and concurrent runs pass for every claimed workflow.
* Public docs match the live config schema and provider API.
