Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Develop Miroir

Layout

PathWhat
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 .