Add CLAUDE.md with project conventions and gotchas#31
Draft
Add CLAUDE.md with project conventions and gotchas#31
Conversation
Captures dual-life module dynamics, build/test workflow, the critical files.t hardcoded-hash gotcha, XS code patterns (endianness, 64-bit counters, allocation macros), and PR workflow for the fork structure. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Add CLAUDE.md to MANIFEST.SKIP so make manifest won't include it in the distribution tarball. It's a development aid, not user-facing. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Docker Hub has removed perl:5.8 through perl:5.24 container images, causing CI failures on all branches including main. Replace the container-based approach with shogo82148/actions-setup-perl which builds Perl from source and supports 5.8+. Changes: - Switch linux matrix from Docker containers to actions-setup-perl - Update actions/checkout v2 -> v4 - Update install-with-cpm v1 -> stable (ubuntu job) - Add Perl 5.34, 5.36, 5.38, 5.40 to test matrix - Drop Perl 5.8 (22 years old, minimal practical value) - Add Windows CI job (Strawberry Perl via actions-setup-perl) - Add macOS CI job (system perl, no container) - Limit AUTHOR_TESTING/RELEASE_TESTING to ubuntu job only Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
Adds a CLAUDE.md capturing essential project knowledge for AI-assisted development.
Why
Digest-MD5 has several non-obvious gotchas that bite every new contributor (human or AI):
the hardcoded checksums in files.t, the dual-life/fork PR workflow, XS endianness
patterns, and the 64-bit counter subtleties. This document eliminates repeated
rediscovery across sessions.
How
Single markdown file covering: project identity, build workflow, critical gotchas
(especially files.t hashes), XS code patterns, test conventions, and PR workflow.
Testing
make testpasses — CLAUDE.md is a development aid, not a distributed file.Generated with Claude Code