Türker Yıldırım

refactoring

  • A module deleted, and the shared kernel that shrank

    Note2 min read

    Eight thousand lines removed, and six classes in the shared kernel that lost their only consumer. A shared kernel accumulates by the two-consumer rule and does not shed…

  • The command that became a method call

    Note1 min read

    Eighty-eight commands with one handler each, dispatched through four frames of indirection. A command bus provides cross-cutting concerns and eighty-eight one-to-one mappings provide indirection. The transaction middleware moved…

  • The command bus we removed

    Deep dive10 min read

    A command bus introduced in 2021, and 88 commands with one handler each. A stack trace with four frames of dispatch before the work.

  • Five workflow files becoming one

    Note2 min read

    Four years of adding a workflow per concern, consolidated into one file with jobs. The concurrency model and the permissions become expressible once everything is in one file,…

  • The test that had been quarantined since 2023

    Deep dive10 min read

    A quarantine list with a deadline, three extensions, and one test covering a payment path that had been skipped for three years.

  • Reusable skills and agent definitions, and what they are actually for

    Deep dive18 min read

    turkerdev/ai-skills and turkerdev/ai-agents, and eighteen months of retyping the same instructions. Context is per-session and knowledge is not.

  • Deleting a module

    Deep dive10 min read

    A module built in 2022 for a product line discontinued in 2024. Eight thousand lines, a database schema and two scheduled jobs, all still running.

  • A pipeline described in one file, after four years of five

    Deep dive10 min read

    Five workflow files, two composite actions, and nobody able to say what runs when. A change that needed editing three files, one of them wrong.

  • The value object library, five years on

    Deep dive10 min read

    32 value objects in 2021, 41 now, and a retrospective on which of them earned their place. No symptom — a deliberate look.

  • The stylesheet that finally got a second maintainer

    Deep dive10 min read

    2,100 lines that one person could change, and the year spent fixing that. Every stylesheet change routed through one person for four years.