Tag: Systems Engineering

Browse our exclusive articles!

Why a Merged Branch Suddenly Conflicts: Squash-Merge Divergence

You squash-merged a branch cleanly, kept working on the same branch, opened a new pull request — and it says CONFLICTING, on files nobody else touched. The branch isn't broken; squash merge quietly spent it.

Making a Claude Code Skill Trigger Reliably — and How to Measure It

A perfectly written skill that never fires is worthless. Whether it fires is decided by one thing — its description — and you can measure and tune that instead of guessing.

Writing a Claude Code Skill That Mutates a Real Store

Most skills hand back text or a file — a mistake there is a bad paragraph. A skill that writes to a live database or content store is different: a mistake is duplicated, corrupted, or lost data. The build discipline has to change with it.

Where Claude Code Skills Live — and the Rule That Keeps Them Tracked

You spent an afternoon building a skill. By default it landed in a personal folder that no repo sees and no teammate has. That's real work sitting outside version control.

Anatomy of a Claude Code Skill — and Why Progressive Disclosure Is the Whole Trick

A skill looks like a folder with a Markdown file in it. What makes it work is not the content — it is when each part of that content loads.

Popular

Many-to-One: Why a Mapping Backlog Outgrows Its Target Taxonomy

You're mapping a messy source vocabulary onto a clean target taxonomy. The target has about 5,600 slots, so the job must be roughly 5,600 decisions — right? The backlog is already past 8,900, and still climbing.

The Fix That Didn’t Take: When a Content-Hash Gate Skips Your Code Change

You shipped a fix to how one field is computed, re-ran the pipeline across everything, and it reported a clean run. Then the consistency check still flags those records as wrong. The fix is in the code, the rebuild "ran" — and the records never changed. Your own optimisation skipped them.

Your Dedup Scan Is Over-Counting — Because It Forgot What You Already Fixed

The report said 80 duplicate groups still to resolve. You'd been resolving them for days. You run it again after a big batch and it *still* says 80-ish. The backlog isn't stubborn — the scan is counting work you already finished.

When Your Skills Folder Is a Deploy Target, Not a Drawer

You hardened a skill in the repo, shipped the PR, and the agent kept loading the old one. Or you fixed the live skill by hand, and the versioned copy quietly stayed behind. Same root cause: the copy you run and the copy you version are two different files.

Subscribe