# Commodore 64 / 6510 AI Agent Pack

This pack turns the uploaded Commodore 64 reference texts into a practical AI-coding-agent workspace. It is designed for agents helping with C64 BASIC V2, 6510 assembly, KERNAL jump-table calls, memory-map work, VIC-II graphics, SID sound, CIA I/O, interrupts, and debugging.

## Layout

```text
AGENTS.md                         Root agent operating instructions
.ai/SKILLS.md                     Skill router and index
.ai/skills/*/SKILL.md             Focused C64 skills loaded on demand
references/c64-quick-reference.md Memory, KERNAL, BASIC, and hardware tables
examples/basic/*                  BASIC examples
examples/assembly/*               6510 assembly examples
templates/c64-task-brief.md       Prompt template for future C64 tasks
tools/address-cheatsheet.json     Machine-readable address table
```

## How to use

Place this folder in the root of a Commodore 64 project. An AI coding agent should read `AGENTS.md` first, then follow `.ai/SKILLS.md` to load only the skill files relevant to the task.

The material is summarized and transformed into working rules, not a copy of the source books. Verify timing-sensitive raster, IRQ, banking, and device behavior on an emulator or real C64.