From 8dccaeb261a9be3b0613d5f3ee1cad10bec2ddca Mon Sep 17 00:00:00 2001 From: Sunho Kim Date: Wed, 1 Apr 2026 17:14:43 +0900 Subject: [PATCH 1/5] Add pattern 25: Diff-Anchored Writing Documentation and comments should stand on their own without requiring knowledge of what changed in the last commit. Co-Authored-By: Claude Opus 4.6 (1M context) --- SKILL.md | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/SKILL.md b/SKILL.md index 46639f0..4cc6ce8 100644 --- a/SKILL.md +++ b/SKILL.md @@ -463,6 +463,24 @@ Avoiding AI patterns is only half the job. Sterile, voiceless writing is just as --- +### 25. Diff-Anchored Writing + +**Problem:** Writing that is overly coupled to a specific change or point-in-time diff rather than making statements that stand on their own. Unless the document is inherently version-scoped (release notes, changelogs, migration guides), documentation and comments should read coherently without knowing what changed in the last commit. + +**Before:** +> This function was added to replace the previous approach of iterating through all items. The old method caused O(n²) performance, so we now use a hash map instead. + +**After:** +> This function uses a hash map for O(1) lookups per item, avoiding the O(n²) cost of naive iteration. + +**Before:** +> We removed the `legacy_auth` middleware because legal flagged it for storing session tokens in a non-compliant way. The new implementation uses encrypted cookies. + +**After:** +> Authentication uses encrypted cookies for session storage, meeting the current compliance requirements for token handling. + +--- + ## Process 1. Read the input text carefully From 7fa52817a4f17dafb8fd1ee9cbc1ba7f4c5905e3 Mon Sep 17 00:00:00 2001 From: Sunho Kim Date: Wed, 1 Apr 2026 17:39:20 +0900 Subject: [PATCH 2/5] =?UTF-8?q?Fix=20pattern=20numbering=20(25=20=E2=86=92?= =?UTF-8?q?=2030)=20and=20update=20README?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Opus 4.6 (1M context) --- README.md | 4 +++- SKILL.md | 2 +- 2 files changed, 4 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 120bec1..574baba 100644 --- a/README.md +++ b/README.md @@ -88,7 +88,7 @@ The skill also includes a final "obviously AI generated" audit pass and a second > "LLMs use statistical algorithms to guess what should come next. The result tends toward the most statistically likely result that applies to the widest variety of cases." -## 29 Patterns Detected (with Before/After Examples) +## 30 Patterns Detected (with Before/After Examples) ### Content Patterns @@ -127,6 +127,7 @@ The skill also includes a final "obviously AI generated" audit pass and a second | 27 | **Persuasive authority tropes** | "At its core, what matters is..." | State the point directly | | 28 | **Signposting announcements** | "Let's dive in", "Here's what you need to know" | Start with the content | | 29 | **Fragmented headers** | "## Performance" + "Speed matters." | Let the heading do the work | +| 30 | **Diff-anchored writing** | "This was added to replace the old approach" | Describe what the code does, not what changed | ### Communication Patterns @@ -179,6 +180,7 @@ The skill also includes a final "obviously AI generated" audit pass and a second ## Version History +- **2.6.0** - Added pattern #30: diff-anchored writing (docs that narrate changes instead of describing the code) - **2.5.1** - Added a passive-voice / subjectless-fragment rule, raising the total to 29 patterns - **2.5.0** - Added patterns for persuasive framing, signposting, and fragmented headers; expanded negative parallelisms to cover tailing negations; tightened wording around em dash overuse; fixed frontmatter wording to use "filler phrases" - **2.4.0** - Added voice calibration: match the user's personal writing style from samples diff --git a/SKILL.md b/SKILL.md index 4cc6ce8..de543b9 100644 --- a/SKILL.md +++ b/SKILL.md @@ -463,7 +463,7 @@ Avoiding AI patterns is only half the job. Sterile, voiceless writing is just as --- -### 25. Diff-Anchored Writing +### 30. Diff-Anchored Writing **Problem:** Writing that is overly coupled to a specific change or point-in-time diff rather than making statements that stand on their own. Unless the document is inherently version-scoped (release notes, changelogs, migration guides), documentation and comments should read coherently without knowing what changed in the last commit. From 01ba5d6a9f7c5db0786b325ae27a149e1ab7fcb2 Mon Sep 17 00:00:00 2001 From: Sunho Kim Date: Wed, 1 Apr 2026 17:44:13 +0900 Subject: [PATCH 3/5] Remove stray horizontal rule before pattern 30 Co-Authored-By: Claude Opus 4.6 (1M context) --- SKILL.md | 2 -- 1 file changed, 2 deletions(-) diff --git a/SKILL.md b/SKILL.md index de543b9..518fbd2 100644 --- a/SKILL.md +++ b/SKILL.md @@ -461,8 +461,6 @@ Avoiding AI patterns is only half the job. Sterile, voiceless writing is just as > > When users hit a slow page, they leave. ---- - ### 30. Diff-Anchored Writing **Problem:** Writing that is overly coupled to a specific change or point-in-time diff rather than making statements that stand on their own. Unless the document is inherently version-scoped (release notes, changelogs, migration guides), documentation and comments should read coherently without knowing what changed in the last commit. From 30288a9e58b9a0969c726860936b2f777195dc8c Mon Sep 17 00:00:00 2001 From: Sunho Kim Date: Wed, 1 Apr 2026 17:46:40 +0900 Subject: [PATCH 4/5] =?UTF-8?q?Version=20history:=202.6.0=20=E2=86=92=202.?= =?UTF-8?q?5.2,=20match=20existing=20format?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Opus 4.6 (1M context) --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 574baba..1934539 100644 --- a/README.md +++ b/README.md @@ -180,7 +180,7 @@ The skill also includes a final "obviously AI generated" audit pass and a second ## Version History -- **2.6.0** - Added pattern #30: diff-anchored writing (docs that narrate changes instead of describing the code) +- **2.5.2** - Added a diff-anchored writing rule, raising the total to 30 patterns - **2.5.1** - Added a passive-voice / subjectless-fragment rule, raising the total to 29 patterns - **2.5.0** - Added patterns for persuasive framing, signposting, and fragmented headers; expanded negative parallelisms to cover tailing negations; tightened wording around em dash overuse; fixed frontmatter wording to use "filler phrases" - **2.4.0** - Added voice calibration: match the user's personal writing style from samples From 2cf86a75de1bb761aeb5921bc4e28ad3ed6be10e Mon Sep 17 00:00:00 2001 From: Sunho Kim Date: Wed, 1 Apr 2026 17:53:15 +0900 Subject: [PATCH 5/5] Update WARP.md pattern count to 30 Co-Authored-By: Claude Opus 4.6 (1M context) --- WARP.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/WARP.md b/WARP.md index 78a5b4c..fd0e015 100644 --- a/WARP.md +++ b/WARP.md @@ -16,7 +16,7 @@ The “runtime” artifact is `SKILL.md`: Claude Code reads the YAML frontmatter - After the frontmatter is the editor prompt: the canonical, detailed pattern list with examples. - `README.md` - Installation and usage instructions. - - Contains a summarized “25 patterns” table and a short version history. + - Contains a summarized “30 patterns” table and a short version history. When changing behavior/content, treat `SKILL.md` as the source of truth, and update `README.md` to stay consistent.