# Lxa Workflow

> Roadmap-driven development process, version management, and build system instructions. Use when this capability is needed.

- Skill: `tomevault-io/lxa-workflow` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/lxa-workflow`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/lxa-workflow/raw
- Safety review: pending (external: skill-scanner PASS, skillspector CAUTION)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Product & Planning
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/lxa-workflow

---


# lxa Workflow Skill

This skill guides you through the project management, versioning, and build processes.

## 1. Roadmap Driven Development
**Source of Truth**: `roadmap.md`

### Workflow
1. **Start**: Consult `roadmap.md`. Identify Phase/Task.
2. **Develop**:
   - Write tests first (TDD).
   - Implement minimum code.
   - Ensure no warnings.
   - **Always** strive towards completing the phase you're working on. Create elaborate TODO lists to achieve that, do **not** stop early.
3. **Finish**:
   - Validate (Tests + Coverage).
   - Update `roadmap.md` (`[x]`), compact/summarize done tasks, keep it clean and focused on the future.
   - If you intentionally defer unfinished work, rewrite the roadmap entry so the deferral is explicit and the phase status remains unambiguous.
   - Remove or rewrite roadmap items that would incorrectly re-implement third-party libraries; document that those libraries must be loaded from disk instead.
   - Update `README.md`.
   - Update Version Number.

### "Done" Definition
1. Functionality works.
2. 100% Test Coverage.
3. No warnings.
4. All tests pass.
5. Documentation updated.

## 2. Version Management
**File**: `src/include/lxa_version.h`

**Rules**:
- **MAJOR**: Breaking changes (Reset MINOR/PATCH).
- **MINOR**: New features (Reset PATCH).
- **PATCH**: Bug fixes, refactoring.
- **MUST** increment for every functional commit.
- Keep `LXA_VERSION_STRING` in sync.

## 3. Build System
**Tool**: CMake

### Commands
- **Full Build**: `./build.sh`
- **Install**: `make -C build install`
- **Run Tests**: `ctest --test-dir build --output-on-failure --timeout 60 -j16`

### Artifacts
- Host: `build/host/bin/lxa`
- ROM: `build/target/rom/lxa.rom`
- Commands: `build/target/sys/C/`

### Toolchains
- Host: `gcc`
- Amiga: `m68k-amigaos-gcc` (libnix)

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/gooofy) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-13 -->