blog

Notes from the pipeline.

Engineering deep-dives, opinions on building with AI, end-to-end playbooks, and the story behind each release. Honest about what worked and what didn't. RSS.

Engineering · June 28, 2026 · 4 min read

Our cost report was wrong by 13×

Yesterday we told you building opchain cost $937. The real number is $72. The bug, the fix, and why plausible numbers are the most dangerous kind.

The opchain team Read →

Engineering July 10, 2026 · 4 min

The docs bot doesn't grade its own homework

Design notes on v1.8's every-PR mesh: why the author never verifies, staleness keyed to SHAs, idempotent PR comments, and gates that fail closed.
Read →
Release July 10, 2026 · 3 min

v1.8 — Documentation & repo hygiene

v1.8 adds oc-docs-forge and oc-repo-ops: every PR now ships a documentation packet and passes a fail-closed repo-readiness gate before it can open.
Read →
Engineering July 2, 2026 · 4 min

SEO for robots that aren't Googlebot

AI agents are a traffic class now. How opchain.dev advertises its MCP server to them — ARD catalog, llms.txt, did:web — and the robots.txt line we refused.
Read →
Opinion July 1, 2026 · 3 min

27 skills is not too many

A week ago we argued 22 small skills beat one big agent. We're at 27 now. The argument survived; the number didn't. On catalog growth without bloat.
Read →
Engineering June 30, 2026 · 3 min

How to grow a protocol without breaking anyone

Checkpoint wire 1.1 added three fields across 27 skills and zero checkpoints broke. The additive-field playbook for evolving agent state, step by step.
Read →
Opinion June 29, 2026 · 3 min

Telemetry should be off by default

Opt-out analytics is a dark pattern in a trench coat. opchain's usage metering is opt-in, local-first, and content-free by schema — here's the design.
Read →
Engineering June 27, 2026 · 4 min

What building opchain with opchain cost

We pointed oc-cost-ops at our own Claude Code history and priced every phase of building opchain. The receipts, the model mix, and where caching pays.
Series · Dogfooding opchain Read →
Release June 26, 2026 · 3 min

v1.7 — Seams & Signals

Three new skills for cutting monoliths safely, running real fleets, and proving your metrics tell the truth. Yes — the day after v1.6. We can explain.
Read →
Release June 25, 2026 · 3 min

v1.6 — The instrumented pipeline

opchain v1.6 adds oc-cost-ops and oc-telemetry-ops: cost attribution, budget gates, and opt-in usage metering. Your pipeline can now see what it spends.
Read →
Playbook June 24, 2026 · 5 min

From Django monolith to shipped in an afternoon

An old Django app, no docs, no tests, one nervous developer. A narrated walkthrough of reverse-spec → app-architect → deploy that turns 'I'm scared to touch it' into a shipped change.
Read →
Engineering June 24, 2026 · 5 min

How opchain.dev is built with opchain

The recursion in full: opchain.dev — this site — is planned, built, audited, and shipped with the opchain skills. A build log of eating our own cooking, including where it gets uncomfortable.
Series · Dogfooding opchain Read →
Playbook June 24, 2026 · 5 min

Migrating a model version without breaking prod

A new model drops, or your current one hits end-of-life. Here's the opchain playbook for swapping model versions as a reviewable diff with a measured score delta — not a hope and a redeploy.
Read →
Opinion June 24, 2026 · 4 min

Vibe coding is fine until it isn't

Vibe coding isn't the enemy — it's the right tool for exploration. The mistake is not noticing the moment you've crossed from exploring into shipping, where the rules change.
Read →
Engineering June 24, 2026 · 5 min

What a checkpoint actually contains

A checkpoint is how opchain survives the session. Here's the actual schema — field by field — and why each one exists. The anatomy of the file that makes resume work.
Read →
Opinion June 24, 2026 · 5 min

Why 22 small skills beat one big agent

The instinct is to build one agent that does everything. The Unix lesson — and opchain's bet — is that a chain of small, single-purpose skills beats the monolith on every axis that matters.
Read →
Opinion June 24, 2026 · 5 min

Why your AI coding agent forgets everything

The context window is not memory, and treating it like memory is why your coding agent loses the plot between chats. The fix is older than LLMs: write it down.
Read →
Release June 23, 2026 · 3 min

v1.5 — Build the AI app

opchain's biggest categorical expansion: four AI-native skills that take the LLM part of your app from idea to shipped, evaluated, and safe.
Read →
Engineering June 22, 2026 · 5 min

Evaluate, don't eyeball: putting prompts under test

A strong model will produce a confident answer over broken context — which means answer quality alone lies. The fix is to treat prompts like code: gate them on an eval set.
Series · Dogfooding opchain Read →
Engineering June 21, 2026 · 4 min

Dogfooding has a stopping point

Eating your own cooking is a quality signal, not a purity test. Where building opchain with opchain is real — and where forcing it would be theater.
Series · Dogfooding opchain Read →
Playbook June 20, 2026 · 5 min

Ship a RAG answer bot in a week with opchain

An end-to-end, day-by-day build of a docs answer bot — stack decision, retrieval eval, deploy — narrated with the real calls opchain makes at each step.
Read →
Engineering June 19, 2026 · 3 min

Your deploy shouldn't call someone else's API

Our deploys required a Linear API key to render a marketing page. On convenience integrations that quietly join the critical path — and demoting them.
Read →
Release June 13, 2026 · 2 min

opchain speaks MCP now

v1.4.3 extends opchain past Claude Code: a hosted MCP server at opchain.dev/mcp puts the skills in reach of Codex and any MCP client. The roadmap said v1.8.
Read →
Engineering June 6, 2026 · 3 min

We renamed every skill in one PR

All 18 skills gained an oc- prefix in one PR: identity, flags, commands, site, docs. Why namespacing was worth it — and what the rename taught us about drift.
Read →
Engineering May 15, 2026 · 3 min

The deploy that forgot to happen

Production ran six days stale while staging previewed a branch that never shipped. Nothing crashed — that was the problem. Here's the canary that fixed it.
Read →
Release May 12, 2026 · 3 min

v1.3 — The pipeline meets your PM tool

PM-MCP runtime across five skills, a platform menu that spans Cloudflare to Rust, and release-ops — opchain now cuts its own releases. Starting with this one.
Read →

Notes from the pipeline.

Our cost report was wrong by 13×

The docs bot doesn't grade its own homework

v1.8 — Documentation & repo hygiene

SEO for robots that aren't Googlebot

27 skills is not too many

How to grow a protocol without breaking anyone

Telemetry should be off by default

What building opchain with opchain cost

v1.7 — Seams & Signals

v1.6 — The instrumented pipeline

From Django monolith to shipped in an afternoon

How opchain.dev is built with opchain

Migrating a model version without breaking prod

Vibe coding is fine until it isn't

What a checkpoint actually contains

Why 22 small skills beat one big agent

Why your AI coding agent forgets everything

v1.5 — Build the AI app

Evaluate, don't eyeball: putting prompts under test

Dogfooding has a stopping point

Ship a RAG answer bot in a week with opchain

Your deploy shouldn't call someone else's API

opchain speaks MCP now

We renamed every skill in one PR

The deploy that forgot to happen

v1.3 — The pipeline meets your PM tool