From 4f8349cb6b4dfa391b6f7f735fb2a45bacdd36db Mon Sep 17 00:00:00 2001 From: Toddr Bot Date: Fri, 3 Apr 2026 21:02:34 +0000 Subject: [PATCH] docs: document generated files and release conventions in CLAUDE.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit MANIFEST is generated by make manifest, README.md by pod2markdown. Neither should be edited by hand. Releases (changelog, version bumps) are human-only — automated fixes must not touch them. Co-Authored-By: Claude Opus 4.6 --- CLAUDE.md | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/CLAUDE.md b/CLAUDE.md index b733a25..26c0715 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -80,6 +80,21 @@ typedef struct { Tests use dynamic plans (hash algorithm availability varies by OpenSSL build). `t/fakelib/` provides a mock `Crypt::OpenSSL::Bignum` for testing without the real module. +## Generated Files — Do Not Edit + +These files are generated and must not be manually edited or committed: + +- **`MANIFEST`** — Generated by `make manifest`. Do not sort or modify by hand. +- **`README.md`** — Generated from POD via `pod2markdown RSA.pm > README.md`. Edit the POD in `RSA.pm` instead. + +## Release Process — Human Only + +Releases are performed by the maintainer. Automated fixes must **never**: + +- Update `Changes` / changelog entries +- Bump the version number in `RSA.pm` or elsewhere +- Modify release metadata (META.json, META.yml) + ## Conventions & Gotchas ### Memory Management