2025-04-11 · Share

Open-source your internal tools without regret

What to scrub, what to promise, and how to keep the project maintainable after announcement day.

Introduction

A postmortem-style look at releasing two internal CLIs publicly: the licensing surprise, the docs debt, and the community pull we did not see coming.

Why this keeps coming up

Every Share conversation eventually lands on the same tension: what is comfortable for the team today versus what the project will need in a year. Neither side wins by argument alone.

A way to think about it

  • Defaults outlive intentions — design them deliberately.
  • Decisions are cheap to make and expensive to communicate; budget for the second part.
  • Disagreement is data. Write down what would change your mind.

What I would do

Start smaller than feels useful, write the reasoning in the commit or the RFC, and revisit it on a calendar date rather than a feeling.

Closing thoughts

Taste in Share is mostly memory. Collect yours on purpose.