Forum — 2026-07-07

When: Tuesday, July 7, 2026, 5–6 PM ET · Google Meet

Ideas

Anything you want to talk about. Each idea gets its own heading, a sentence or two of context, and a Notes line we fill in when we discuss it.

Weekly "bricks" — zrosenbauer

Each week you commit to one thing and deliver it as your primary focus (e.g. "move to a monorepo format with Turborepo"), and tie these into the weekly engineering updates for the org.

Notes:

Release process + Changesets — zrosenbauer

Adopt Changesets for versioning and define the whole release flow — how do we release daily, possibly on every merge to main?

Notes:

AI-authored PRs need a stated goal — zrosenbauer

For AI-authored PRs (Devin or similar), the PR needs to clearly explain what the goal was up front before anyone can review it.

Notes:

Code standards — zrosenbauer

Define shared code standards for the org, living under docs/standards/**. Keep them terse and skimmable — massaman's AGENTS.md is a good shape to model, an Always / Never / Ask-First boundaries list.

Split agent instructions (AGENTS.md / CLAUDE.md) from the coding standards themselves — right now they're tangled. The standards should be their own docs so we can change them independently; agent instructions then just point at them.

Break each rule out on its own line so it's easy to grok. Starters:

  • Named functions over arrow functions — reason TBD.
  • kebab-case for everything on the filesystem — avoids the case-insensitivity mismatch between macOS and Linux.

Notes:

Define our engineering process — the handbook ("Ways of Working"?) — zrosenbauer

The core problem for tomorrow. We don't have a defined process for how engineering plans, builds, ships, and QAs — end to end, idea → production. This is the foundation: it will drive every process decision across the engineering org, and product aligns to it. Goal of the forum is to get this going and agree the shape.

Scaffolded a light draft at docs/handbook/The Hitchhiker's Guide to Holly Engineering. Sections:

  • Foundation — Overview, Values, Ways of Working
  • Lifecycle (idea → shipped) — SDLC, Definition of Ready, Definition of Done, Release & QA
  • Operations — Incident Response, On-Call
  • Security — Secure Coding, Secrets & Access
  • Architecture — how we decide + record (ADRs) and a light view of the system
  • Craft — Engineering Standards, AI Development Standards

Reusable forms live in docs/templates/ (PRD, ADR, postmortem) and the decision records themselves in docs/adr/ — chapters link to them rather than embedding templates.

Name: going with "The Hitchhiker's Guide to Holly Engineering" (witty, memorable — the Don't Panic energy fits a reference you actually want people to open). "Ways of Working" is a chapter (team norms), not the book's name.

Notable calls (backed by a scan of real public handbooks — GitLab, PostHog, Trussworks, Obvious, Microsoft): incidents/on-call broke out into Operations; Security got its own section; no engineering-metrics chapter (lean handbooks don't — it's a dashboard concern); templates and ADR records moved out of the handbook so we don't scatter bare templates through the chapters.

Agenda (don't boil the ocean — lock the frame, not the content):

  • 0:00–0:05 — Why: this is our operating model; product aligns to it.
  • 0:05–0:20 — Ratify name + section structure. Timebox; decide the name today.
  • 0:20–0:35 — Assign a chapter owner for each chapter (highest leverage).
  • 0:35–0:50 — Draft one chapter live end-to-end as the template — DoD (small, high-agreement) — so everyone sees the shape and altitude.
  • 0:50–0:58 — Agree the contribution model: lives in this repo, change by PR to the owner, "last reviewed" date per chapter.
  • 0:58–1:00 — Homework: each owner drafts a one-paragraph stub before next forum.

Defer explicitly (owned + dated, not solved live): SDLC detail, AI standards specifics, incident sev definitions.

Notes:

Notes

Overall takeaways and decisions — anything that didn't belong to a single idea above.