Updated the public AGENTS.md engineering guide after reviewing all five network sites. Preserved existing Ruby-first, identity, secrets and testing policies; distinguished requirements from verified deployment; added browser/offline privacy, accessibility, source provenance, scoped worktree/review/publication and maintenance rules. Added a homepage download link. No root-wide or private agent configuration changed.
Published Government accessibility, standards and Ruby, with the revised 2027/2028 ADA Title II deadlines, version-specific standards, USWDS and GOV.UK tooling, Rails integration and accessibility assessment evidence. Linked from the browser-first series and standards guide.
Added Ruby applications in the browser, a proposal distinguishing demonstrated CRuby/Rails capabilities from adapters and roadmap work, with storage, networking, security and verification requirements.
Added Ruby-aligned thinkers, a selected reading map distinguishing direct contributors from ideas adopted across traditions, with practical uses and limits.
Added Scaling web apps: Cal Henderson, an editorial profile with alternative perspectives, practical tradeoffs, six open-source platform blueprints and a Rails checklist.
Published a guide to retrieval-augmented generation (rag.html): page-number citations, hybrid search, reranking, late interaction, query rewriting, grounding, a golden eval set, retrieval metrics and a benchmark against naive RAG.
Text JOIN to the ruby.im number to get the SMS sign-up link
Added a help contact (email and phone) to the SMS terms and privacy policy
Added a text-message sign-up page with double opt-in, plus its SMS terms and privacy policy
Added docs.ruby.im (private, behind sign-in)
Now served through self-hosted edge (Caddy on DigitalOcean) instead of ngrok
Added Films made in code, on an AI motion director brief: films rendered frame by frame in code and checked by a separate critic agent, and how it fits our agent workspace.
Published the consent-engineering section: US channel/legal guidance, dated FCC changes, TCR and provider practices, and a proposed Rails ledger with suppression, dispatch-race and privacy controls. Guidance only; no messaging system activated.
Added Open AI interfaces, an article on open-source chat interfaces and how they could become a threads workspace for Claude Code, Codex, Jev and future models.
Added a disclaimer line to every page footer and a full disclaimer page at /disclaimer.html.
Observability page now describes the visitor and scan dashboard and links to its write-up on jaycorp.us.
Added a short privacy note to every page: visits are logged on our own server to understand traffic and spot attacks.
Linked the live Grafana dashboard at /grafana, behind Google sign-in and a Grafana login, from the home page and the Observability page.
Added a footer linking to the other sites in the network.
Restyled the home page to match the other pages and grouped the pages into Ruby and Rails, Building apps and Running it, with each page linking back to its group, its sibling pages and the next and previous page
Added 5G backup uplink options to the Hardware page
Added a Hardware page on the machine's limits for local AI and proposed upgrades, with risky firmware mods labelled
Added section 17 to AGENTS.md on testing, including rules for AI-written code and a release gate
Added a Testing page with the ideas of Kent Beck, Michael Feathers, Gerard Meszaros and Glenford Myers, 160 testing standards, a release gate and rules for AI-written code
Added an outside services section to AGENTS.md: every service sits behind an adapter, uploads go directly to S3-compatible storage with presigned URLs and tenant-scoped keys, and we never handle card numbers.
Added a Services page on email, SMS, push notifications, card billing and S3-compatible storage, each behind an adapter, with files uploaded straight from the browser or app, linked from the home page.
Added an identity and access section to AGENTS.md: apps are multitenant from the start, sign in through OIDC to a swappable identity provider, and prefer passkeys and hardware keys.
Added an Identity page on multitenant organizations with group and rooftop access, enterprise single sign-on through a self-hostable identity provider, and passkeys with YubiKeys, linked from the home page.
Added a Twelve-factor apps page explaining how every project here follows the methodology, linked from the home page.
Added a twelve-factor section to AGENTS.md: every project keeps config in its environment, logs to stdout, and runs as stateless, disposable processes.
Secrets now live in a git-ignored .env file per project instead of one file per secret, on the Secrets page and in AGENTS.md section 13.
Added a secrets section to AGENTS.md: read secrets through the adapter and never print, log, commit or paste their values.
Added a Secrets page on how we keep API keys and tokens: one Ruby adapter, local files by default, Bitwarden Secrets Manager as a swappable second provider.
ruby.im now records where each visit comes from (search engines, AI crawlers and assistants, social sites, other bots), shown on the Observability page and dashboard.
AGENTS.md section 12 now points to observability/README.md for the Grafana stack running on this machine.
The Observability page now describes the stack we run: the OpenTelemetry Collector feeding Prometheus, Loki, Tempo and one Grafana dashboard.
Observability now covers the machines too: every host reports CPU, load, memory, disk, network and GPU, in AGENTS.md and on the Observability page.
Added an observability section to AGENTS.md: every new solution is registered and reports usage, performance and errors to one place.
Added an Observability page on one self-hosted place for usage, performance and errors, built on OpenTelemetry, linked from the home page.
Added an open, portable and self-hosted section to AGENTS.md, inspired by Richard Stallman's ideas.
Added an Own your stack page on open source, self-hosting and provider adapters, linked from the home page.
Added a section to AGENTS.md on moving to C when Ruby is the measured bottleneck.
Added a Ruby and C page on handing slow hot paths to C through gems, FFI and C extensions, linked from the home page.
Added a Rails-mindset section to AGENTS.md, inspired by DHH's ideas.
Added a Rails mindset page on DHH's ideas behind Rails, linked from the home page.
Added a performance section to AGENTS.md, inspired by Nate Berkopec's teaching.
Added a Caching in Rails page summarizing Nate Berkopec's caching guide, linked from the home page.
Added a Why Ruby page on why Ruby suits both language models and people.
Added an engineering-discipline section to AGENTS.md, inspired by Linus Torvalds's principles.
Added a Ruby-way section to AGENTS.md, inspired by Matz's philosophy for Ruby.
Published AGENTS.md: Karpathy-style rules for coding agents, Ruby first.
Added this changelog, linked from the home page.
Switched to a Rack server; pages now reload only when they change.
Site launched with a placeholder page, served from this machine through ngrok.
Provided as is, for information only, with no warranty and no liability. Not legal or professional advice. Security and radio material is for authorized, lawful use only. Full disclaimer.
Visits are logged on our own server: IP address, browser and device details, and pages viewed. We use them to understand traffic and spot attacks, and never share or sell them.