Archive - Refactoring

Vibe-coding workflows 🪄

A top-down process for doing AI coding right, plus a full cast of supporting techniques.

Apr 30 •

In Praise of "Normal" Engineers 🛠️

A guest article by Charity Majors

Feb 12 •

and

The Engineering Manager Archetypes 📊

A thorough framework to identify how engineering managers create value inside orgs.

Jun 4 •

and

How to Design APIs for an AI World 🔌

A thorough analysis of how AI changes what is needed from a good API, with real-world examples + some speculations about the future.

Jun 11 •

How AI is Changing Engineering Docs 📑

A practical guide on how to think about docs in the age of AI.

Jun 23 •

Conflict Resolution Strategies ⚔️

A four-step framework to resolve conflicts

Jan 29 •

and

Nicola Ballotta

How to make your tech stack AI-friendly 📏

The dominant conversation in software engineering today is obviously about AI.

Jul 23 •

How to Build a Product Engineering Culture 🪴

A practical handbook about how to run some of your most common product engineering processes.

Aug 20 •

How to Plan and Execute Software Projects 🚢

A no-nonsense guide to build the right things and build them on time.

Jan 11, 2024 •

How To Take Notes 🌱

Plus my review and summary of How to Take Smart Notes — by Soenke Ahrens

Aug 13 •

Generalists in 2025 🎨

My reflections on generalist careers in the age of AI

Oct 1 •

Engineers are replacing IDEs with terminals 🖥️

Let's understand why this is happening, and what may be coming next.

Oct 15 •

#nojs-banner { position: fixed; bottom: 0; left: 0; padding: 16px 16px 16px 32px; width: 100%; box-sizing: border-box; background: red; color: white; font-family: -apple-system, "Segoe UI", Roboto, Helvetica, Arial, sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol"; font-size: 13px; line-height: 13px; } #nojs-banner a { color: inherit; text-decoration: underline; } This site requires JavaScript to run correctly. Please turn on JavaScript or unblock scripts