Home / clickety-clacks / tightbeam · priv/kungfu/agentic-engineering/skills/review-for-yagni/SKILL.md · GitHub

review-for-yagni skillA

review-for-yagni is agent-read markdown (skill) from clickety-clacks/tightbeam: The ask defines the whole of the work; anything beyond it is unfit, whatever its quality. Use as the embellishment lens on a change..

Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified before it reaches your agent: the main file against the SHA-256 recorded here, the others against the git hashes of its source commit. The deterministic audit below grades the latest version, and the same checks always give the same file the same grade.

What the file says

# Review for YAGNI

The ask defines the whole of the work. Anything beyond it fails the fitness test,
whatever its quality: it is not the ask. An embellishment adds untested surface area,
obscures the intent of the change, and widens the review beyond what the ask can prove;
unlike client scope creep, it bypassed every change-control conversation on its way in.

1. Enumerate every behavioral addition in the change: each validation, guard, fallback,
   retry, error handler, configuration option, feature flag, abstraction layer,
   compatibility path, and each fix of a bug the ask did not name.
2. For each addition, find the facet of the ask that requires it. An addition with a
   facet is in scope. An addition without one is beyond the ask and blocking: the work
   is unfit until it comes out or the ask is amended to include it.
3. No justification rescues an addition. "Safer," "defensive," "future-proof," "while I
   was in there," and "standard practice" do not make it the ask. Neither does "it was
   a small bug and I was right there." An incidental fix is its own card.
4. Flag the structural forms of over-engineering:
…

Read the whole file at its exact version.

How to install

Latest version
mdr add clickety-clacks/tightbeam/review-for-yagni@git:20260903.f172d5d
Exact content
mdr add clickety-clacks/tightbeam/review-for-yagni@sha256:54cf56a8265f6c69

Pin to a label to follow the author's releases, or to a sha256 for exact bytes. Either way the resolved hash is written to mdr.lock, and mdr install fetches those bytes again and checks them, so it installs them exactly or fails.

Badge

mdr badge

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

1 badge views in 30 days

Versions

versioncommittedcommitsizeaudit
git:20260903.f172d5d latest2026-09-03 f172d5d 2,455 BA view · diff
git:20260723.7608dd12026-07-23 7608dd1 2,173 BA view

Audit of the latest version

A  17 of 17 checks passed. Deterministic, no model, 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 (2455 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

clickety-clacks/tightbeam · 14 stars · license none · pushed 2026-09-27 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_urxibyzwqhufi23k
GET https://markdownregistry.com/api/v1/resolve?ref=clickety-clacks/tightbeam/review-for-yagni
GET https://markdownregistry.com/api/v1/blob/54cf56a8265f6c69b915b70be5ac457b74501e46e3230e72d7e238e1e1b684c5

Your agent 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.

More from clickety-clacks/tightbeam

AGENTS.md agents
clickety-clacks/tightbeam · AGENTS.md
git:20260831.00488a4 · audit A · 14 stars
CLAUDE.md claude
clickety-clacks/tightbeam · CLAUDE.md
git:20260822.8d0baa7 · audit A · 14 stars
<name>-example skill
clickety-clacks/tightbeam · priv/kungfu-template/skills/<name>-example/SKILL.md · Starter skill for the <name> kungfu; replace its body and description before election.
git:20260723.3521e84 · audit A · 14 stars
bug-provenance skill
clickety-clacks/tightbeam · priv/kungfu/agentic-engineering/skills/bug-provenance/SKILL.md
git:20260809.1917466 · audit C · 14 stars
committing-and-pushing skill
clickety-clacks/tightbeam · priv/kungfu/agentic-engineering/skills/committing-and-pushing/SKILL.md · Commit and push discipline — build before committing, one concern per commit with behavior and structure never mixed…
git:20260905.dbe46a8 · audit A · 14 stars
drafting-requirements skill
clickety-clacks/tightbeam · priv/kungfu/agentic-engineering/skills/drafting-requirements/SKILL.md · The craft of a single requirement — verifiability, atomicity, active voice, banned vague words, examples as acceptance…
git:20260723.7608dd1 · audit A · 14 stars
feature-cycle skill
clickety-clacks/tightbeam · priv/kungfu/agentic-engineering/skills/feature-cycle/SKILL.md · The loop that takes a feature from intent to a user-verified result — spec, adversarial spec review, decompose…
git:20260905.dbe46a8 · audit A · 14 stars
human-communication skill
clickety-clacks/tightbeam · priv/kungfu/agentic-engineering/skills/human-communication/SKILL.md · Write to a HUMAN in controlled plain English (derived from ASD-STE100) — active voice, simple tense, one instruction…
git:20260809.d4855f9 · audit A · 14 stars
model-release-intake skill
clickety-clacks/tightbeam · priv/kungfu/agentic-engineering/skills/model-release-intake/SKILL.md · Ceremony for taking in a newly released (or retired) model — detect catalog drift, characterize the new mind, update…
git:20260830.423449c · audit A · 14 stars
product-discovery skill
clickety-clacks/tightbeam · priv/kungfu/agentic-engineering/skills/product-discovery/SKILL.md · Drive an undefined or fuzzy product to a written spirit — elicit the real problem behind asks, reframe, deconflict, and…
git:20260723.7608dd1 · audit A · 14 stars
recon-first-investigation skill
clickety-clacks/tightbeam · priv/kungfu/agentic-engineering/skills/recon-first-investigation/SKILL.md · Establish the truth before anyone fixes — reproduce, enumerate competing hypotheses, disconfirm rather than confirm…
git:20260723.7608dd1 · audit A · 14 stars
recon-lifecycle skill
clickety-clacks/tightbeam · priv/kungfu/agentic-engineering/skills/recon-lifecycle/SKILL.md · A recon session answers one decidable question at decision grade, in one of four forms with its confidence, records it…
git:20260723.7608dd1 · audit A · 14 stars

Every file in clickety-clacks/tightbeam

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