ls ~/writing --tag=methodology

[01]Writing · Tag

Articles tagged "methodology".

$ tag --stat methodology
Articles
7
Published
Feb→May 2026
Reading time
52 min
In series
3

Articles tagged methodology

7 articles

6 min [chrome-extension][github-actions][pre-commit-hooks]

Chrome extension version-bump discipline: pre-commit + GitHub Actions

The Chrome Web Store rejects re-uploads with the same manifest version. Catch the missed bump locally in a pre-commit hook; gate it again in CI.

Chrome Extension Lifecycle 3/3

chrome-extension-version-bump-precommit-ci--cover
Forget to bump one number and your users never get the update.

10 min [chrome-extension][manifest-v3][chrome-web-store]

Shipping a Manifest V3 Chrome extension: the gates nobody mentions

Trader verification, publisher identity, the URL slug gotcha, version-bump CI: the async gates that turn a one-day project into a three-week project.

Chrome Extension Lifecycle 1/3

ship-manifest-v3-chrome-extension-web-store--cover
The code was finished in a day. Shipping it took six weeks.

8 min [methodology][refactoring][lovable]

Phased migrations with per-phase verification gates

Big-bang refactors of 6+ files break things you cannot predict. Phased migration with explicit gates catches regressions before they compound.

Claude Code Engineering 9/9

phased-migrations-verification-gates--cover
One day writing the migration, then three days fixing it while users hit the bugs.

8 min [claude-code][claude-md][lovable]

How I document AI-built projects: a CLAUDE.md, ISSUES.md, and prompts/ workflow

Four files that fix the missing context in AI-built codebases: CLAUDE.md, ISSUES.md, a prompts/ folder, and a two-AI handoff workflow.

Claude Code Engineering 8/9

ai-built-project-4-part-system--cover
The only person who can explain your codebase is a model that forgot it six weeks ago.

6 min [supabase][postgrest][postgres]

How a Postgres constraint rename silently broke production via PostgREST

PostgREST resolves onConflict against real constraint names at runtime. Rename a constraint and the upsert silently fails with a 400 nobody notices.

Supabase Production Hardening 2/8

postgrest-upsert-constraint-rename-fragility--cover
The migration ran clean on Tuesday. On Thursday nobody could invite anyone.

7 min [javascript][typescript][timezone-handling]

Silent timezone bugs in JavaScript date arithmetic

`new Date().toISOString().split('T')[0]` returns the UTC date, not the user's local date. The bug, the fix, and why it only shows up in production.

silent-timezone-bugs-javascript-date--cover
I logged six hours on Thursday and they’re showing up under Wednesday.

7 min [issues-md][claude-code][methodology]

ISSUES.md as a learning log: the flat-file bug tracker that compounds

ISSUES.md is a flat markdown bug tracker that doubles as a regression detector and training doc for AI-built codebases. How the pattern works.

Claude Code Engineering 5/9

issues-md-learning-log--cover
The fix for bug 17 re-breaks bug 9, because nobody wrote down why bug 9 was fixed.

[02]Narrow it down

[03]Read in order

3 series run through this tag.

All articles