Gemini — Gotenberg

Read AGENTS.md first. It contains the core principles, project layout, and links to specialized personas you must load depending on the task.

Quick Reference

Format before committing: make fmt (Go) and make prettify (non-Go)
Lint before committing: make lint && make lint-prettier
Commits must follow Conventional Commits (e.g., feat(chromium): add screenshot endpoint)
Run unit tests: make test-unit
Run integration tests: make build && make test-integration TAGS=<relevant-tag>
Never run go commands directly — use the Makefile.

When exploring the codebase, start with pkg/gotenberg/ for core interfaces and pkg/modules/ for feature implementations.
The integration test infrastructure in test/integration/scenario/ is well-structured — read scenario.go and containers.go to understand the Gherkin step definitions before writing new tests.
Mocks for all major interfaces are in pkg/gotenberg/mocks.go — use them for unit tests rather than creating new ones.
Import ordering is enforced: standard library, third-party, then github.com/gotenberg/gotenberg/v8 — separated by blank lines.
When making changes, run only the relevant integration test tag rather than the full suite (40min timeout).
This project values stability over velocity. When in doubt about whether a change is breaking, flag it rather than assuming it's safe.