Skip to content

Blue Silk.

An approach to software. A way of thinking about systems that you shape instead of suffer.

What blue silk is

Blue silk is the state where software stops feeling like an ungovernable beast and becomes a fabric you can shape.

You recognize it immediately: code is readable in 5 minutes, decisions are written somewhere, each module has clear boundaries, tests run in 30 seconds, mid-day deploys are normal.

Blue silk isn't elegance. It's the minimum condition where a team can work without fear and a founder can make informed decisions.

The opposite: the stone wall

You know you're facing a stone wall when: nobody touches that module because "it might break"; deploys happen Friday afternoon because "we're back Monday to fix"; the senior dev is the only one who understands a critical piece; bugs return after being fixed; the team gets frustrated and talent leaves.

The stone wall isn't a sudden disaster. It's the cumulative product of "quick" decisions made for months.

How I get to blue silk

Five principles. No fluff.

01

Reduction before addition.

Every added feature is a choice. Every removed feature is a leadership decision.

02

Explicit decisions.

If it matters, it's written. Architecture Decision Records readable in 5 minutes, not docs nobody opens.

03

Right stack, not resume stack.

Technology must serve the business, not the resume of whoever picks it.

04

Clear module boundaries.

What goes in, what comes out, who's responsible. Always. Modularity is strategic, not aesthetic.

05

Continuous, not heroic refactoring.

Small constant interventions, not big rewrites that fail.

Manifesto

Ten statements.

  1. 1A system you're afraid to touch is a broken system.
  2. 2Technical debt isn't bad by definition. It becomes bad when you stop paying it.
  3. 3Readability beats cleverness, always.
  4. 4A technical decision without a signed name is a decision nobody defends.
  5. 5Three hours of refactoring today are worth thirty hours of rework in three months.
  6. 6Delivery speed isn't how much code you write. It's how quickly you can change it.
  7. 7Documentation nobody updates is worse than silence.
  8. 8Mid-day deploys are an indicator of health, not an act of courage.
  9. 9Every external dependency is future debt. Choose them as carefully as you'd choose a co-founder.
  10. 10Technical complexity can't be eliminated. It can be moved. Pick where.

I build software in blue silk. If you want systems that don't scare you, let's talk.