Skip to content

CLAUDE.md

Latest commit

 

History

History
37 lines (29 loc) · 1.97 KB

CLAUDE.md

File metadata and controls

37 lines (29 loc) · 1.97 KB

Cowrie Project Instructions

Testing Philosophy (VITAL)

../../docs/TESTING_PHILOSOPHY.md is the canonical testing guide for all projects in this workspace. Read it before writing or reviewing tests. Covers 10 bug classes (overflow, resource exhaustion, parity drift, type conversions, C memory safety, parser edge cases, limits bypass), 7 test shapes, 9 quality rules, and false-negative hunting with LSPs/mutation testing.

System Environment

  • RTX 3090 (24GB VRAM). Check nvidia-smi before loading models.
  • Wayland system. Qt apps need QT_QPA_PLATFORM=xcb.
  • No sudo access. Provide copy-paste commands for root operations.

Language Defaults

  • Primary languages: Go (primary), TypeScript (secondary), Markdown (docs).
  • When generating code, default to Go unless told otherwise.

Git Workflow

  • Always run git remote -v and git rev-parse --show-toplevel before committing or pushing.
  • Confirm the correct repo before any git operation.

Skills & Commands

  • Check .claude/skills/ first when a skill name is referenced.
  • If a skill doesn't exist, say so immediately rather than searching the codebase.

Testing

  • 5 language implementations must pass tests before publishing.
  • Cross-language fixtures live in testdata/fixtures/.
  • Go glyph cross-impl tests skip gracefully when glyph-js is not built.
  • TS test runner: node --import tsx --test (NOT jest). Coverage via c8.
  • 7 codec invariants tested across all languages — see cogs/docs/TESTING_STANDARDS.md.
  • NaN/Inf policy: allowed in cowrie binary encoding, rejected in glyph text/JSON bridges.
  • C build: mkdir -p build && cd build && cmake .. && make && ctest --output-on-failure
  • Rust integration tests: cargo test --test coverage_boost (173 tests incl. invariants).

Session Management

  • Break work into focused sessions: one major deliverable per session.
  • Commit at natural breakpoints before context gets tight.
  • Read MEMORY.md at session start for persistent context.