Writing
The Blog
Notes from building software, leading teams, and working with AI.

Agent handoffs are a state machine, not a message thread
Building Agent Inbox showed me that a handoff between an agent and a human needs explicit state ownership, version tokens, and acknowledgements.

Offline-first is the baseline
Building an offline-first AI meeting recorder forced me to invert the cloud default, changing reliability, privacy claims, pricing, and the stack.

Terminal scroll is not a workflow
I built a coding agent inbox when terminal scroll ate the decisions and assumptions my agents made across Claude Code, Copilot CLI, and multiple repos.

AI became my operating model
86% of my merged PRs on Oris were agent-labeled. That measures activity, not quality. The real question was whether my review and controls kept pace with what I was delegating.

Local LLMs are the better default for bespoke apps
Local models give a bespoke app an on-device path, no per-token API bill, and control over model updates. How we built that choice into Oris's summarization pipeline.

Hooks, not vibes: deterministic guard-rails for Claude Code
Rules written as prose in an agent's config only hold while the agent remembers them. I moved seven of lognote's rules into Claude Code hooks and learned where determinism stops.

Day one of a fast-moving beta
I sent the lognote private beta to the waitlist last night. The core held up all day. Around it: a 404'd launch post, a 64GB memory freeze, and CI out of minutes. Still worth it.

Rewriting our engine with Claude Opus 4.8 and dynamic workflows
I rewrote lognote's engine from Python to Swift one module at a time with Claude Opus 4.8 in Claude Code, keeping the old Python pipeline as a byte-for-byte reference and a second model reviewing every PR.

Rebuilding shariq.dev
The old shariq.dev was a Tailwind/Next.js starter frozen since 2021. I rebuilt it as an AI-drafted, PR-reviewed publishing pipeline on Astro and Cloudflare Pages.

Next.js Context API tutorial
How to use the React Context API to share state across a Next.js app.

Deploy microservices to Heroku with Docker ARG and ENV variables and GitHub Actions
How to deploy platform-agnostic microservices to Heroku with GitHub Actions, using Docker ARG and ENV variables for configuration.

Managing your lows
Everyone has good days and bad days. How do you manage the bad ones?

Next.js and Tailwind CSS made me want to write front-end code
With a back-end and architecture background, front-end work always felt daunting. Next.js and Tailwind CSS changed that.

Deploy NestJS with Docker, Heroku, and GitHub Actions
A step-by-step CI/CD tutorial for deploying a NestJS microservice with Docker, Heroku, and GitHub Actions.

Five skills to move up in technical leadership
Growing as a technical lead means balancing your team and your stakeholders. These are the five skills that matter most.

A cloud native CI/CD flow
Most teams stop at continuous integration and skip continuous deployment. A look at cloud native tooling that takes a pipeline all the way to deploy.

Launching a SonarQube Docker container
The basics of running SonarQube as a Docker container, and why you'd want to.

Developer cheat sheet
My personal developer cheat sheet with shortcuts for common tasks.

The free blogging resources I use every day
The free tools I use for writing, images, icons, SEO, and sharing, for anyone starting a blog.

Installing Docker and Docker Compose
How to install Docker and Docker Compose on Ubuntu, macOS, and Windows with WSL2.

Be shamelessly cutting edge
Whether you work solo, at a startup, or inside a bigger company, aim to work at the bleeding edge and use the chaos to your advantage.

Ethics of software engineering
Four principles for making ethics a core part of how developers build software, not an afterthought.