Add comprehensive CLAUDE.md documentation

[sudo-owen]

Summary

This PR adds a comprehensive CLAUDE.md documentation file that serves as a complete guide to the C.H.O.M.P. (Credibly Hackable On-chain Monster PvP) project. This document is designed to help developers, AI assistants, and contributors quickly understand the codebase structure, architecture, and development workflows.

Key Changes

• Project Overview: High-level description of C.H.O.M.P. as an on-chain turn-based PvP battling game with extensible battle engine
• Quick Start Guide: Essential commands for building, testing, and running the project
• Repository Structure: Complete directory tree with descriptions of all major components (Engine, effects, mons, moves, commit managers, etc.)
• Architecture Documentation:
  • Core battle flow (matchmaking → battle start → turn loop → resolution)
  • Key interfaces and their purposes (IEngine, IMoveSet, IEffect, IAbility, etc.)
  • Move system design with ATTACK_PARAMS structure
  • Effect system with lifecycle hooks
  • Type system (16 types with effectiveness calculation)
  • Storage architecture patterns (BattleData, MonState, bit-packing, transient storage)
• Development Conventions:
  • Solidity style guidelines (AGPL-3.0, pragma, imports, constants, move indices)
  • Testing patterns and BattleHelper utilities
  • Procedures for adding new mons, moves, and effects
• Build & Deploy Pipeline:
  • Python processing scripts for validation and code generation
  • Solidity-to-TypeScript transpiler overview
  • Deployment order and CI/CD information
• Data Files Reference: CSV file formats for mons, moves, abilities, and types
• Known Issues & Gotchas: Common pitfalls and edge cases (move forcing switches, effect loops, RNG correlation, etc.)
• Gas Optimization Notes: Key strategies used throughout the codebase

Notable Details

• Comprehensive mapping of all 11 mons (Aurox, Ekineki, Embursa, etc.) and their move directories
• Detailed explanation of commit-reveal scheme for simultaneous moves
• Clear documentation of storage patterns and gas optimization techniques
• Practical examples for extending the system (new moves, effects, mons)
• References to key constants and sentinel values used throughout the codebase

https://claude.ai/code/session_01236TfqgStSXbE3fcp5VAWH

[netlify]

✅ Deploy Preview for monchain-wiki canceled.

Name	Link
🔨 Latest commit	b6cd586
🔍 Latest deploy log	https://app.netlify.com/projects/monchain-wiki/deploys/699d2355705e5f0008f07c02