This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
The detailed guidance is split across the files below (imported automatically). Add new guidance to the file whose topic it fits, and create a new docs/claude/<topic>.md + import line here when a genuinely new topic appears.
- @docs/claude/build-and-test.md — driving the Gradle build, running individual tests fast, the stash-the-fix verification discipline.
- @docs/claude/architecture.md — module graph and the
core-into-provtrap, MR-jar overlays,module-info.java/package-info.javaupkeep, where examples live, JCE provider registration, adding a PQC algorithm,.bcvs.jcajcepackage layering. - @docs/claude/conventions.md — test conventions, X.509 / ASN.1 RFC discipline, strict cert parse vs reviewer, DER lenient-read/strict-write, exception-message contract,
SecurityExceptionscause-chaining, property constants, non-standard interop, PKCS#12 SPI pair, CMS streaming I/O, operator close discipline, duplicated OID tables, release notes, commit messages, URL checking, code style.