CLAUDE - cressie176/Load64 GitHub Wiki

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

About This Repository

This is a GitHub Wiki for LoadC64, a C64 game launcher and emulator frontend. The repository contains only Markdown documentation — no code, no build system, no tests.

Repository Structure

  • Architecture.md — Full 4-layer architecture with control flow diagrams
  • User-Experience.md — UX principles, notation conventions, inherited items handling
  • Glossary.md — Canonical terminology definitions; use these terms consistently
  • Screens.md — Index of all screens organised by category
  • domain/ — Data model documentation for all entities (games, controllers, ROMs, profiles, etc.)
  • domain/Data-Model.md — Canonical data model with all entity definitions (59 KB)
  • screens/ — UI screen specifications organised by feature area (40+ screens)
  • screens/Screen-Documentation-Style-Guide.md — Template and conventions for screen docs
  • diagrams/ — Data model and screen flow diagrams (monojson format)
  • vice/ — VICE emulator integration reference (VJM format, TCP monitor, keyboard mappings)
  • TODO.md — Outstanding documentation tasks

Documentation Standards

Standards are enforced by rules in .claude/rules/. Key points:

Markdown (.claude/rules/github-markdown.md)

  • Headings start at ## — the wiki engine renders the filename as #
  • Tables: align | characters vertically; left-pad cells with one space; separator rows use - only
  • Code blocks: always fenced with a language identifier
  • Lists: use - markers only
  • No hard-wrapped prose; no horizontal rules; no trailing whitespace
  • GitHub Wiki ignores sub-folders — link to screens/some-screen.md as [Some screen](some-screen)