https://opchain.dev/blog Engineering deep-dives, opinions on AI-assisted development, playbooks, and releases. en-us Fri, 10 Jul 2026 00:00:00 GMT https://opchain.dev/blog/2026-07-10-the-docs-bot-doesnt-grade-its-own-homework https://opchain.dev/blog/2026-07-10-the-docs-bot-doesnt-grade-its-own-homework Fri, 10 Jul 2026 00:00:00 GMT The opchain team 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. engineering engineering documentation gates pr-workflow https://opchain.dev/blog/2026-07-10-v1-8-documentation-and-repo-hygiene https://opchain.dev/blog/2026-07-10-v1-8-documentation-and-repo-hygiene Fri, 10 Jul 2026 00:00:00 GMT The opchain team 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. release release documentation repo-hygiene git https://opchain.dev/blog/2026-07-02-seo-for-robots-that-arent-googlebot https://opchain.dev/blog/2026-07-02-seo-for-robots-that-arent-googlebot Thu, 02 Jul 2026 00:00:00 GMT The opchain team 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. engineering engineering mcp discovery agents https://opchain.dev/blog/2026-07-01-27-skills-is-not-too-many https://opchain.dev/blog/2026-07-01-27-skills-is-not-too-many Wed, 01 Jul 2026 00:00:00 GMT The opchain team 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. opinion opinion architecture skillchain https://opchain.dev/blog/2026-06-30-how-to-grow-a-protocol-without-breaking-anyone https://opchain.dev/blog/2026-06-30-how-to-grow-a-protocol-without-breaking-anyone Tue, 30 Jun 2026 00:00:00 GMT The opchain team 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. engineering engineering checkpoints protocol migration https://opchain.dev/blog/2026-06-29-telemetry-should-be-off-by-default https://opchain.dev/blog/2026-06-29-telemetry-should-be-off-by-default Mon, 29 Jun 2026 00:00:00 GMT The opchain team 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. opinion opinion telemetry privacy https://opchain.dev/blog/2026-06-28-our-cost-report-was-wrong-by-13x https://opchain.dev/blog/2026-06-28-our-cost-report-was-wrong-by-13x Sun, 28 Jun 2026 00:00:00 GMT The opchain team 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. engineering engineering dogfooding cost postmortem https://opchain.dev/blog/2026-06-27-what-building-opchain-with-opchain-cost https://opchain.dev/blog/2026-06-27-what-building-opchain-with-opchain-cost Sat, 27 Jun 2026 00:00:00 GMT The opchain team 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. engineering engineering dogfooding cost claude-code https://opchain.dev/blog/2026-06-26-v1-7-seams-and-signals https://opchain.dev/blog/2026-06-26-v1-7-seams-and-signals Fri, 26 Jun 2026 00:00:00 GMT The opchain team 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. release release signals monolith fleet https://opchain.dev/blog/2026-06-25-v1-6-the-instrumented-pipeline https://opchain.dev/blog/2026-06-25-v1-6-the-instrumented-pipeline Thu, 25 Jun 2026 00:00:00 GMT The opchain team 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. release release cost telemetry https://opchain.dev/blog/2026-06-24-from-django-monolith-to-shipped https://opchain.dev/blog/2026-06-24-from-django-monolith-to-shipped Wed, 24 Jun 2026 00:00:00 GMT The opchain team 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. playbook playbook django legacy reverse-spec https://opchain.dev/blog/2026-06-24-how-opchain-is-built-with-opchain https://opchain.dev/blog/2026-06-24-how-opchain-is-built-with-opchain Wed, 24 Jun 2026 00:00:00 GMT The opchain team 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. engineering engineering dogfooding meta https://opchain.dev/blog/2026-06-24-migrating-a-model-version-without-breaking-prod https://opchain.dev/blog/2026-06-24-migrating-a-model-version-without-breaking-prod Wed, 24 Jun 2026 00:00:00 GMT The opchain team 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. playbook playbook claude-api migration https://opchain.dev/blog/2026-06-24-vibe-coding-is-fine-until-it-isnt https://opchain.dev/blog/2026-06-24-vibe-coding-is-fine-until-it-isnt Wed, 24 Jun 2026 00:00:00 GMT The opchain team 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. opinion opinion process https://opchain.dev/blog/2026-06-24-what-a-checkpoint-actually-contains https://opchain.dev/blog/2026-06-24-what-a-checkpoint-actually-contains Wed, 24 Jun 2026 00:00:00 GMT The opchain team 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. engineering engineering checkpoints architecture https://opchain.dev/blog/2026-06-24-why-small-skills-beat-one-big-agent https://opchain.dev/blog/2026-06-24-why-small-skills-beat-one-big-agent Wed, 24 Jun 2026 00:00:00 GMT The opchain team 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. opinion opinion architecture skillchain https://opchain.dev/blog/2026-06-24-why-your-ai-coding-agent-forgets https://opchain.dev/blog/2026-06-24-why-your-ai-coding-agent-forgets Wed, 24 Jun 2026 00:00:00 GMT The opchain team 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. opinion memory checkpoints claude-code opinion https://opchain.dev/blog/2026-06-23-v1-5-build-the-ai-app https://opchain.dev/blog/2026-06-23-v1-5-build-the-ai-app Tue, 23 Jun 2026 00:00:00 GMT The opchain team opchain's biggest categorical expansion: four AI-native skills that take the LLM part of your app from idea to shipped, evaluated, and safe. release release ai-native https://opchain.dev/blog/2026-06-22-evaluate-dont-eyeball https://opchain.dev/blog/2026-06-22-evaluate-dont-eyeball Mon, 22 Jun 2026 00:00:00 GMT The opchain team 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. engineering eval prompts rag engineering https://opchain.dev/blog/2026-06-21-dogfooding-has-a-stopping-point https://opchain.dev/blog/2026-06-21-dogfooding-has-a-stopping-point Sun, 21 Jun 2026 00:00:00 GMT The opchain team 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. engineering engineering dogfooding rag https://opchain.dev/blog/2026-06-20-ship-a-rag-answer-bot-in-a-week https://opchain.dev/blog/2026-06-20-ship-a-rag-answer-bot-in-a-week Sat, 20 Jun 2026 00:00:00 GMT The opchain team 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. playbook playbook rag tutorial cloudflare https://opchain.dev/blog/2026-06-19-your-deploy-shouldnt-call-someone-elses-api https://opchain.dev/blog/2026-06-19-your-deploy-shouldnt-call-someone-elses-api Fri, 19 Jun 2026 00:00:00 GMT The opchain team Our deploys required a Linear API key to render a marketing page. On convenience integrations that quietly join the critical path — and demoting them. engineering engineering deploys dependencies https://opchain.dev/blog/2026-06-13-opchain-speaks-mcp-now https://opchain.dev/blog/2026-06-13-opchain-speaks-mcp-now Sat, 13 Jun 2026 00:00:00 GMT The opchain team 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. release release mcp codex https://opchain.dev/blog/2026-06-06-we-renamed-every-skill-in-one-pr https://opchain.dev/blog/2026-06-06-we-renamed-every-skill-in-one-pr Sat, 06 Jun 2026 00:00:00 GMT The opchain team 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. engineering engineering naming migration https://opchain.dev/blog/2026-05-15-the-deploy-that-forgot-to-happen https://opchain.dev/blog/2026-05-15-the-deploy-that-forgot-to-happen Fri, 15 May 2026 00:00:00 GMT The opchain team 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. engineering engineering deploys postmortem https://opchain.dev/blog/2026-05-12-v1-3-the-pipeline-meets-your-pm-tool https://opchain.dev/blog/2026-05-12-v1-3-the-pipeline-meets-your-pm-tool Tue, 12 May 2026 00:00:00 GMT The opchain team 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. release release pm-tools integrations