differential-feature-refactor SKILL.md skillA

This file is byte-identical to the first copy the registry indexed. Same content hash, so the same checks give both the same grade.

differential-feature-refactor from arasz/ai-badger is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add arasz/ai-badger/differential-feature-refactor@v1.0.0

Pins v1.0.0 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
arasz/ai-badger
Path
features/common/skills/differential-feature-refactor/SKILL.md
Versions recorded
5
Latest version
v1.0.0, committed Aug 8, 2026
First version recorded
Jul 31, 2026
Size
12,404 bytes
Repository stars
3
License
MIT

Use when a feature already exists in code but has drifted from — or was never reconciled with — its intended design, and someone must decide what changes before a refactor is scoped. Triggers: two parallel implementations of the same thing, code that reads as dead but may be a ratified extension point, an architecture nobody can tell from accumulated cruft, or a refactor about to be scoped off review documents instead of decisions.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Differential Feature Refactor

Produce a **differential document** — a side-by-side of *what we have* versus *what we will
have* — that a human annotates, and that then becomes the input to a refactor specification
and an implementation plan.

**Why this exists.** A ratified architecture — an interface with an ADR behind it — was
reimplemented in parallel 36 minutes after it landed, with no ADR of its own. Five days later the
original read as "dead code" and was nearly deleted, which would have destroyed both a live
integration path and a requirement-level extension point. Twenty-plus documents described that
architecture and at least one described it falsely. Nobody could tell design intent from
accumulated cruft. This skill makes the difference legible **before** someone acts on it.

## The one rule that matters

**Never infer design intent from code shape.**

Requirements (`FR-`/`NFR-`), ADRs, and recorded rulings are the *only* authority on intent.
Code is evidence of what was built, never of what was meant. Review docs and plans are
proposals, not authority.

Establish the authority set **before** reading any implementation. If a thing in the tree has
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add arasz/ai-badger/differential-feature-refactor@sha256:d2c2850b1638a5e5

The line at the top of this page pins the label v1.0.0, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_ppmghgthh7mjybk6.svg)](https://markdownregistry.com/a/art_ppmghgthh7mjybk6)

1 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 5 versions of this file, between Jul 31, 2026 and Aug 8, 2026, about one every 2 days.

versioncommittedcommitsizeaudit
v1.0.0 latest2026-08-08 9006bf5 12,404 BA view · diff
v1.0.02026-08-07 013ee4d 12,389 BA view · diff
v1.0.02026-08-01 7c8a648 12,376 BA view · diff
v1.0.02026-08-01 a361ae8 11,930 BA view · diff
v1.0.02026-07-31 e49c165 11,383 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (12404 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

arasz/ai-badger · 3 stars · license MIT · pushed 2026-10-20 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_ppmghgthh7mjybk6
GET https://markdownregistry.com/api/v1/resolve?ref=arasz/ai-badger/differential-feature-refactor
GET https://markdownregistry.com/api/v1/blob/d2c2850b1638a5e50f6651a53d26a90256ed3661c3ad70d91cba28e7a34b3fcc

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from arasz/ai-badger

CLAUDE.md@.ai-badger CLAUDE.md file
arasz/ai-badger · .ai-badger/CLAUDE.md
git:20261007.5d99092 · audit A · 3 stars
ai-raccoon-memory SKILL.md skill
arasz/ai-badger · .ai-badger/skills/ai-raccoon-memory/SKILL.md · Use when a project needs a memory server — search project and shared memory first, write durable facts with source…
v0.2.0 · audit A · 3 stars
archify SKILL.md skill
arasz/ai-badger · .ai-badger/skills/archify/SKILL.md · Use when the user asks to visualize system architecture, infrastructure, cloud/security topology, technical workflows…
v2.16.0 · audit A · 3 stars
artifact-verification SKILL.md skill
arasz/ai-badger · .ai-badger/skills/artifact-verification/SKILL.md · Use when verifying changed artifacts that lack a canonical test gate — specs, docs, manifests, generated files…
v1.0.0 · audit A · 3 stars
auto-wm SKILL.md skill
arasz/ai-badger · .ai-badger/skills/auto-wm/SKILL.md · Use when the user wants Claude to auto-approve tool calls — "enable autonomic/autonomous work mode", "/auto-wm"…
v1.0.0 · audit A · 3 stars
browser-usage SKILL.md skill
arasz/ai-badger · .ai-badger/skills/browser-usage/SKILL.md · Use when interacting with web pages, running manual E2E browser tests, testing UI flows, or inspecting live web…
v1.0.0 · audit A · 3 stars
call-behaviorist SKILL.md skill
arasz/ai-badger · .ai-badger/skills/call-behaviorist/SKILL.md · Use when ai-badger's own machinery needs to be observed — "did that hook even run?", "enable debug logging", "why is…
v1.0.0 · audit A · 3 stars
code-review-checklist SKILL.md skill
arasz/ai-badger · .ai-badger/skills/code-review-checklist/SKILL.md · Use when reviewing code — a PR, a diff, or freshly written changes — and you want concrete pass/fail checks rather than…
v1.0.0 · audit B · 3 stars
code-review-evidence SKILL.md skill
arasz/ai-badger · .ai-badger/skills/code-review-evidence/SKILL.md · Use when reviewing code that wraps external libs/extensions/SDKs/CLIs, or QA-reviewing a test harness: verify…
v1.0.0 · audit A · 3 stars
code-review SKILL.md skill
arasz/ai-badger · .ai-badger/skills/code-review/SKILL.md · Use when performing a code review in this repository — reviewing a pull request, a branch diff, or a requested…
v1.0.0 · audit A · 3 stars
commit-reminder SKILL.md skill
arasz/ai-badger · .ai-badger/skills/commit-reminder/SKILL.md · Use when a project has accumulated uncommitted changes and nobody has said so out loud — several edits in a row with no…
v1.0.0 · audit A · 3 stars
complete-project-scope-code-review SKILL.md skill
arasz/ai-badger · .ai-badger/skills/complete-project-scope-code-review/SKILL.md · Use when the whole project — not a diff — is the review target and the result must survive being acted on: "review the…
v1.0.0 · audit A · 3 stars

Every file in arasz/ai-badger

Other files named differential-feature-refactor

differential-feature-refactor SKILL.md skill
arasz/ai-badger · .ai-badger/skills/differential-feature-refactor/SKILL.md · Use when a feature already exists in code but has drifted from — or was never reconciled with — its intended design…
v1.0.0 · audit A · 3 stars
differential-feature-refactor SKILL.md skill
arasz/ai-badger · skills/differential-feature-refactor/SKILL.md · Use when a feature already exists in code but has drifted from — or was never reconciled with — its intended design…
v1.0.0 · audit A · 3 stars

Browse by kind, by grade A, or by owner.