Skip to content

CLAUDE.md

Latest commit

 

History

History
41 lines (31 loc) · 2.69 KB

CLAUDE.md

File metadata and controls

41 lines (31 loc) · 2.69 KB
Raw

QuakeSpasm old-Mac port

QuakeSpasm as ONE fat binary across PowerPC, Intel and Apple Silicon Macs, from a single Quakespasm.app, 10.3.9 Panther through modern macOS.

Goal: Best-looking QuakeSpasm on G3 Panther/Tiger, G4 Tiger, G5 Leopard and Lion Intel, staying playable on each: ≥ 20 fps on the G3, ≥ 25 fps on the G4s, G5 and Lion, uncapped on modern hardware. Above the floor, effects beat fps; win frame rate by optimising code, not by dropping features.

Commands Reference

  • scripts/build-fat.sh - THE build: 6 slices, lipo'd, on a claimed Intel mini
  • scripts/build.sh <target> - One slice; sub-step, or to diagnose a compile error
  • scripts/deploy.sh <machine> - Stage Quakespasm.app + ship; always the fat binary
  • scripts/bench.sh <machine> <demo> <WxH> - One 3-run cell into benchmarks/results.csv
  • Full script list in scripts/README.md. Per-script contracts in scripts/CLAUDE.md.

Context Routing

This is a lightweight router. For specific scenarios, consult the following isolated rule files:

  • .claude/rules/legacy-mac-hardware.md: Read when making code changes, dealing with build outputs, hardware specifics, or benching. Contains hard rules, codebase facts, and operational gotchas for old-Mac hardware.
  • .claude/rules/ticketing-workflow.md: Read when handling issues, PRs, or working alongside other repositories in the agentic ecosystem. Contains project management and hardware locking rules.

Read on Demand

  • docs/adr/ - Architecture Decision Records (ADRs). Use these to store specific types of project information and decisions. Index in docs/adr/README.md.
  • MISTAKES.md - Recorded negative results. Read before trying "easy" ideas.
  • docs/KNOBS.md - Toggleable cvars and -flag settings.
  • docs/DEVELOPMENT.md - Build path, build-host tenancy, hot files.
  • MacOSX/CLAUDE.md - Toolchain paths and per-target flags on the build host.
  • docs/README.md - Index of features, research, archive.

Continuous Integration

  • .github/workflows/build-mac.yml (arm64 via Makefile.darwin) and build-linux.yml (clang+gcc via Makefile) are this repo's own CI: do the current sources still compile on a stock toolchain, on every push and PR. Fat-binary fusing, PowerPC, and fleet deploy/smoke are a different concern, owned by old-mac-build-host's Jenkins jobs (manually/API-triggered, not push-triggered) — that is deploy-time verification, not commit-level CI, and does not substitute for the workflow files. Public-repo rule: keep these green on master (2026-08-28, after a Gemini-authored commit deleted both files on the unverified claim that build-host covered CI — it does not; restored in the commit that added this line).