# Zireael Build Test CI

> Maintain portable CMake builds and deterministic unit/golden/fuzz/integration tests. Use when this capability is needed.

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

---


## When to use

Use this skill when working on:

- `CMakeLists.txt` or `CMakePresets.json`
- CI configuration (GitHub Actions)
- warnings/sanitizers/toolchain setup
- adding tests (unit/golden/fuzz/integration)

## Source of truth

- `docs/BUILD_TOOLCHAINS_AND_CMAKE.md` — build spec
- `docs/modules/TESTING_GOLDENS_FUZZ_INTEGRATION.md` — test strategy
- `docs/GOLDEN_FIXTURE_FORMAT.md` — fixture format

## Toolchains

- macOS: Apple Clang
- Linux: Clang + GCC in CI
- Windows: clang-cl primary

## CMake guidance

- Always produce static library (required)
- Shared library optional/configurable
- Tests runnable via CTest
- CI builds with warnings-as-errors

## Test strategy

| Type        | Purpose                          | Location             |
|-------------|----------------------------------|----------------------|
| Unit        | Pure logic, deterministic        | `tests/unit/`        |
| Golden      | Byte-for-byte output             | `tests/golden/`      |
| Fuzz        | No crash/hang on arbitrary input | `tests/fuzz/`        |
| Integration | PTY/ConPTY real terminals        | `tests/integration/` |

## Fuzz budgets

- PR CI smoke: **5 seconds per target**
- Nightly: **60 seconds per target** with sanitizers

## Sanitizers

- Linux/macOS (Clang): ASan + UBSan in CI
- Windows: clang-cl sanitizers if feasible

## Running tests

```bash
cmake --preset posix-clang-debug
cmake --build --preset posix-clang-debug
ctest --test-dir out/build/posix-clang-debug --output-on-failure
```

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