Skip to content

CLAUDE.md

Latest commit

 

History

History
11 lines (8 loc) · 1.87 KB

CLAUDE.md

File metadata and controls

11 lines (8 loc) · 1.87 KB
Raw

CLAUDE.md

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, why a green Gradle run can mean the tests never ran and the tree can move under a long one.
  • @docs/claude/build-jdk14.md — the jdk1.4 (build1-4) legacy build: source preprocessing (what the regexes fix and what they can't), the real-1.4-javac compile floor, overlay delete-vs-sync discipline, the build → bcsign4 → test flow and its signing/staleness traps.
  • @docs/claude/architecture.md — module graph and the core-into-prov trap, MR-jar overlays, module-info.java / package-info.java upkeep, where examples live, JCE provider registration, adding a PQC algorithm, .bc vs .jcajce package 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, SecurityExceptions cause-chaining, property constants, non-standard interop, PKCS#12 SPI pair, CMS streaming I/O, CMS recipient constraints, operator close discipline, duplicated OID tables, receiver-side AlgorithmIdentifier comparison, the name-finder/test count lock, checking whether the type already solves it, release notes, crediting reporters in CONTRIBUTORS.html, commit messages, URL checking, code style.
  • @docs/claude/upstream-lts-ports.md — the UPSTREAM-*.md porting workflow: verifying the doc against this tree, diffing against the BC-LTS checkout, tests/release-note trimmings, keeping the .md out of the commit.