project-orientation

Routes developers to the correct sibling skill for a Z80 assembly Arkanoid codebase.

Updated Nov 29, 2024
One-click install
npx skills add https://github.com/SpeedRD/Arkanoid_Z80 --skill project-orientation-speedrd
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: project-orientation
Source: https://github.com/SpeedRD/Arkanoid_Z80/tree/main/.claude/skills/project-orientation
Command: npx skills add https://github.com/SpeedRD/Arkanoid_Z80 --skill project-orientation-speedrd

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When starting work on this ZX Spectrum 48K Arkanoid clone written in Z80 assembly, it is hard to know what already works, what is deliberately out of scope, which file owns which behavior, and which sibling skill applies to a given task. This Skill acts as the index: it summarizes the current project state and routes you to the right in-depth skill instead of explaining everything itself. ## Core Features & Use Cases - Current-state summary: Documents what works (collisions, lives, level completion), what is deliberately absent (score, HUD, sound, interrupts), and which historical defects are fixed. - File map and routing table: Maps each of the 11 .asm files to its role and status, and routes tasks (editing levels, changing ball speed, touching collisions, building) to the correct sibling skill. - Governing facts and anti-assumptions: States the three architectural invariants (attribute-file playfield, global IX map pointer, busy-wait timing) and lists stale AUDIT.md claims that must not be trusted. - Use Case: You open the repo for the first time and want to add a fifth level. This Skill tells you the map format constraints and directs you to the map-data-format skill before you touch Mapas.asm. ## Quick Start Ask the assistant to orient you on this Arkanoid Z80 repository and tell you which skill applies to the change you want to make.

Frequently Asked Questions about project-orientation

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I start working on this Z80 assembly Arkanoid project?

Start with the project-orientation skill, which summarizes the current state of the codebase and routes you to the right sibling skill. For example, editing levels routes to map-data-format, while touching collisions routes to collision-and-physics.

What assembler and toolchain does this ZX Spectrum project use?

The project builds with sjasmplus via ./build.sh, producing a raw binary loaded at $8000. It runs under ZEsarUX with DeZog over zrcp, and tests run through a Python harness with python3 tests/run_all.py.

Can I add a score display or HUD to this Arkanoid clone?

No. Score and an on-screen HUD are explicitly out of scope for this project, along with sound, interrupts, multi-hit bricks, and power-ups. The brick counter must not be designed as if a HUD will read it.

Why should I not trust AUDIT.md line numbers and addresses?

AUDIT.md describes the pre-fix codebase and is now substantially historical. Every address moved when colisiones.asm grew, so symbols must be resolved from the generated main.lst file after building, never from AUDIT.md.

Can the busy-wait frame loop be replaced with interrupts?

No. The busy-wait architecture is deliberate: di is set at startup with no ei, IM, halt, or ISR anywhere. The interrupt-driven rendering rewrite is explicitly deferred and out of scope.