ultracodex 0.3.0

The authoring release. v0.2.0 made workflows good to run; v0.3.0 makes them easy to write — by you, by Claude, or by any model you point at one document. npm install -g ultracodex

The authoring skill

• skills/agent-script-authoring/SKILL.md — one self-contained document (~4.7k tokens: the core contract up front, a craft reference behind) that teaches any capable model to author Agent Scripts.
• Evidence, not vibes. Given only this file plus a problem statement: GPT-5.5 authored scripts judged comparable-or-stronger than Claude-written references on 7/7 problems, first try. A 31B open-weights model (gemma-4-31b) went from 0/7 to 6/7 after one evidence-driven strengthening round (with real run-to-run variance — treat small-model output as usable-with-review). A reasoning model (deepseek-reasoner) served as a fuzzing adversary and surfaced 11 novel failure modes — every one hardened into the skill text and re-verified. Three rounds, three model families, every miss traced to a text fix rather than blamed on the model.

The example gallery

• examples/ — nine orchestration shapes distilled from a census of 58 real production workflows, ordered as a complexity ladder: the first three rungs run in minutes with no setup; the rest are reference implementations for real work.
• Every entry ships a self-contained problem statement (they double as authoring exercises), a mermaid diagram verified against the script's actual topology, and a reference workflow.js that passes validate --strict — portable across Claude Code's Workflow tool and ultracodex by construction.

Install the skills anywhere

• ultracodex sync-skills now installs both static skills — the run contract and the authoring skill — plus one relay skill per saved workflow. opencode picks them up too (it reads Claude-compatible skill paths).
• The repo doubles as a plugin, with progressive disclosure (~250 always-on tokens; full text loads on invoke):

  claude plugin marketplace add YuanpingSong/ultracodex
  claude plugin install ultracodex@ultracodex
  

  and the Codex CLI consumes the same marketplace natively: codex plugin add ultracodex@ultracodex.
• The full four-surface matrix (Claude Code, codex, opencode, raw prompt): docs/skills.md.

Docs

• README rebuilt around time-to-first-run: install → doctor → sync-skills → one prompt, above the fold, with the HD demo video inline.
• Zero config is now stated as such — the config examples were always the shipped defaults; the docs finally say so.
• docs/ split into user docs (skills · operations · architecture · agent-script-spec) and docs/internal/ (working papers, ADRs, research — public for transparency, written for ourselves). The spec was re-verified clause-by-clause against a live Workflow-tool snapshot (2026-07-06).

Built by fleets: the 58-script census, the gallery generalization (with privacy and fidelity gates), the 21-judgment parity program, and the diagram verification all ran as multi-agent workflows — over a hundred agents across three model families, adversarially checked at every stage.

Full changelog: v0.2.0...v0.3.0