agentleFS
The-Artificer-of-Ciphers-LLCThe-Artificer-of-Ciphers-LLC/skills-from-the-artificer/choose-boring-technology/SKILL.md

choose-boring-technology

Skill6 starsChanged 34 days agoMITView on GitHub

Apply the "Choose Boring Technology" principle when evaluating tech stack decisions, adding new tools or frameworks, proposing a rewrite, or debating between a familiar vs. cutting-edge approach. Use this skill whenever someone is considering adopting a new library, language, database, or service—even if they frame it as "should we use X?", "what tech should we pick?", or "is it worth trying Y?". This skill helps teams resist shiny-object syndrome and make grounded technology choices.

The file

We split this skill into the rules it gives an agent

4 rules. About 0 are common, 4 are distinctive, and 0 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈4

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Ask these questions about the proposed tech:

    line 26
  2. Distinctive:

    If you do adopt something new, keep the old thing running where it already works.

    line 34
  3. Distinctive:

    When helping someone with a tech decision, work through:

    line 51
  4. Distinctive:

    If we adopt this, who will be on call when it breaks at midnight?

    line 55

≈ “Common” is an estimate: at least 1 in 5 of the 372,429 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Choose Boring Technology

"Consider how you would solve your immediate problem without adding anything new." — Dan McKinley, 2015

The core idea

McKinley's essay argues that every new technology you adopt is a "complexity token" you spend — and you only have a limited budget. Novel technologies bring unknown failure modes, thin internal expertise, and higher cognitive load. Boring technologies (well-understood, widely deployed, battle-tested) have predictable failure modes, rich documentation, broad community knowledge, and don't surprise you at 2am.

The law doesn't say "never adopt new tech." It says: be deliberate about when you do, and have a high bar.

How to apply it

Step 1 — Solve the problem with what you have first. Before evaluating any new option, ask: can you solve this with something already in your stack? A Postgres table instead of a new cache? A cron job instead of a message queue? The answer is often yes, and the boring solution is usually good enough longer than you expect.

Step 2 — Budget your complexity tokens. Assess how many unfamiliar technologies are already in flight on the team. If you're already running Kubernetes, a new microservices framework, and a new language, adding another unknown is risky. Teams have limited capacity to learn and operate things reliably.

Step 3 — Score the tradeoff honestly. Ask these questions about the proposed tech:

  • Does anyone on the team have real production experience with it?
  • What does failure look like, and do we know how to recover?
  • Is there a boring alternative that covers 80% of the use case?
  • What's the operational cost (monitoring, on-call, upgrades)?
  • Are we adopting this because it actually solves our problem, or because it's interesting?

Step 4 — Prefer addition over replacement. If you do adopt something new, keep the old thing running where it already works. Don't rip and replace — introduce incrementally and let the new thing earn its footprint.

When boring is the right call (almost always)

  • Startups and small teams: operational complexity kills small teams. Default to managed services and proven stacks.
  • Under time pressure: debugging unknown tech under deadline is brutal.
  • Core infrastructure: databases, queues, auth — these need to be boring.

When new tech is worth it

  • The boring alternative genuinely can't do the job (not just "does it less elegantly").
  • You have team members with real production experience in it.
  • The expected lifespan of this system justifies the learning investment.
  • You've prototyped it and it behaved predictably under realistic conditions.

Key questions to surface

When helping someone with a tech decision, work through:

  1. What's the actual problem we're solving?
  2. What's the simplest thing that could possibly work?
  3. What do we already have that we could stretch?
  4. If we adopt this, who will be on call when it breaks at midnight?
  5. Are we choosing this for us, or for the engineers who come after us?

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.