patina-cli 3.11.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.patina.default.yaml +211 -0
- package/CHANGELOG.md +265 -0
- package/LICENSE +21 -0
- package/README.md +319 -0
- package/README_JA.md +254 -0
- package/README_KR.md +253 -0
- package/README_ZH.md +254 -0
- package/SKILL-MAX.md +455 -0
- package/SKILL.md +730 -0
- package/assets/brand/patina-icon.svg +9 -0
- package/assets/brand/patina-logo.svg +17 -0
- package/assets/social/patina-before-after.svg +46 -0
- package/assets/social/patina-og.svg +31 -0
- package/bin/patina.js +9 -0
- package/core/scoring.md +657 -0
- package/core/standalone-prompt.md +364 -0
- package/core/stylometry.md +754 -0
- package/core/voice.md +163 -0
- package/docs/AUTHENTICATION.md +105 -0
- package/docs/AUTHENTICATION_KR.md +105 -0
- package/docs/BRANDING.md +37 -0
- package/docs/CLI.md +80 -0
- package/docs/COMPARISON.md +38 -0
- package/docs/COOKBOOK.md +173 -0
- package/docs/DEMO.md +40 -0
- package/docs/ETHICS.md +27 -0
- package/docs/EXAMPLES.md +130 -0
- package/docs/EXAMPLES_KR.md +130 -0
- package/docs/EXIT-CODES.md +25 -0
- package/docs/FAQ.md +67 -0
- package/docs/FAQ_KR.md +65 -0
- package/docs/FLAG-PARITY.md +53 -0
- package/docs/GLOSSARY.md +123 -0
- package/docs/PATTERNS-EN.md +718 -0
- package/docs/PATTERNS-JA.md +706 -0
- package/docs/PATTERNS-KO.md +707 -0
- package/docs/PATTERNS-ZH.md +706 -0
- package/docs/PATTERNS.md +22 -0
- package/docs/ROADMAP.md +315 -0
- package/docs/audits/2026-05-deep-research.md +290 -0
- package/docs/benchmarks/detector-comparison.json +442 -0
- package/docs/benchmarks/detector-comparison.md +65 -0
- package/docs/benchmarks/latest.json +988 -0
- package/docs/benchmarks/latest.md +112 -0
- package/docs/integrations/docker.md +19 -0
- package/docs/integrations/github-action.md +59 -0
- package/docs/integrations/pre-commit.md +77 -0
- package/docs/integrations/release.md +43 -0
- package/docs/internal/HARNESS.md +14 -0
- package/docs/internal/README.md +14 -0
- package/docs/internal/WARP.md +23 -0
- package/docs/research/2025-rebaseline-plan.md +89 -0
- package/docs/research/ai-human-metrics.md +380 -0
- package/docs/social/gstack-cardnews.html +236 -0
- package/docs/social/gstack-cardnews.md +88 -0
- package/docs/social/gstack-thread.md +106 -0
- package/docs/social/patina-launch-copy.md +227 -0
- package/docs/superpowers/specs/2026-04-03-meaning-preservation-design.md +299 -0
- package/lexicon/ai-en.md +162 -0
- package/lexicon/ai-ko.md +159 -0
- package/package.json +100 -0
- package/patina-max/SKILL.md +523 -0
- package/patina-max/composite.py +457 -0
- package/patterns/en-communication.md +89 -0
- package/patterns/en-content.md +133 -0
- package/patterns/en-filler.md +113 -0
- package/patterns/en-language.md +163 -0
- package/patterns/en-structure.md +173 -0
- package/patterns/en-style.md +139 -0
- package/patterns/en-viral-hook.md +211 -0
- package/patterns/ja-communication.md +101 -0
- package/patterns/ja-content.md +153 -0
- package/patterns/ja-filler.md +123 -0
- package/patterns/ja-language.md +190 -0
- package/patterns/ja-structure.md +142 -0
- package/patterns/ja-style.md +147 -0
- package/patterns/ja-viral-hook.md +216 -0
- package/patterns/ko-communication.md +98 -0
- package/patterns/ko-content.md +154 -0
- package/patterns/ko-filler.md +105 -0
- package/patterns/ko-language.md +182 -0
- package/patterns/ko-structure.md +147 -0
- package/patterns/ko-style.md +146 -0
- package/patterns/ko-viral-hook.md +211 -0
- package/patterns/zh-communication.md +101 -0
- package/patterns/zh-content.md +153 -0
- package/patterns/zh-filler.md +118 -0
- package/patterns/zh-language.md +173 -0
- package/patterns/zh-structure.md +145 -0
- package/patterns/zh-style.md +159 -0
- package/patterns/zh-viral-hook.md +216 -0
- package/profiles/academic.md +53 -0
- package/profiles/blog.md +81 -0
- package/profiles/casual-conversation.md +105 -0
- package/profiles/code-comment.md +104 -0
- package/profiles/commit-message.md +99 -0
- package/profiles/default.md +62 -0
- package/profiles/email.md +52 -0
- package/profiles/formal.md +98 -0
- package/profiles/instructional.md +80 -0
- package/profiles/legal.md +57 -0
- package/profiles/marketing.md +56 -0
- package/profiles/medical.md +53 -0
- package/profiles/narrative.md +79 -0
- package/profiles/release-notes.md +98 -0
- package/profiles/social.md +56 -0
- package/profiles/technical.md +53 -0
- package/scripts/benchmark-report.mjs +252 -0
- package/scripts/check-release-metadata.mjs +48 -0
- package/scripts/detector-comparison.mjs +267 -0
- package/scripts/lint.mjs +40 -0
- package/scripts/precommit-score.mjs +31 -0
- package/scripts/prose-score.mjs +186 -0
- package/scripts/update-benchmark-ranges.mjs +108 -0
- package/src/api.js +330 -0
- package/src/auth.js +105 -0
- package/src/backends/claude-cli.js +112 -0
- package/src/backends/codex-cli.js +121 -0
- package/src/backends/contract.js +21 -0
- package/src/backends/gemini-cli.js +135 -0
- package/src/backends/index.js +159 -0
- package/src/cache.js +106 -0
- package/src/cli.js +1280 -0
- package/src/commands/doctor.js +229 -0
- package/src/commands/init.js +208 -0
- package/src/config.js +126 -0
- package/src/errors.js +53 -0
- package/src/features/index.js +96 -0
- package/src/features/lexicon.js +90 -0
- package/src/features/segment.js +49 -0
- package/src/features/stylometry.js +50 -0
- package/src/loader.js +103 -0
- package/src/logger.js +70 -0
- package/src/manifest.js +162 -0
- package/src/max-mode.js +207 -0
- package/src/ouroboros.js +233 -0
- package/src/output.js +480 -0
- package/src/prompt-builder.js +409 -0
- package/src/providers.js +100 -0
- package/src/scoring.js +531 -0
- package/src/security.js +133 -0
- package/tests/fixtures/suspect-zones/en/ai/en-ai-01.md +16 -0
- package/tests/fixtures/suspect-zones/en/ai/en-ai-02.md +16 -0
- package/tests/fixtures/suspect-zones/en/ai/en-ai-03.md +17 -0
- package/tests/fixtures/suspect-zones/en/ai/en-ai-04.md +15 -0
- package/tests/fixtures/suspect-zones/en/ai/en-ai-05.md +16 -0
- package/tests/fixtures/suspect-zones/en/ai/en-ai-06-chat-register.md +16 -0
- package/tests/fixtures/suspect-zones/en/natural/en-nat-01.md +15 -0
- package/tests/fixtures/suspect-zones/en/natural/en-nat-02.md +15 -0
- package/tests/fixtures/suspect-zones/en/natural/en-nat-03.md +15 -0
- package/tests/fixtures/suspect-zones/en/natural/en-nat-04.md +15 -0
- package/tests/fixtures/suspect-zones/en/natural/en-nat-05.md +15 -0
- package/tests/fixtures/suspect-zones/expected-ranges.json +939 -0
- package/tests/fixtures/suspect-zones/ja/ai/ja-ai-01.md +11 -0
- package/tests/fixtures/suspect-zones/ja/ai/ja-ai-02.md +11 -0
- package/tests/fixtures/suspect-zones/ja/ai/ja-ai-03.md +11 -0
- package/tests/fixtures/suspect-zones/ja/natural/ja-nat-01.md +11 -0
- package/tests/fixtures/suspect-zones/ja/natural/ja-nat-02.md +11 -0
- package/tests/fixtures/suspect-zones/ja/natural/ja-nat-03.md +11 -0
- package/tests/fixtures/suspect-zones/ko/ai/ko-ai-01.md +14 -0
- package/tests/fixtures/suspect-zones/ko/ai/ko-ai-02.md +16 -0
- package/tests/fixtures/suspect-zones/ko/ai/ko-ai-03.md +15 -0
- package/tests/fixtures/suspect-zones/ko/ai/ko-ai-04.md +15 -0
- package/tests/fixtures/suspect-zones/ko/ai/ko-ai-05.md +16 -0
- package/tests/fixtures/suspect-zones/ko/ai/ko-ai-06-chat-register.md +16 -0
- package/tests/fixtures/suspect-zones/ko/natural/ko-nat-01.md +15 -0
- package/tests/fixtures/suspect-zones/ko/natural/ko-nat-02.md +15 -0
- package/tests/fixtures/suspect-zones/ko/natural/ko-nat-03.md +15 -0
- package/tests/fixtures/suspect-zones/ko/natural/ko-nat-04.md +14 -0
- package/tests/fixtures/suspect-zones/ko/natural/ko-nat-05.md +15 -0
- package/tests/fixtures/suspect-zones/zh/ai/zh-ai-01.md +11 -0
- package/tests/fixtures/suspect-zones/zh/ai/zh-ai-02.md +11 -0
- package/tests/fixtures/suspect-zones/zh/ai/zh-ai-03.md +11 -0
- package/tests/fixtures/suspect-zones/zh/natural/zh-nat-01.md +11 -0
- package/tests/fixtures/suspect-zones/zh/natural/zh-nat-02.md +11 -0
- package/tests/fixtures/suspect-zones/zh/natural/zh-nat-03.md +11 -0
- package/tests/quality/README.md +121 -0
- package/tests/quality/benchmark.mjs +306 -0
- package/tests/quality/detectors.manual.example.json +31 -0
- package/tests/quality/dogfood.mjs +44 -0
|
@@ -0,0 +1,113 @@
|
|
|
1
|
+
---
|
|
2
|
+
pack: en-filler
|
|
3
|
+
language: en
|
|
4
|
+
name: Filler & Hedging Patterns
|
|
5
|
+
version: 1.1.0
|
|
6
|
+
patterns: 4
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
# Filler & Hedging Patterns
|
|
10
|
+
|
|
11
|
+
### 22. Filler Phrases
|
|
12
|
+
|
|
13
|
+
**Watch words:** it's important to note that, it's worth mentioning that, it should be noted that, in order to, due to the fact that, at the end of the day, when it comes to, in terms of, the fact of the matter is, it goes without saying, needless to say, as a matter of fact, for all intents and purposes, in light of the fact that
|
|
14
|
+
|
|
15
|
+
**Fire condition:** 2+ filler phrases appear in the same paragraph, or a single phrase that can be deleted without any loss of meaning.
|
|
16
|
+
|
|
17
|
+
**Exclusion:** "In order to" is occasionally necessary for clarity in legal or formal regulatory writing where "to" could be misread as part of an infinitive chain. Use judgment in those contexts.
|
|
18
|
+
|
|
19
|
+
**Problem:** AI pads sentences with unnecessary filler that adds length but no meaning. These phrases can almost always be deleted or replaced with a shorter alternative.
|
|
20
|
+
|
|
21
|
+
**Semantic Risk:** LOW
|
|
22
|
+
|
|
23
|
+
**Substitutions:**
|
|
24
|
+
- "it's important to note that" --> delete, just state the fact
|
|
25
|
+
- "in order to" --> "to"
|
|
26
|
+
- "due to the fact that" --> "because"
|
|
27
|
+
- "at the end of the day" --> delete or rephrase
|
|
28
|
+
- "when it comes to" --> delete or use the subject directly
|
|
29
|
+
- "in terms of" --> delete or rephrase
|
|
30
|
+
- "in light of the fact that" --> "because" or "since"
|
|
31
|
+
|
|
32
|
+
**Before:**
|
|
33
|
+
> It's important to note that, in order to achieve sustainable growth, companies need to invest in R&D. Due to the fact that competition is increasing, it's worth mentioning that firms must also focus on talent retention. At the end of the day, when it comes to long-term success, innovation is key.
|
|
34
|
+
|
|
35
|
+
**After:**
|
|
36
|
+
> Companies that want to grow need to invest in R&D. Competition for talent is rising just as fast — Gartner reports that tech attrition hit 20% last year.
|
|
37
|
+
|
|
38
|
+
---
|
|
39
|
+
|
|
40
|
+
### 23. Excessive Hedging
|
|
41
|
+
|
|
42
|
+
**Watch words:** it could potentially be argued that perhaps, may or may not, it is possible that, to some extent, in certain cases, it could be said that, there is a chance that, one might argue, it seems likely that, arguably, it is conceivable that, tends to suggest
|
|
43
|
+
|
|
44
|
+
**Fire condition:** 3+ qualifiers stacked on a single claim, or a statement so hedged it makes no falsifiable assertion.
|
|
45
|
+
|
|
46
|
+
**Exclusion:** A single hedge on a genuinely uncertain claim is appropriate and not this pattern ("this approach may reduce costs" when the evidence is preliminary). Only trigger when qualifiers are stacked or when the combined hedging evacuates all meaning.
|
|
47
|
+
|
|
48
|
+
**Problem:** AI over-qualifies every statement to avoid being wrong, producing text so hedged that it says almost nothing. A single hedge is fine; stacking three or four qualifiers on one claim is not.
|
|
49
|
+
|
|
50
|
+
**Semantic Risk:** MEDIUM
|
|
51
|
+
**Preservation Note:** Removing hedges from a genuinely uncertain claim may produce an over-confident assertion; ensure the corrected version retains at least one qualifier if the underlying evidence is preliminary or contested.
|
|
52
|
+
|
|
53
|
+
**Before:**
|
|
54
|
+
> It could potentially be argued that this approach may, to some extent, offer certain advantages in some cases, though it is possible that the results might vary depending on a number of factors that arguably remain to be fully understood.
|
|
55
|
+
|
|
56
|
+
**After:**
|
|
57
|
+
> This approach has advantages, but results vary. The biggest variable is team size: teams under five people saw a 30% improvement, while larger teams saw little change.
|
|
58
|
+
|
|
59
|
+
---
|
|
60
|
+
|
|
61
|
+
### 24. Generic Positive Conclusions
|
|
62
|
+
|
|
63
|
+
**Watch words:** a bright future lies ahead, exciting journey, the possibilities are endless, stands as a testament, the sky is the limit, promising outlook, exciting times ahead, the best is yet to come, transformative potential, a new chapter
|
|
64
|
+
|
|
65
|
+
**Fire condition:** 2+ vague optimism phrases appear in the same paragraph or conclusion, or a standalone final sentence that is entirely optimism filler with no specific claim.
|
|
66
|
+
|
|
67
|
+
**Exclusion:** A specific optimistic statement backed by evidence ("given the trial data, FDA approval looks likely by Q3") is not this pattern — specificity makes it acceptable.
|
|
68
|
+
|
|
69
|
+
**Problem:** AI ends with vague optimism instead of specific conclusions. This pattern often appears alongside Pattern 6 (Formulaic Challenges and Prospects) but can also stand alone as a final sentence.
|
|
70
|
+
|
|
71
|
+
**Semantic Risk:** LOW
|
|
72
|
+
|
|
73
|
+
**Before:**
|
|
74
|
+
> As the company enters this exciting new chapter, the possibilities are truly endless. With its talented team and innovative vision, a bright future undoubtedly lies ahead. The best is yet to come.
|
|
75
|
+
|
|
76
|
+
**After:**
|
|
77
|
+
> The company plans to open two more locations by June and is hiring 15 engineers for its new climate-tech division.
|
|
78
|
+
|
|
79
|
+
**Closing formula before:**
|
|
80
|
+
> In conclusion, this topic is one that will continue to generate discussion and debate for years to come. One thing is certain: the future of this field is full of promise and potential.
|
|
81
|
+
|
|
82
|
+
**Closing formula after:**
|
|
83
|
+
> The bill goes to committee vote on March 12. If it passes, the new rules take effect in January.
|
|
84
|
+
|
|
85
|
+
**Not this pattern:** The "challenges, but bright future" two-step structure --> Pattern 6 (Formulaic "Challenges and Prospects," en-content.md) handles that.
|
|
86
|
+
|
|
87
|
+
---
|
|
88
|
+
|
|
89
|
+
### 31. Conclusion Signal Words
|
|
90
|
+
|
|
91
|
+
**Watch words:** In conclusion, Ultimately, In summary, To conclude, To sum up, Finally, All in all, In the end, Overall, On the whole
|
|
92
|
+
|
|
93
|
+
**Fire condition:** The document's final paragraph (or second-to-last) opens with one of the watch words. Or 2+ such conclusion signals appear across paragraphs.
|
|
94
|
+
|
|
95
|
+
**Exclusion:**
|
|
96
|
+
- Academic papers with an explicit "Conclusion" section header (the header already signals; in-prose markers are redundant)
|
|
97
|
+
- Multi-step arguments where "Therefore" or "Thus" follows from a clear preceding chain (logic markers, not stylistic markers)
|
|
98
|
+
- Speech or lecture transcripts where the speaker explicitly signposts wrap-up
|
|
99
|
+
|
|
100
|
+
**Problem:** AI essays announce their conclusions ("In conclusion, X is Y") instead of just stating them. Human writers rarely flag the conclusion paragraph — they just write the conclusion. AI feels obligated to scaffold document structure for the reader.
|
|
101
|
+
|
|
102
|
+
**Semantic Risk:** LOW
|
|
103
|
+
**Preservation:** Removing only the signal word leaves a hollow paragraph. Rewrite the actual conclusion to be more concrete. The paragraph should still read as a conclusion without the marker.
|
|
104
|
+
|
|
105
|
+
**Burstiness guidance:** When removing conclusion signals, vary the replacement. Don't replace every "In conclusion, X is Y" with "X is Y, then" — that creates a new mechanical pattern. Mix short verdicts with longer explanatory wrap-ups. This pattern often co-fires with #24 (Generic Positive Conclusions); handle both together.
|
|
106
|
+
|
|
107
|
+
**Before:**
|
|
108
|
+
> In conclusion, work-life balance is not a luxury but a necessity. It is a critical foundation upon which sustainable success — both personal and professional — must be built.
|
|
109
|
+
|
|
110
|
+
**After:**
|
|
111
|
+
> Work-life balance isn't optional. Without it, the rest of the structure cracks.
|
|
112
|
+
|
|
113
|
+
**Not this pattern:** When the *content* of the conclusion is vague optimism --> Pattern 24 (Generic Positive Conclusions) handles that. Pattern 31 is about the signal *word itself* regardless of what follows.
|
|
@@ -0,0 +1,163 @@
|
|
|
1
|
+
---
|
|
2
|
+
pack: en-language
|
|
3
|
+
language: en
|
|
4
|
+
name: Language Patterns
|
|
5
|
+
version: 1.0.0
|
|
6
|
+
patterns: 7
|
|
7
|
+
dedupe-with:
|
|
8
|
+
- source: "en-language:7"
|
|
9
|
+
target: "en-filler:24"
|
|
10
|
+
owner: "en-filler:24"
|
|
11
|
+
reason: "The phrase 'stands as a testament' belongs to filler #24; language #7 keeps 'testament' only as one word in a broader AI-vocabulary cluster."
|
|
12
|
+
- source: "en-language:7"
|
|
13
|
+
target: "en-language:8"
|
|
14
|
+
owner: "en-language:8"
|
|
15
|
+
reason: "When 'testament' appears inside a copula-avoidance construction, pattern #8 owns the rewrite; pattern #7 only fires on a broader AI-vocabulary cluster."
|
|
16
|
+
- source: "en-language:8"
|
|
17
|
+
target: "en-filler:24"
|
|
18
|
+
owner: "en-filler:24"
|
|
19
|
+
reason: "The exact phrase 'stands as a testament' is a generic positive-conclusion marker when used as vague praise; pattern #8 still owns non-conclusion copula avoidance such as 'serves as'."
|
|
20
|
+
---
|
|
21
|
+
|
|
22
|
+
# Language Patterns
|
|
23
|
+
|
|
24
|
+
### 7. AI Vocabulary Words
|
|
25
|
+
|
|
26
|
+
**Watch words:** delve, tapestry, landscape, multifaceted, comprehensive, pivotal, testament, intricate, nuanced, leverage, foster, crucial, moreover, furthermore, realm, robust, facilitate, endeavor, resonate, underscore, embark, myriad, paramount, encompass, holistic, synergy, elucidate, culminate, juxtapose, burgeoning
|
|
27
|
+
|
|
28
|
+
**Fire condition:** 3+ watch words appear in one paragraph.
|
|
29
|
+
|
|
30
|
+
**Semantic Risk:** MEDIUM
|
|
31
|
+
**Preservation Note:** Replacing AI vocabulary words changes the specific connotations carried by words like "nuanced" or "multifaceted"; ensure the substituted terms preserve the intended meaning and register.
|
|
32
|
+
|
|
33
|
+
**Problem:** These words appear at dramatically higher rates in AI-generated text than in human writing. Individually they are normal English words; clustered together they are a telltale fingerprint.
|
|
34
|
+
|
|
35
|
+
**Before:**
|
|
36
|
+
> This comprehensive report delves into the multifaceted landscape of renewable energy, leveraging nuanced insights to foster a robust understanding. Moreover, the intricate tapestry of stakeholder interests underscores the pivotal role of policy in this crucial endeavor.
|
|
37
|
+
|
|
38
|
+
**After:**
|
|
39
|
+
> This report covers renewable energy policy from three angles: cost, grid reliability, and public opinion. Each section uses data from the EIA and interviews with six state utility commissioners.
|
|
40
|
+
|
|
41
|
+
---
|
|
42
|
+
|
|
43
|
+
### 8. Copula Avoidance ("serves as")
|
|
44
|
+
|
|
45
|
+
**Watch words:** serves as, acts as, functions as, stands as, operates as, works as, remains as, exists as
|
|
46
|
+
|
|
47
|
+
**Fire condition:** 2+ copula-avoidance constructions in the same paragraph, or a single instance where "is" would be shorter and clearer.
|
|
48
|
+
|
|
49
|
+
**Exclusion:** "Serves as" is acceptable when the subject has a formally designated role function (e.g., "the committee serves as an advisory board" — institutional role, not decorative usage).
|
|
50
|
+
|
|
51
|
+
**Semantic Risk:** MEDIUM
|
|
52
|
+
**Preservation Note:** "Serves as" sometimes implies a functional or designated role distinct from mere identity; replacing with "is" may flatten a meaningful distinction about purpose or function.
|
|
53
|
+
|
|
54
|
+
**Problem:** AI avoids the simple verb "is" by using unnecessarily complex copula constructions. "The park serves as a gathering place" instead of "The park is a gathering place."
|
|
55
|
+
|
|
56
|
+
**Before:**
|
|
57
|
+
> The library serves as a vital community hub, functioning as both an educational resource and a social gathering space. It also acts as a testament to the city's commitment to public access.
|
|
58
|
+
|
|
59
|
+
**After:**
|
|
60
|
+
> The library is the neighborhood's main public space. People use it for study groups, ESL classes, and the Saturday morning story hour, which draws about 40 kids a week.
|
|
61
|
+
|
|
62
|
+
---
|
|
63
|
+
|
|
64
|
+
### 9. Negative Parallelisms
|
|
65
|
+
|
|
66
|
+
**Watch words:** not just...but, not merely...but also, not only...but, goes beyond...to, more than just...it is, transcends...to become
|
|
67
|
+
|
|
68
|
+
**Fire condition:** 2+ "not X but Y" structures in the same document, or a single instance where the positive statement alone would be simpler and equally clear.
|
|
69
|
+
|
|
70
|
+
**Exclusion:** Genuine contrastive clarification correcting a misconception ("the event is not a conference but a workshop — no keynotes, only hands-on sessions") — the negative frame is doing real work here.
|
|
71
|
+
|
|
72
|
+
**Semantic Risk:** MEDIUM
|
|
73
|
+
**Preservation Note:** The negative framing sometimes carries a genuine contrast or correction; collapsing "not X but Y" to just "Y" may lose the implicit rejection of a common assumption the author intended to address.
|
|
74
|
+
|
|
75
|
+
**Problem:** AI uses negative-then-positive constructions to make simple points sound profound. Instead of stating what something is, it first states what it is not.
|
|
76
|
+
|
|
77
|
+
**Before:**
|
|
78
|
+
> This initiative is not just a policy change but a fundamental reimagining of urban planning. It goes beyond mere infrastructure investment to become a statement about the kind of city residents want to live in.
|
|
79
|
+
|
|
80
|
+
**After:**
|
|
81
|
+
> The initiative rezones 12 blocks for mixed-use development and adds a bike lane network connecting the east and west sides of the river.
|
|
82
|
+
|
|
83
|
+
---
|
|
84
|
+
|
|
85
|
+
### 10. Rule of Three Overuse
|
|
86
|
+
|
|
87
|
+
**Fire condition:** 3-item lists appear 2+ times in the same document, or a triple-part sentence where the count is arbitrary and another count would be equally valid.
|
|
88
|
+
|
|
89
|
+
**Exclusion:** Naturally occurring triads in genuinely three-part processes (past/present/future; input/process/output; beginning/middle/end) are not this pattern.
|
|
90
|
+
|
|
91
|
+
**Burstiness note:** When rewriting, use the naturally correct count — one strong point if that is all there is, two contrasting items if that is the real structure, four if there are actually four. Varying list counts across a document signals human authorship.
|
|
92
|
+
|
|
93
|
+
**Problem:** AI defaults to triple-item lists and three-part structures when the natural count might be two, four, or one. This creates a rhythm that feels rehearsed rather than spontaneous.
|
|
94
|
+
|
|
95
|
+
**Semantic Risk:** LOW
|
|
96
|
+
|
|
97
|
+
**Before:**
|
|
98
|
+
> The program fosters creativity, innovation, and collaboration. Participants gain inspiration, practical skills, and lasting connections. The result is a more dynamic, inclusive, and forward-thinking community.
|
|
99
|
+
|
|
100
|
+
**After:**
|
|
101
|
+
> The program pairs early-career designers with experienced mentors for a 10-week project. Last year's cohort produced two apps that are still in active use.
|
|
102
|
+
|
|
103
|
+
---
|
|
104
|
+
|
|
105
|
+
### 11. Elegant Variation (Synonym Cycling)
|
|
106
|
+
|
|
107
|
+
**Fire condition:** The same entity referred to by 3+ different names or synonyms within a single paragraph.
|
|
108
|
+
|
|
109
|
+
**Exclusion:** Legitimate disambiguation (using "the company" vs. "Microsoft" when distinguishing a parent from a subsidiary, or "the study" vs. "the 2023 Stanford paper" for precision) is not this pattern.
|
|
110
|
+
|
|
111
|
+
**Problem:** AI rotates synonyms for the same entity to avoid repeating a word, producing text that feels strangely evasive. A city becomes "the metropolis," then "the urban center," then "the municipality" — all within the same paragraph.
|
|
112
|
+
|
|
113
|
+
**Semantic Risk:** LOW
|
|
114
|
+
|
|
115
|
+
**Before:**
|
|
116
|
+
> Tokyo is the most populous city in Japan. The metropolis is known for its blend of tradition and modernity. The urban center attracts millions of tourists each year. The Japanese capital continues to grow.
|
|
117
|
+
|
|
118
|
+
**After:**
|
|
119
|
+
> Tokyo is the most populous city in Japan, with about 14 million residents. It draws roughly 20 million foreign tourists a year, a number that has doubled since 2015.
|
|
120
|
+
|
|
121
|
+
---
|
|
122
|
+
|
|
123
|
+
### 12. False Ranges
|
|
124
|
+
|
|
125
|
+
**Watch words:** from X to Y, ranging from...to, spanning...to, everything from...to, whether...or
|
|
126
|
+
|
|
127
|
+
**Fire condition:** A "from X to Y" construction appears where the two poles do not meaningfully bound a spectrum — the range is decorative rather than informative.
|
|
128
|
+
|
|
129
|
+
**Exclusion:** Genuine numeric or temporal ranges ("from 10 to 100 employees", "from January to March", "from $5 to $50") are not this pattern.
|
|
130
|
+
|
|
131
|
+
**Problem:** AI creates artificial ranges to sound comprehensive, often pairing two extremes that do not meaningfully define a spectrum.
|
|
132
|
+
|
|
133
|
+
**Semantic Risk:** MEDIUM
|
|
134
|
+
**Preservation Note:** Removing a range construction may drop a genuine scope claim about audience or coverage; verify whether the range was intended to convey actual breadth before eliminating it.
|
|
135
|
+
|
|
136
|
+
**Before:**
|
|
137
|
+
> The festival offers something for everyone, from young children to seasoned professionals, spanning everything from traditional folk music to cutting-edge electronic performances.
|
|
138
|
+
|
|
139
|
+
**After:**
|
|
140
|
+
> The festival has three stages. The main stage books established acts (this year: Yo-Yo Ma, Thundercat). The tent stage is for local bands. There is also a children's area with instrument demos.
|
|
141
|
+
|
|
142
|
+
---
|
|
143
|
+
|
|
144
|
+
### 32. Comparison Adverb Overuse ("more" without target)
|
|
145
|
+
|
|
146
|
+
**Watch words:** more specific, more concrete, more efficient, more effective, more comprehensive, more robust, more seamless, more meaningful, more strategic, more impactful, more nuanced, more proactive, more sustainable, more scalable
|
|
147
|
+
|
|
148
|
+
**Fire condition:** 2+ "more + adjective/adverb" comparative phrases appear in one document without a clear target, baseline, or metric. A single instance can fire when it appears in the same paragraph as other formal AI markers such as "comprehensive", "strategic", "framework", "stakeholder", or "in-depth".
|
|
149
|
+
|
|
150
|
+
**Exclusion:** Do not fire when the comparison target is explicit ("more efficient than the old process"), when a before/after metric is provided ("reduced latency from 240 ms to 130 ms"), in ordinary quantifiers ("more than 10 users"), or in fixed phrases such as "more or less".
|
|
151
|
+
|
|
152
|
+
**Semantic Risk:** LOW
|
|
153
|
+
**Preservation Note:** Comparative language can carry a real improvement claim. Preserve the target, metric, or priority if one exists; otherwise replace the vague comparative with the concrete requirement or result the sentence is trying to name.
|
|
154
|
+
|
|
155
|
+
**Problem:** AI text often implies progress by stacking "more X" phrases while never saying compared with what. Human prose either names the baseline ("faster than last quarter's build") or drops the decorative comparison and states the concrete change.
|
|
156
|
+
|
|
157
|
+
**Burstiness note:** Do not convert every "more X" phrase into the same alternative. Mix direct adjectives, named metrics, shorter verbs, and one retained comparative when the contrast is real.
|
|
158
|
+
|
|
159
|
+
**Before:**
|
|
160
|
+
> The initiative will enable more specific milestones, more efficient resource allocation, and more comprehensive stakeholder alignment. Moving forward, the team should develop a more strategic framework for more meaningful collaboration.
|
|
161
|
+
|
|
162
|
+
**After:**
|
|
163
|
+
> The initiative needs dated milestones, named owners, and a budget review. The team also needs one shared plan for partner handoffs, because the current spreadsheet has three conflicting owners for the same launch tasks.
|
|
@@ -0,0 +1,173 @@
|
|
|
1
|
+
---
|
|
2
|
+
pack: en-structure
|
|
3
|
+
language: en
|
|
4
|
+
name: Structure Patterns
|
|
5
|
+
version: 1.2.0
|
|
6
|
+
patterns: 5
|
|
7
|
+
phase: structure
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
# Structure Patterns
|
|
11
|
+
|
|
12
|
+
---
|
|
13
|
+
|
|
14
|
+
### 25. Metronomic Paragraph Structure
|
|
15
|
+
|
|
16
|
+
**Fire condition:** 3+ consecutive paragraphs follow the identical internal template — e.g., claim → evidence → significance, or problem → solution → benefit, or intro → development → conclusion.
|
|
17
|
+
|
|
18
|
+
**Exclusion:** Academic abstracts, legal briefs, and comparative reviews (product A vs. product B on the same criteria) where the repeated structure is the required format, not an AI artifact. Also exclude texts with 2 or fewer paragraphs.
|
|
19
|
+
|
|
20
|
+
**Burstiness note:** After breaking the structure, vary paragraph function deliberately. Some paragraphs should present pure evidence with no stated implication. Some should be a single-sentence observation. Some should open with a question, a contradiction, or a concrete detail rather than a topic claim.
|
|
21
|
+
|
|
22
|
+
**Problem:** AI stamps every paragraph with the same internal template regardless of what the content actually requires. Human writing varies paragraph shape: some paragraphs open with a question, some lead with a specific detail, some end without resolving anything. Metronomic regularity is one of the strongest structural signals of AI generation.
|
|
23
|
+
|
|
24
|
+
**Semantic Risk:** MEDIUM
|
|
25
|
+
**Preservation Note:** Restructuring paragraph order or shape may alter the logical flow of an argument; verify that each paragraph's core claim survives the restructuring and that no evidence is dropped.
|
|
26
|
+
|
|
27
|
+
**Before:**
|
|
28
|
+
> The electric vehicle market has experienced unprecedented growth in recent years. Sales doubled between 2021 and 2023, driven by falling battery costs and expanded charging infrastructure. This trend signals a fundamental shift in how consumers relate to personal transportation.
|
|
29
|
+
>
|
|
30
|
+
> Battery technology has improved considerably over the same period. Energy density has increased by 40% since 2018, while costs have fallen from $140 to $90 per kWh. These advances have made electric vehicles competitive with internal combustion alternatives on a total cost of ownership basis.
|
|
31
|
+
>
|
|
32
|
+
> Government policy has played a significant supporting role. Tax credits of up to $7,500 are available in the United States, and the EU has mandated a ban on new petrol vehicle sales by 2035. Such regulatory tailwinds are expected to sustain the sector's momentum into the next decade.
|
|
33
|
+
|
|
34
|
+
**After:**
|
|
35
|
+
> Electric vehicle sales doubled between 2021 and 2023. The main driver isn't policy — it's battery prices, which fell from $140 to $90 per kWh.
|
|
36
|
+
>
|
|
37
|
+
> The US $7,500 tax credit helps, but it phases out once a manufacturer hits 200,000 vehicles sold. Tesla already passed that cap years ago.
|
|
38
|
+
>
|
|
39
|
+
> Whether the EU's 2035 petrol ban survives is genuinely unclear. Germany's coalition nearly collapsed over it in 2023, and three major automakers are lobbying for a 2040 date instead.
|
|
40
|
+
|
|
41
|
+
---
|
|
42
|
+
|
|
43
|
+
### 26. Passive Nominalization Chains
|
|
44
|
+
|
|
45
|
+
**Watch words:** was conducted, was performed, was developed, was established, were identified, is required, has been shown, is provided, are considered, is achieved, is determined, is utilized, is noted
|
|
46
|
+
|
|
47
|
+
**Fire condition:** 2+ passive nominalization phrases in the same paragraph — e.g., "an analysis was conducted", "consideration was given to", "a decision was made".
|
|
48
|
+
|
|
49
|
+
**Exclusion:** Scientific methods sections and formal regulatory documents where passive voice is a disciplinary norm. Also acceptable when the actor is genuinely unknown, irrelevant, or appropriately omitted.
|
|
50
|
+
|
|
51
|
+
**Burstiness note:** Replace passives with active verbs — but vary the subjects. Avoid making every sentence "We did X." Mix "The team found Y" with "Data showed Z" with bare declaratives that start with the finding itself.
|
|
52
|
+
|
|
53
|
+
**Problem:** AI chains passive nominalizations that convert active situations into abstract bureaucratic prose. "An analysis was conducted" means "we analyzed." The passive form removes agency and adds syllables without adding meaning.
|
|
54
|
+
|
|
55
|
+
**Semantic Risk:** MEDIUM
|
|
56
|
+
**Preservation Note:** Converting passive to active assigns a specific agent; if the original intentionally omitted the actor (unknown, irrelevant, or sensitive), the active rewrite may introduce an unintended attribution.
|
|
57
|
+
|
|
58
|
+
**Before:**
|
|
59
|
+
> An extensive review of the literature was conducted in order to identify key patterns. Consideration was given to a range of methodological approaches, and a decision was made to adopt a mixed-methods design. Data collection was performed over a six-month period, after which an analysis was undertaken to identify recurring themes.
|
|
60
|
+
|
|
61
|
+
**After:**
|
|
62
|
+
> We reviewed 47 papers published between 2018 and 2024. Most used surveys; we chose interviews instead, since the population was small enough to go deep. Six months of interviews, then we coded the transcripts.
|
|
63
|
+
|
|
64
|
+
---
|
|
65
|
+
|
|
66
|
+
### 27. Zombie Nouns (Excessive Nominalization)
|
|
67
|
+
|
|
68
|
+
**Watch words:** make an improvement to, provide a description of, conduct an analysis of, give consideration to, offer an explanation of, achieve a reduction in, have an impact on, make a decision about, reach a conclusion regarding, perform an evaluation of, carry out an investigation into, give an indication of
|
|
69
|
+
|
|
70
|
+
**Fire condition:** 3+ nominalized verb phrases in the same paragraph — e.g., "make improvements" instead of "improve", "conduct an analysis" instead of "analyze".
|
|
71
|
+
|
|
72
|
+
**Exclusion:** Noun forms that carry meaning unavailable in the verb ("the investigation" as a noun refers to an ongoing process; "investigate" does not). Also acceptable in legal contexts where nominalized forms have specific technical definitions.
|
|
73
|
+
|
|
74
|
+
**Burstiness note:** Replace nominalized phrases with verbs, but not every instance. Keep one or two where the noun form fits naturally — avoid creating staccato prose by over-correcting.
|
|
75
|
+
|
|
76
|
+
**Problem:** AI converts verbs into bloated noun phrases, a pattern called "zombie nouns." Every action becomes an abstract event: "improve" becomes "make an improvement to," "analyze" becomes "conduct an analysis of." The result is wordy, impersonal, and slow.
|
|
77
|
+
|
|
78
|
+
**Semantic Risk:** MEDIUM
|
|
79
|
+
**Preservation Note:** Some nominalized forms carry distinct meaning from their verb counterparts ("the investigation" vs. "investigate"); verify that converting to a verb does not collapse a reference to an ongoing process or formal procedure.
|
|
80
|
+
|
|
81
|
+
**Before:**
|
|
82
|
+
> The committee made a decision to conduct an analysis of the current situation and to provide a recommendation regarding future strategy. An evaluation of the available options was performed, and after careful consideration was given to each alternative, an agreement was reached on the most viable approach.
|
|
83
|
+
|
|
84
|
+
**After:**
|
|
85
|
+
> The committee analyzed the situation and agreed on a strategy. They evaluated three options and chose the one with the lowest implementation risk.
|
|
86
|
+
|
|
87
|
+
---
|
|
88
|
+
|
|
89
|
+
### 28. Stacked Subordinate Clauses
|
|
90
|
+
|
|
91
|
+
**Fire condition:** A single sentence contains 3+ embedded relative clauses, appositives, or participial phrases before the main verb reaches its object — or the reader must parse 4+ commas before understanding the sentence's main claim.
|
|
92
|
+
|
|
93
|
+
**Exclusion:** Legal definitions and technical specifications occasionally require nested qualification. Academic writing may also stack clauses when the embedded information is non-negotiable to the sentence's meaning and cannot be separated without losing precision.
|
|
94
|
+
|
|
95
|
+
**Burstiness note:** Break stacked sentences into two or three shorter ones. Start one sentence with the main clause, then add a separate sentence for the embedded detail. Vary lengths — don't make every resulting sentence the same.
|
|
96
|
+
|
|
97
|
+
**Problem:** AI builds sentences with cascading embedded clauses that delay the main verb and obscure the subject-verb relationship. The result is technically grammatical but exhausting to read and often contains no insight beyond what a shorter sentence would convey.
|
|
98
|
+
|
|
99
|
+
**Semantic Risk:** MEDIUM
|
|
100
|
+
**Preservation Note:** Breaking stacked clauses into separate sentences may lose precision embedded in the nested qualifications; ensure every embedded condition or qualification appears in the rewritten version.
|
|
101
|
+
|
|
102
|
+
**Before:**
|
|
103
|
+
> The initiative, which was developed in response to increasing concerns about, and growing awareness of, the urgent need to address the challenges facing both urban and rural communities in the context of rapid technological transformation, aims to bridge the gap between innovation and equitable access.
|
|
104
|
+
|
|
105
|
+
**After:**
|
|
106
|
+
> Rural and urban communities are getting left behind as technology changes fast. The initiative targets that gap directly — access to tools, not just the tools themselves.
|
|
107
|
+
|
|
108
|
+
---
|
|
109
|
+
|
|
110
|
+
### 30. Rhetorical Question Openers
|
|
111
|
+
|
|
112
|
+
**Problem:** AI essays open paragraphs with rhetorical questions ("So what does this mean?", "Why is this important?", "But how did we get here?") to scaffold structure. The writer already knows the answer; the question is filler that buys time before the actual claim. Real writers state observations directly. Rhetorical questions belong in speeches and editorials, not in informational essays.
|
|
113
|
+
|
|
114
|
+
**Trigger conditions:** A paragraph opens with an interrogative sentence ("Why...?", "How...?", "What...?", "But what if...?") AND the answer follows in the same or next sentence within the same paragraph. Or: the document contains 2+ rhetorical questions used as paragraph openers across paragraphs.
|
|
115
|
+
|
|
116
|
+
**Exceptions:**
|
|
117
|
+
- Interview, FAQ, or Q&A format documents
|
|
118
|
+
- Genuine open questions where the author truly doesn't know the answer (research questions, philosophical inquiry)
|
|
119
|
+
- Speech or lecture transcripts where audience engagement is the goal
|
|
120
|
+
- Academic papers' research question sections
|
|
121
|
+
|
|
122
|
+
**Semantic risk:** LOW
|
|
123
|
+
**Preservation:** Distinguish structural filler from genuinely emphatic questioning. If converting to declarative, verify the new sentence still carries the original emphasis.
|
|
124
|
+
|
|
125
|
+
**Burstiness guidance:** When converting rhetorical questions to declaratives, vary the result. Don't replace every "Why X?" with "X is because Y" — that just substitutes one mechanical pattern for another. Mix short emphatic statements with longer explanatory clauses.
|
|
126
|
+
|
|
127
|
+
**Before:**
|
|
128
|
+
> So why did Korean coffee culture grow so fast? The answer is surprisingly simple. Cafés moved beyond being places to buy drinks and became social hubs.
|
|
129
|
+
>
|
|
130
|
+
> But what about the future? Experts believe the trend will continue.
|
|
131
|
+
|
|
132
|
+
**After:**
|
|
133
|
+
> Korean coffee culture grew fast for a surprisingly simple reason: cafés moved beyond being places to buy drinks and became social hubs.
|
|
134
|
+
>
|
|
135
|
+
> The trend is likely to continue. Experts agree.
|
|
136
|
+
|
|
137
|
+
---
|
|
138
|
+
|
|
139
|
+
## English Burstiness Guidelines
|
|
140
|
+
|
|
141
|
+
Even without dedicated structure patterns, apply these burstiness principles when rewriting English text in Phase 1 (structure pass) or Phase 2 (sentence/lexical pass):
|
|
142
|
+
|
|
143
|
+
#### What is burstiness?
|
|
144
|
+
|
|
145
|
+
Human writing varies sentence length and structure unpredictably. AI writing is uniform: similar sentence length, consistent clause structure, even paragraph size. Burstiness means introducing deliberate irregularity.
|
|
146
|
+
|
|
147
|
+
#### How to apply
|
|
148
|
+
|
|
149
|
+
**Sentence length variation:**
|
|
150
|
+
- Mix short punchy sentences (4–8 words) with longer ones (20–35 words).
|
|
151
|
+
- A paragraph that opens with a one-sentence fragment and then unpacks in the next sentence reads as human.
|
|
152
|
+
- Avoid stretches of 4+ consecutive sentences with similar length.
|
|
153
|
+
|
|
154
|
+
**Paragraph length variation:**
|
|
155
|
+
- Paragraphs do not need to be 3–5 sentences. A single-sentence paragraph is fine for emphasis.
|
|
156
|
+
- Vary: short/long/medium, not medium/medium/medium.
|
|
157
|
+
|
|
158
|
+
**List count variation:**
|
|
159
|
+
- Do not default to 3-item lists. Use 2 items if there are 2, or 4 if there are 4.
|
|
160
|
+
- See Pattern #10 (Rule of Three) for correction details.
|
|
161
|
+
|
|
162
|
+
**Structure variation:**
|
|
163
|
+
- Mix declarative sentences, rhetorical questions, and sentence fragments.
|
|
164
|
+
- Not every sentence needs a subject-verb-object structure.
|
|
165
|
+
|
|
166
|
+
#### When to apply
|
|
167
|
+
|
|
168
|
+
Apply burstiness corrections when:
|
|
169
|
+
- All paragraphs are approximately the same length.
|
|
170
|
+
- Most sentences follow the same syntactic pattern (Subject + Verb + Object + subordinate clause).
|
|
171
|
+
- The overall rhythm feels metronomic (consistently even pacing).
|
|
172
|
+
|
|
173
|
+
Do **not** manufacture burstiness if the source text is already varied. Check before correcting.
|
|
@@ -0,0 +1,139 @@
|
|
|
1
|
+
---
|
|
2
|
+
pack: en-style
|
|
3
|
+
language: en
|
|
4
|
+
name: Style Patterns
|
|
5
|
+
version: 1.0.0
|
|
6
|
+
patterns: 6
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
# Style Patterns
|
|
10
|
+
|
|
11
|
+
### 13. Em Dash Overuse
|
|
12
|
+
|
|
13
|
+
**Fire condition:** 3+ em dashes appear in a single text.
|
|
14
|
+
|
|
15
|
+
**Exclusion:** A single em dash for a sharp parenthetical or abrupt sentence break is stylistically valid in informal or literary writing. Only trigger on clusters.
|
|
16
|
+
|
|
17
|
+
**Burstiness note:** When rewriting em-dash-heavy sentences, vary the alternatives — use commas for some, parentheses for others, or break into separate sentences. Uniform substitution (replacing every em dash with a comma) produces a new kind of rhythm problem.
|
|
18
|
+
|
|
19
|
+
**Problem:** AI uses em dashes for emphasis, parenthetical asides, and clause breaks far more frequently than human writers. A text peppered with em dashes reads as distinctly AI-generated.
|
|
20
|
+
|
|
21
|
+
**Semantic Risk:** LOW
|
|
22
|
+
|
|
23
|
+
**Before:**
|
|
24
|
+
> The new policy — which was announced last Tuesday — aims to address a long-standing issue — affordable housing. Critics — including several council members — argue that the plan lacks specifics — a concern that the mayor dismissed as premature.
|
|
25
|
+
|
|
26
|
+
**After:**
|
|
27
|
+
> The new policy, announced last Tuesday, aims to address affordable housing. Several council members say the plan lacks specifics. The mayor called the criticism premature.
|
|
28
|
+
|
|
29
|
+
---
|
|
30
|
+
|
|
31
|
+
### 14. Boldface Overuse
|
|
32
|
+
|
|
33
|
+
**Fire condition:** 5+ bolded terms in a single document, or 3+ in a single paragraph.
|
|
34
|
+
|
|
35
|
+
**Exclusion:** Bold is appropriate in UI documentation (button names, field labels), safety warnings ("**Do not** delete this file"), and genuine reference material where bold signals terminology. Only trigger in flowing prose.
|
|
36
|
+
|
|
37
|
+
**Problem:** AI bolds key terms as if writing a study guide or corporate slide deck. In normal prose, bolding should be rare or absent.
|
|
38
|
+
|
|
39
|
+
**Semantic Risk:** LOW
|
|
40
|
+
|
|
41
|
+
**Before:**
|
|
42
|
+
> **Machine learning** is a subset of **artificial intelligence** that uses **statistical methods** to enable computers to **learn from data**. The most common approaches include **supervised learning**, **unsupervised learning**, and **reinforcement learning**.
|
|
43
|
+
|
|
44
|
+
**After:**
|
|
45
|
+
> Machine learning is a subset of artificial intelligence that uses statistical methods to let computers learn from data. The three main approaches are supervised learning, unsupervised learning, and reinforcement learning.
|
|
46
|
+
|
|
47
|
+
---
|
|
48
|
+
|
|
49
|
+
### 15. Inline-Header Vertical Lists
|
|
50
|
+
|
|
51
|
+
**Fire condition:** 2+ "**Label:** explanation" bullets in the same list.
|
|
52
|
+
|
|
53
|
+
**Exclusion:** Legitimate reference content — API parameter tables, changelog entries, feature comparison grids — where label-and-description is the correct and expected format.
|
|
54
|
+
|
|
55
|
+
**Burstiness note:** When rewriting, avoid converting every bullet into a single run-on sentence. Vary the approach: some items can merge into prose, others can become numbered steps if order matters, and short items can stay as a plain list without bold labels.
|
|
56
|
+
|
|
57
|
+
**Problem:** AI converts prose into pseudo-heading bullet points with a bold label and colon on every item. This format is appropriate for reference docs but not for articles, essays, or narrative text.
|
|
58
|
+
|
|
59
|
+
**Semantic Risk:** LOW
|
|
60
|
+
|
|
61
|
+
**Before:**
|
|
62
|
+
> - **Accessibility:** The platform supports screen readers and keyboard navigation.
|
|
63
|
+
> - **Performance:** Load times have been reduced by 40%.
|
|
64
|
+
> - **Security:** All data is encrypted end-to-end.
|
|
65
|
+
|
|
66
|
+
**After:**
|
|
67
|
+
> The platform now supports screen readers and keyboard navigation, load times are down 40%, and all data is encrypted end-to-end.
|
|
68
|
+
|
|
69
|
+
---
|
|
70
|
+
|
|
71
|
+
### 16. Title Case in Headings
|
|
72
|
+
|
|
73
|
+
**Fire condition:** 3+ content words (non-articles, non-prepositions) capitalized in the same heading when sentence case would be correct.
|
|
74
|
+
|
|
75
|
+
**Exclusion:** Proper nouns, brand names, product names, and acronyms within headings always require capitalization regardless of style guide.
|
|
76
|
+
|
|
77
|
+
**Problem:** AI capitalizes every word in headings (Title Case) instead of using sentence case. In most modern style guides (AP, APA, Google developer docs), sentence case is preferred for readability.
|
|
78
|
+
|
|
79
|
+
**Semantic Risk:** LOW
|
|
80
|
+
|
|
81
|
+
**Before:**
|
|
82
|
+
> ## The Impact Of Remote Work On Urban Development And Housing Markets
|
|
83
|
+
|
|
84
|
+
**After:**
|
|
85
|
+
> ## The impact of remote work on urban development and housing markets
|
|
86
|
+
|
|
87
|
+
---
|
|
88
|
+
|
|
89
|
+
### 17. Emojis
|
|
90
|
+
|
|
91
|
+
**Watch words:** emojis used as section markers or emphasis
|
|
92
|
+
|
|
93
|
+
**Fire condition:** Any emoji in professional, academic, or editorial text.
|
|
94
|
+
|
|
95
|
+
**Exclusion:** Personal blogs, social media copy, and casual newsletters where emojis are a deliberate stylistic choice. Also exclude emoji in quoted material being analyzed.
|
|
96
|
+
|
|
97
|
+
**Problem:** AI inserts emojis to add visual interest to text where they are inappropriate. This is especially common in listicles, summaries, and instructional content.
|
|
98
|
+
|
|
99
|
+
**Semantic Risk:** LOW
|
|
100
|
+
|
|
101
|
+
**Before:**
|
|
102
|
+
> Here are five tips for better sleep:
|
|
103
|
+
> 1. Set a consistent bedtime
|
|
104
|
+
> 2. Avoid screens before bed
|
|
105
|
+
> 3. Keep your room cool
|
|
106
|
+
> 4. Limit caffeine after noon
|
|
107
|
+
> 5. Try reading instead of scrolling
|
|
108
|
+
|
|
109
|
+
**After:**
|
|
110
|
+
> Five tips for better sleep:
|
|
111
|
+
> 1. Set a consistent bedtime.
|
|
112
|
+
> 2. Avoid screens before bed.
|
|
113
|
+
> 3. Keep your room cool.
|
|
114
|
+
> 4. Limit caffeine after noon.
|
|
115
|
+
> 5. Read instead of scrolling.
|
|
116
|
+
|
|
117
|
+
---
|
|
118
|
+
|
|
119
|
+
### 18. Curly Quotation Marks
|
|
120
|
+
|
|
121
|
+
**Watch words:** curly/smart quotes used in contexts where straight quotes are standard
|
|
122
|
+
|
|
123
|
+
**Fire condition:** Curly quotes appear inside code blocks, inline code spans, configuration file examples, or plain-text technical documents where straight quotes are required.
|
|
124
|
+
|
|
125
|
+
**Exclusion:** Curly quotes in narrative prose are typographically correct and not this pattern. Only trigger in technical or code contexts where curly quotes cause syntax errors or compatibility issues.
|
|
126
|
+
|
|
127
|
+
**Problem:** AI generates curly quotes in contexts where straight quotes are standard, such as code blocks, plain-text documents, configuration files, and technical documentation. This can cause syntax errors and compatibility issues.
|
|
128
|
+
|
|
129
|
+
**Semantic Risk:** LOW
|
|
130
|
+
|
|
131
|
+
**Before:**
|
|
132
|
+
> Set the variable: `name = "hello"`
|
|
133
|
+
>
|
|
134
|
+
> In your config file, add: `timeout = '30'`
|
|
135
|
+
|
|
136
|
+
**After:**
|
|
137
|
+
> Set the variable: `name = "hello"`
|
|
138
|
+
>
|
|
139
|
+
> In your config file, add: `timeout = '30'`
|