cad-why SKILL.md skillA

cad-why from crenshawdev/cadence is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add crenshawdev/cadence/cad-why@git:20261029.0ae5ff0

Pins git:20261029.0ae5ff0 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
crenshawdev/cadence
Path
skills/cad-why/SKILL.md
Versions recorded
2
Latest version
git:20261029.0ae5ff0, committed Oct 29, 2026
First version recorded
Aug 23, 2026
Size
1,269 bytes
Repository stars
11
License
MIT

Why is this code like this - a git-log chain over one file[:line], joined to the phase, task, decision, deviation and review record on disk.

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

<objective>
Answer "why is this code like this" from the record already on disk, at one
file and line. Read-only: no write, no dispatch, no summarization - the seam
does the whole join and this skill relays what it returns.
</objective>

<process>
1. Run the seam with the query as ONE single-quoted literal word:
   `node "${CLAUDE_PLUGIN_ROOT}/cadence-core/bin/why.mjs" '<path>[:<line>]' --dir .`
   Single quotes, never double: `$ARGUMENTS` is caller-supplied, and a
   double-quoted `$(...)` or backtick inside it runs before Node starts. A
   query containing a single quote is refused here, never escaped. Parse the
   one JSON line it prints.
2. `ok:false` - state the `reason` and `detail` fields plainly and stop.
3. `ok:true` - print the `text` field VERBATIM and nothing else: no summary
   before it, no commentary after it, no reformatting. `text` is already the
   whole answer, quoted from the record in its own words - reformatting it
   here would make the byte-identity a reader can check against the seam's
   own output false.
</process>

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add crenshawdev/cadence/cad-why@sha256:c90a6d99d48350c2

The line at the top of this page pins the label git:20261029.0ae5ff0, 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_c2ofpgu6rkvbhjc6.svg)](https://markdownregistry.com/a/art_c2ofpgu6rkvbhjc6)

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

Versions

The registry has recorded 2 versions of this file, between Aug 23, 2026 and Oct 29, 2026, about one every 67 days.

versioncommittedcommitsizeaudit
git:20261029.0ae5ff0 latest2026-10-29 0ae5ff0 1,269 BA view · diff
git:20260823.cbba5d52026-08-23 cbba5d5 1,293 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 (1269 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

crenshawdev/cadence · 11 stars · license MIT · pushed 2026-11-08 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_c2ofpgu6rkvbhjc6
GET https://markdownregistry.com/api/v1/resolve?ref=crenshawdev/cadence/cad-why
GET https://markdownregistry.com/api/v1/blob/c90a6d99d48350c2f78b3f75e546a15e83ad9678be330c9a88fd66a0ffe07078

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 crenshawdev/cadence

DESIGN.md DESIGN.md file
crenshawdev/cadence · DESIGN.md
git:20261030.096ea8a · audit A · 11 stars
cad-adopt SKILL.md skill
crenshawdev/cadence · skills/cad-adopt/SKILL.md · Initialize .planning/ from a repo that already exists - PROJECT.md, REQUIREMENTS.md and a remaining-work ROADMAP.md…
git:20261029.0ae5ff0 · audit A · 11 stars
cad-assumptions-analyzer-contract SKILL.md skill
crenshawdev/cadence · skills/cad-assumptions-analyzer-contract/SKILL.md · Role contract preloaded at spawn by the cad-assumptions-analyzer, cad-assumptions-analyzer-low…
git:20261028.dd1f3d4 · audit A · 11 stars
cad-audit SKILL.md skill
crenshawdev/cadence · skills/cad-audit/SKILL.md · Pre-ship traceability audit - every requirement traced to a phase, plan and verification, orphan detection both…
git:20261029.0ae5ff0 · audit A · 11 stars
cad-capture SKILL.md skill
crenshawdev/cadence · skills/cad-capture/SKILL.md · Capture a phase-linked todo, a seed idea for a future milestone, or a note, without losing your place -…
git:20261029.0ae5ff0 · audit A · 11 stars
cad-config SKILL.md skill
crenshawdev/cadence · skills/cad-config/SKILL.md · Configure Cadence's config.json - workflow toggles, the per-role model and effort interview, and interactive…
git:20261103.88a7eae · audit A · 11 stars
cad-context SKILL.md skill
crenshawdev/cadence · skills/cad-context/SKILL.md · Gather phase context before planning - codebase assumptions, locked decisions, falsifiable acceptance criteria - in one…
git:20261029.0ae5ff0 · audit A · 11 stars
cad-coverage SKILL.md skill
crenshawdev/cadence · skills/cad-coverage/SKILL.md · Find a completed phase's requirements with no failing-capable test coverage and generate tests to close the gaps, in…
git:20261103.1c9f757 · audit A · 11 stars
cad-debug SKILL.md skill
crenshawdev/cadence · skills/cad-debug/SKILL.md · Systematic debugging - hypothesis and symptom tracked in a state file that survives /clear, with a user-gated…
git:20261029.0ae5ff0 · audit A · 11 stars
cad-decision-review SKILL.md skill
crenshawdev/cadence · skills/cad-decision-review/SKILL.md · Adversarial refute-then-adjudicate pass over one load-bearing decision - a CONTEXT D-NN line or a PROJECT Key Decisions…
git:20261029.0ae5ff0 · audit A · 11 stars
cad-docs-verify SKILL.md skill
crenshawdev/cadence · skills/cad-docs-verify/SKILL.md · Verify docs claims against the live codebase - paths, commands, symbols, config keys - each reported accurate, stale or…
git:20261029.0ae5ff0 · audit A · 11 stars
cad-execute SKILL.md skill
crenshawdev/cadence · skills/cad-execute/SKILL.md · Execute a phase's plans - a subagent per plan, an atomic commit per task, a slim per-phase SUMMARY
git:20261029.0ae5ff0 · audit A · 11 stars

Every file in crenshawdev/cadence

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