shreeve

zig-agent-docs

Reference documents for AI coding agents working on Zig projects. Every claim in them is checked against the real toolchain.

File	What it is
ZIG-0.17.md	Zig 0.17 for agents whose knowledge stops at 0.15: what changed in 0.16 and 0.17, the silent traps, a compile-error decoder, a migration playbook, and copy-ready patterns, all verified against the 0.17.0 compiler.
codebase-revamp.md	A Claude Code skill that leads a subagent-team revamp of a codebase: correct, secure, complete, fast, small and well documented, on a revamp branch. It works from the project's toolchain reference (such as ZIG-0.17.md) rather than the model's memory.

shreeve

CYW43439 PMKSA Research — verified findings

Purpose. This is the pre-Phase-3 research artifact mandated by docs/CYW43-REWRITE.md §5.9.2. It documents the exact iovar, wire-format, chip-compatibility, and reliability-context for PMKSA cache management on the CYW43439 chip as used in Raspberry Pi Pico W.

Status. Produced 2026-04-20 from first-party sources (Linux kernel tree, pico-sdk issue tracker, cyw43-driver upstream). Sign-off for Phase 3 PMKSA coding: ready.

---

TL;DR

shreeve

Zig 0.15.x → 0.16.0 Migration — Quickstart Kit

This file is a turn-key quickstart for pointing an AI (or yourself) at a Zig codebase that needs a 0.15.x → 0.16.0 migration. It's small on purpose. The actual reference material lives in ZIG-0.16.0.md (1,800+ lines of changelog, patterns, decoder tables, and workflow playbook distilled from a real end-to-end port).

---

What this kit is and isn't

It IS: A field-tested migration playbook that took a ~7,300-line Zig 0.15.2 parser generator to 0.16.0 in one session. Tests passed 40/40 afterwards. Performance went up (187s → 1.73s test runtime). It captures both the API changes and the surprises that aren't obvious from release notes alone — most importantly, std.heap.DebugAllocator's up-to-1400× slowdown on allocator-heavy workloads in Debug builds.

shreeve

JavaScript Garden Analysis: How Rip Improves the Situation

JavaScript Garden documents the most notorious quirks and pitfalls of JavaScript. Here's a deep analysis of each section and how Rip eliminates or mitigates these problems.

---

1. Equality (== vs ===) — Eliminated

JavaScript Garden calls == a source of "hard-to-track-down bugs" due to type coercion. Rip solves this at the language level with two mechanisms:

shreeve

Rip Language Reference

Rip is a modern reactive language that compiles to ES2022 JavaScript. It combines CoffeeScript's elegant syntax with built-in reactivity primitives. Zero dependencies, self-hosting, ~13,500 LOC.

---

Table of Contents

shreeve

Configure nginx to handle CORS for us, so we don't even see it

  server {
    server_name _;
    listen      443 ssl http2;
    listen [::]:443 ssl http2;

    root /home/public/www;

shreeve

#!/bin/bash

# =============================================================================
# ssl-certs.sh - Self signing SSL certificates
#
# Author: Steve Shreeve <steve.shreeve@gmail.com>
#   Date: Dec 17, 2022
# =============================================================================

# Use https://gist.github.com/shreeve/3358901a26a21d4ddee0e1342be7749d

shreeve

# =============================================================================
# .gitconfig
#
# Author: Steve Shreeve <steve.shreeve@gmail.com>
#   Date: Dec 15, 2022
# =============================================================================

# curl -Lso ~/.gitconfig http://bit.ly/3FANcK7

[user]

shreeve

# =============================================================================
# .tmux.conf
#
# Author: Steve Shreeve <steve.shreeve@gmail.com>
#   Date: Jan 5, 2023
# =============================================================================

# curl -so ~/.tmux.conf https://gist.githubusercontent.com/shreeve/c751769ea46b34c1c30b97fa2762770b/raw/.tmux.conf
#
# For iTerm2, make sure to check "use Powerline Glyphs" in order to render special chars

shreeve

" vim config

set nocompatible                  " Must come first because it changes other options

" Enable pathogen
execute pathogen#infect()

color benlight                    " Color theme

syntax on                         " Use syntax highlighting