kc3-lang/kc3/CLAUDE.md

Branch - branch -masterpdfpdf-rebasedtlstls-rebasedcallablecallable-rebaseconfigurefastfast2fnfractionsfractions-rebaseframeherunstoofastforushttpdjeremy_rebasedlinuxmarshallmarshall_before_mergemarshall_rebasepointerratio-rebasev0.1- tag -v0.1.9v0.1.8v0.1.7v0.1.6v0.1.5v0.1.4v0.1.3v0.1.2v0.1.15v0.1.14v0.1.13v0.1.12v0.1.11v0.1.10v0.1.1v0.1.0v0HTTPd-v0.2.0HTTPd-v0.1.1HTTPd-v0.1.0

• Show log

  Commit

• Hash : 75e51c12
  Author : Thomas de Grivel
  Date : 2025-08-03T13:38:45
  

  simplify CLAUDE.md
  

Download

---

Source

• CLAUDE.md

• # Claude Assistant Notes for KC3 Project
  
  ## Search Tool Limitations
  - Always test Grep with a simple pattern first since rg might break at any moment
  - Use BSD-style conventions: options come before arguments (e.g., `Grep -n -A 5 pattern path`)
  - Workaround: Use Read tool with specific line numbers when given locations
  - Use Task tool for broader searches when Grep fails
  - Always verify search results by asking for confirmation
  
  ## C String Semantics Issues
  - Do not confidently interpret C string literal byte counts or memory layouts
  - Ask for verification: "This is X bytes total, right?" instead of assuming
  - Be tentative about endianness and binary data interpretations
  - Let the user be the authoritative source on technical details
  
  ## General Debugging Approach
  Be direct and concise. Don't flip-flop or over-explain.
  
  ## KC3 Project Specifics
  - Marshall/unmarshall system: Fixed string handling and header reading issues
  - Tests: `make test_debug` runs all tests, `KC3_TEST=name make test_libkc3_debug` for specific tests
  - On OpenBSD: Stack variables are zero-initialized
  - Buffer overflow protection added to marshall_read_header with size validation
  
  ## Formatting Guidelines
  - 72 columns per line max

Download