Develop Miroir
Layout
| Path | What |
|---|---|
src/ | the miroir binary |
python/ | the client, the TRL and verifiers adapters, the host-side CLI |
sandbox/ | the image that runs run_code commands |
fixtures/ | example products and their envs |
examples/ | real products made envs: Gitea |
tests/ | Docker integration tests, and OpenEnv conformance |
tools/ | reset timing and pool soak benchmarks |
docs/ | this book |
skills/ | the Agent Skill for coding agents |
Checks
cargo fmt --check && cargo clippy --all-targets --locked -- -D warnings
cargo test --locked # unit tests
cargo test --locked --test integration -- --ignored # builds the fixture images; needs Docker
(cd python && uv run ruff check . && uv run ty check && uv run pytest -q) # -m integration: Docker
(cd tests/openenv && uv run pytest -q) # OpenEnv conformance, on acme-crm-env
docker buildx bake builds the binary’s image, the sandbox and every fixture env.
The docs
The docs are an mdBook in docs/:
mdbook serve docs # http://localhost:3000, rebuilt on save
mdbook build docs # into docs/book
The skill
skills/miroir restates this book for coding agents, as an
Agent Skill: SKILL.md holds the workflows, and references/ the
fields and the check stages. When a change touches the manifest, the task format, the tools or
check, update the skill too. .claude-plugin/marketplace.json lists it for Claude Code.
uvx --from skills-ref==0.1.1 agentskills validate skills/miroir
claude plugin validate --strict .