Tertulia
Note

Note from Jan 16, 2026

I'm having Claude Code assist me in a major refactor of Apollo. The plan is to break it up into a few smaller modules: apollo-core, apollo-doobie, and apollo-http4s. Claude produced a PR quickly enough. The challenge: how do I, the senior engineer, know that Claude's code works? It's a huge PR that touches the entire project, surely you can't just trust the LLM. At least not yet. So: I set about to update the Apollo giter8 template to use the refactored version of Apollo. Note to self: yes, you need automated tests. Claude Code was less reliable here, but I ended up getting everything I needed from Tertulia and produced a working version. Next steps: I think the Claude PR is safe to merge, but with some caveats associated with the build system. Still, I think the safe thing to do is to copy a clean version into Tertulia's monorepo first, make sure everything works, then mint a new version. Once Tertulia's happy with the refactor... I'm pushing to Maven Central! And once that's done, I'll pull Tertulia off the monorepo to become Apollo's first user.

About the writer

Josh advises teams on AI systems architecture and modernization in regulated environments.

How I work →