aboutsummaryrefslogtreecommitdiff
path: root/voice/references
diff options
context:
space:
mode:
authorCraig Jennings <c@cjennings.net>2026-07-20 23:27:19 -0500
committerCraig Jennings <c@cjennings.net>2026-07-20 23:27:19 -0500
commit2ea5d9a62ad8a28b26715b528ac8eb50a2677926 (patch)
tree8d1c99718625b5923c6d004ebe68acb94e825a99 /voice/references
parent61454894349e75b593ede5901a7b348ad580d3ce (diff)
downloadrulesets-2ea5d9a62ad8a28b26715b528ac8eb50a2677926.tar.gz
rulesets-2ea5d9a62ad8a28b26715b528ac8eb50a2677926.zip
docs(voice): add comma-budget pattern (#46) to personal mode
Craig's directive from the 2026-07-20 archsetup session: no sentence in a publish artifact carries more than two commas, enforced in the /voice personal pass. The third comma almost always marks stacked clauses or an inline list doing a paragraph's work. It's a mechanical count the walk can enforce where "don't stack clauses" gets skipped. Scoped to publish artifacts, so the personal-only set goes four to five. Added to the attestation high-recurrence set at birth: a comma count is cheap to receipt, and new discipline fails silently without one. The profile section carries the before/after from the Hyprland issue draft that prompted the rule.
Diffstat (limited to 'voice/references')
-rw-r--r--voice/references/voice-profile.org30
1 files changed, 30 insertions, 0 deletions
diff --git a/voice/references/voice-profile.org b/voice/references/voice-profile.org
index 765d513..3907edf 100644
--- a/voice/references/voice-profile.org
+++ b/voice/references/voice-profile.org
@@ -1532,3 +1532,33 @@ A question mark in a draft in Craig's voice. Flag it; keep genuine questions to
*** History
- 2026-05-29: surfaced by the Phase 1-2 corpus measurement as a register marker; filed as suggested delta 6.
- 2026-06-10: promoted from the suggested-deltas list into a numbered advisory pattern. Craig's call, from the work-project session.
+
+** §46 Comma Budget — Max Two Per Sentence
+
+*** Modes
+Personal mode only. Prose and general modes skip.
+
+*** Rule
+No sentence carries more than two commas. Rewrite the third comma away: split the sentence, move a clause into a parenthetical (§44) or behind a colon, or break an inline serial list into bullets or its own sentence. Count prose commas only — commas inside code spans, quoted log lines, and literal strings (version numbers, paths) don't count toward the budget.
+
+*** Problem
+Three or more commas in one sentence almost always mark stacked clauses or an inline list doing a paragraph's work. The sentence reads fine to its author and lands as a pileup on the reader. The comma count is a mechanical proxy the walk can enforce, where "don't stack clauses" is prose advice that gets skipped.
+
+*** Basis
+Craig's directive, 2026-07-20 (archsetup session, while gating a Hyprland issue draft): "no more than two commas per sentence. we should add that to the /voice personal pass."
+
+*** Before (spec-sheet line with three commas, from the draft that prompted the rule)
+#+begin_example
+System: Arch Linux, kernel 6.18.25-lts, AMD Strix Halo (Radeon 8060S), no plugins loaded.
+#+end_example
+
+*** After
+#+begin_example
+System: Arch Linux, kernel 6.18.25-lts. GPU: AMD Strix Halo (Radeon 8060S). No plugins loaded.
+#+end_example
+
+*** Detection
+Count commas per sentence on the final text. A sentence at three or more gets restructured, not trimmed to exactly the budget — the third comma is the symptom, the stacked structure is the target.
+
+*** History
+- 2026-07-20: added at Craig's direction from the archsetup session. Scoped to personal mode; broaden to prose only if he asks. Added to the attestation high-recurrence set at birth — a mechanical count is cheap to receipt, and new discipline fails silently without one.