Home / llopresto87 / cypress · skills/holistic-editing/SKILL.md · GitHub

holistic-editing skillA

holistic-editing is agent-read markdown (skill) from llopresto87/cypress: The discipline for any change, fix, refactor, or review whose unit of work is larger than a trivial one-liner. Use whenever you edit existing code or a knowledge page — the unit of work is the whole file or module, never the smallest diff that satisfies the request. A change is complete only when the file reads as if the requirement had existed from the beginning: no bolted-on functions, no _v2 wrappers, no special-case branches around logic that should itself change, no now-dead code left "to b.

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 against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.

What the file says

# holistic-editing

You are a senior engineer performing an **integration, not a patch**.
When asked to change, fix, refactor, or review something, your unit of
work is the whole file or module — never the smallest diff that
satisfies the request.

## Prime directive

A change is only complete when the file reads as if the requirement
had existed from the beginning. If a reviewer could point to where
your change was bolted on, you have failed. Minimal diffs are not a
virtue here; **coherence is**.

This does not license gold-plating. "Minimum" still governs *new
behavior* — you add no capability nobody asked for, and you do not
expand into unrelated code (that is scope creep; file it for its own
increment). But the code that delivers the behavior you *were* asked
for is integrated into the existing design, not stapled to its edge.

## Mandatory process, in order, every time

1. **Comprehend first.** Before writing code, state briefly: the
   file's responsibilities, its main structures and abstractions, and
   its conventions (naming, error handling, patterns). If you can't,
   ask for the missing context or read it — never reconstruct a file
…

Read the whole file at its exact version.

How to install

Latest version
mdr add llopresto87/cypress/holistic-editing@git:20260915.df30567
Exact content
mdr add llopresto87/cypress/holistic-editing@sha256:728dd08a588a5ebf

Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.

Badge

mdr badge

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

1 badge views in 30 days

Versions

versioncommittedcommitsizeaudit
git:20260915.df30567 latest2026-09-15 df30567 11,924 BA view · diff
git:20260906.53f845a2026-09-06 53f845a 11,750 BA view · diff
git:20260831.6dde4342026-08-31 6dde434 8,366 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 (11924 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

llopresto87/cypress · 43 stars · license MIT · pushed 2026-09-24 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_yfblyvuuptode2lb
GET https://markdownregistry.com/api/v1/resolve?ref=llopresto87/cypress/holistic-editing
GET https://markdownregistry.com/api/v1/blob/728dd08a588a5ebfcc562ef364d2109b57db02dd22d5951950f4a82134fc32c5

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 llopresto87/cypress

CLAUDE.md claude
llopresto87/cypress · CLAUDE.md
git:20260924.fae0414 · audit A · 43 stars
AGENTS.md@core agents
llopresto87/cypress · core/AGENTS.md
git:20260915.df30567 · audit A · 43 stars
adopt-existing skill
llopresto87/cypress · skills/adopt-existing/SKILL.md · Source-first growth of an existing single- or multi-repository project into CYPRESS's unified docs/graph knowledge…
git:20260915.df30567 · audit A · 43 stars
adr-writer skill
llopresto87/cypress · skills/adr-writer/SKILL.md · Author an Architecture Decision Record that captures a non-obvious technical choice — its context, the decision, the…
git:20260915.df30567 · audit A · 43 stars
brainstorm-internal skill
llopresto87/cypress · skills/brainstorm-internal/SKILL.md · The divergence technique CYPRESS applies to itself, with no user in the loop — generating genuinely distinct options…
git:20260921.0e86c1a · audit A · 43 stars
brainstorm-socratic skill
llopresto87/cypress · skills/brainstorm-socratic/SKILL.md · The Socratic questioning technique that converges a vague goal — question selection, one-to-three-per-turn pacing, the…
git:20260921.0e86c1a · audit A · 43 stars
context-router skill
llopresto87/cypress · skills/context-router/SKILL.md · Resolve the minimum set of knowledge-graph nodes needed for a task before reading any source file. Use at the START of…
git:20260923.837b1a5 · audit A · 43 stars
grill-planner skill
llopresto87/cypress · skills/grill-planner/SKILL.md · The authoring discipline for the project's plan-of-record at docs/graph/plans/grill.md — what a worker filling any…
git:20260922.d73629d · audit A · 43 stars
humanizer skill
llopresto87/cypress · skills/humanizer/SKILL.md · Draft or revise prose a person will read (documentation, README text, ADR and spec bodies, runbooks, pull-request…
git:20260915.df30567 · audit A · 43 stars
knowledge-graph skill
llopresto87/cypress · skills/knowledge-graph/SKILL.md · Build and maintain the project's knowledge graph — a tiered set of nodes under docs/graph/ that lets an agent load only…
git:20260917.c81f94c · audit A · 43 stars
library-wiki skill
llopresto87/cypress · skills/library-wiki/SKILL.md · Maintain a project-local, version-pinned wiki of every external dependency. Use whenever a new library is being added…
git:20260922.d73629d · audit A · 43 stars
research-and-ingest skill
llopresto87/cypress · skills/research-and-ingest/SKILL.md · Find authoritative sources on the web (or via documentation MCP servers like Context7/DeepWiki), download or snapshot…
git:20260915.df30567 · audit A · 43 stars

Every file in llopresto87/cypress

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