Skip to content

Writing

The Blog

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

Cover illustration for "Agent handoffs are a state machine, not a message thread".
AI Sep 8, 2026

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.

Cover illustration for "Offline-first is the baseline".
Engineering Sep 1, 2026

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.

Cover illustration for "Terminal scroll is not a workflow".
Process Aug 24, 2026

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.

Cover illustration for "AI became my operating model".
Process Aug 11, 2026

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.

Cover illustration for "Local LLMs are the better default for bespoke apps".
AI Aug 7, 2026

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.

Cover illustration for "Hooks, not vibes: deterministic guard-rails for Claude Code".
AI Jun 29, 2026

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.

Cover illustration for "Day one of a fast-moving beta".
Notes Jun 24, 2026

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.

Cover illustration for "Rewriting our engine with Claude Opus 4.8 and dynamic workflows".
AI Jun 8, 2026

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.

Cover illustration for "Rebuilding shariq.dev".
Engineering May 28, 2026

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.

Cover illustration for "Next.js Context API tutorial".
Engineering Dec 1, 2021

Next.js Context API tutorial

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

Cover illustration for "Deploy microservices to Heroku with Docker ARG and ENV variables and GitHub Actions".
Engineering Nov 25, 2021

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.

Cover illustration for "Managing your lows".
Leadership Nov 22, 2021

Managing your lows

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

Cover illustration for "Next.js and Tailwind CSS made me want to write front-end code".
Engineering Nov 11, 2021

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.

Cover illustration for "Deploy NestJS with Docker, Heroku, and GitHub Actions".
Engineering Oct 1, 2021

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.

Cover illustration for "Five skills to move up in technical leadership".
Leadership Sep 27, 2021

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.

Cover illustration for "A cloud native CI/CD flow".
Engineering Sep 2, 2021

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.

Cover illustration for "Launching a SonarQube Docker container".
Engineering Aug 28, 2021

Launching a SonarQube Docker container

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

Cover illustration for "Developer cheat sheet".
Process Aug 26, 2021

Developer cheat sheet

My personal developer cheat sheet with shortcuts for common tasks.

Cover illustration for "The free blogging resources I use every day".
Process Aug 25, 2021

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.

Cover illustration for "Installing Docker and Docker Compose".
Engineering Aug 23, 2021

Installing Docker and Docker Compose

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

Cover illustration for "Be shamelessly cutting edge".
Leadership Aug 17, 2021

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.

Cover illustration for "Ethics of software engineering".
Engineering Jun 30, 2021

Ethics of software engineering

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