Charles Wiltgen cf1ebc772c fix(axiom-data): verify the suite against the 27.2 SDK and fix what the toolchain disproves
Every claim in axiom-data checked against the iOS 27.2 SDK, Swift 6.4, and the
pinned third-party versions (sqlite-data 1.12.0, StructuredQueries 0.39.2,
swift-sharing 2.10.1, GRDB 7.11.1, realm-swift 20.0.5). Every code block was
compiled individually and the behavioural ones were run — on simulators, against
real stores, and through the system sqlite3 whose version and compile options
match the platform's.

The suite's guidance was wrong in ways that cost data rather than time:

- A chunked importer ended with an unscoped `delete(model:where:)` over an
  always-true predicate. It did not compile, and adding the missing `try` would
  have made it delete the entire store — 2,000 imported rows plus a pre-existing
  unrelated row, measured. The compile error was the only protection.
- The migration file denied that SQLite can add a foreign key to an existing
  table, forbade the table rebuild that is the documented route, and recommended
  a PRAGMA that is inert inside a transaction — which the same file mandated.
  Following it left orphan rows that `PRAGMA foreign_key_check` cannot detect,
  the state the suite's own auditor rates CRITICAL.
- The storage reference gated must-save data on
  `volumeAvailableCapacityForImportantUsage` and refused to write; Apple's own
  documentation for that key says to attempt the write regardless.
- The tvOS storage claim denied that the directories exist and that local data
  survives. A simulator probe showed a local-only store keeping every row across
  relaunch and reboot; nine files carried the absolute and five cited the
  corrected file as their authority while contradicting it.

Also corrected: APIs that exist in no version of their framework
(`@Attribute(.indexed)`, `addColumn(ifNotExists:)`, `migrator.hasBeenMigrated`,
statement `.fetch(_:)`, `.filter`, `TableAlias` as a protocol,
`ResultsSectionCollection`); quoted diagnostics the compiler never emits; an
`@Model` initializer rule the suite documented in one file and violated in
eleven; a `perform` removal that introduced a data race; and the expired
Realm Device Sync migration premise, written in the future tense after its
2025-09-30 shutdown.

Auditor procedures were corrected at their sources in `agents/`, since a dead
detection pattern reports clean — `@Model struct` cannot compile, so the pattern
that advertised it could never fire.

Verified: pre-deploy --static clean; 1,004 sub-skill pointers resolve across 344
emitted Codex files; Cursor output matches a deterministic full render.
2026-09-16 16:44:17 -07:00
2025-11-30 10:02:02 -08:00
2026-09-14 13:34:21 -07:00
2026-09-14 10:40:12 -07:00

Axiom

Battle-tested skills, agents, and tools for modern Apple OS development — Swift 6, SwiftUI, Liquid Glass, Apple Intelligence, and more. Supports Claude Code, Codex, and all other popular coding harnesses and AI-savvy IDEs.

What is Axiom?

Axiom gives AI coding assistants deep Apple OS development expertise — the kind that prevents data loss from bad migrations, catches memory leaks before users complain, and stops you from spending 30 minutes debugging a zombie xcodebuild process.

  • 276 skills covering UI, data, concurrency, performance, networking, accessibility, and more
  • 42 agents that autonomously scan for issues (memory leaks, concurrency violations, build problems)
  • 17 commands for quick audits and diagnostics
  • xclog — a built-in console capture tool that gives AI assistants access to simulator and device logs
  • xcsym — a built-in crash symbolication tool for .ips, MetricKit, and Apple's legacy .crash text crashes, with automatic dSYM discovery and pattern categorization
  • xcui — a built-in tool to drive and validate the simulator UI and accessibility (tap by accessibility ID, dump the accessibility tree, check VoiceOver and Dynamic Type)
  • xcprof — a built-in tool to record and analyze CPU/performance traces (xctrace) without opening Instruments

Every discipline skill is TDD-tested against real developer pressure scenarios. Learn more about quality.

OS 27 in progress. Axiom is on a 27.x beta that tracks Apple's OS 27 developer betas — OS-27 coverage lands continuously through the beta season. Guidance for OS 26 and earlier stays stable.

Installation

Claude Code (native plugin)

/plugin marketplace add CharlesWiltgen/Axiom

Then search for "axiom" in the /plugin menu and install.

Cursor (native plugin)

Axiom's generated Cursor plugin includes 27 skill routers, 42 agents, 17 /axiom-* commands, advisory hooks, and automatic discovery of its MCP server configuration. See the Cursor install and support guide for the macOS support boundary and local installation steps.

MCP (VS Code, Cursor MCP-only, Gemini CLI, and more)

See the MCP setup guide.

Pi (terminal coding agent)

pi install git:github.com/CharlesWiltgen/Axiom

One command installs the skills plus the /axiom-* commands and hooks. See the Pi setup guide.

Xcode (Claude Agent / Codex)

See the Xcode integration guide.

Getting Started

Skills activate automatically based on your questions. Just ask:

"I'm getting BUILD FAILED in Xcode"
"How do I fix Swift 6 concurrency errors?"
"My app has memory leaks"
"I need to add a database column safely"
"Show me what my app is logging"
"Symbolicate this crash file"

You can also use commands directly:

/axiom:console          # Capture simulator console output
/axiom:analyze-crash    # Parse and triage .ips, MetricKit, or .crash reports
/axiom:fix-build        # Diagnose build failures
/axiom:audit memory     # Scan for memory leaks
/axiom:audit concurrency # Check for data races
/axiom:health-check     # Run all relevant auditors

Documentation

Full documentation, skill catalog, and guides at charleswiltgen.github.io/Axiom.

Community

S
Description
Use when implementing ANY computer vision feature — image analysis, pose detection, person segmentation, subject lifting, text recognition, barcode scanning.
Readme 312 MiB
Languages
Go 35%
TypeScript 33.9%
Python 17.5%
JavaScript 12.4%
Shell 0.9%
Other 0.3%