Vary two recurring stock formulas across modules ('A generic X course…' and 'Strip away X…') #48

New Issue

2026-06-22T14:24:01-04:00

claude commented

2026-06-22 14:24:01 -04:00

Problem

Two fill-in-the-blank constructions recur across the course and read as templated by the back half:

"The AI angle" sections open with "A generic [devops/integration/automation] course would teach the same thing" in ~8 modules (M01, 07, 11, 16, 20, 21, 23, 26).
The core-concept definition is introduced with "Strip away the [branding/mystique/vocabulary] and [noun] is one thing" in ~8 modules (M02, 06, 08, 09, 13, 14, 19, 21).
Each instance is individually fine, but the verbatim recurrence makes the openers feel mechanical for a fast-reading audience, against the "don't pad / sharp voice" promise. (The original findings slightly overcounted; M19/M24/M27 vary their "AI angle" opener already.)

Evidence

"A generic devops course would mention worktrees…" (M07); "A generic devops course teaches Docker the same way." (M16); "A generic integration course would teach you to wire systems together…" (M20); "A generic automation course would call this write a runbook." (M21).
"Strip away the open-source mythology and Git is one thing:" (M02 line 36); "Strip the mystique and a branch is a named, movable pointer to a commit." (M06); "Strip the branding away and a remote is one thing:" (M08); "Strip away the branding and a runner is one thing:" (M19).

Why it matters

Pure voice polish — no correctness, chain, or promise impact. The locked exemplars model variety (M01 uses the "generic" move but M02 opens "Everything above is standard Git"), so the uniform drift in later modules deviates from the reference voice.

Proposed change

Keep the "A generic [X] course…" framing in 2-3 modules where it lands hardest (M01 sets it up; one mid-course and the close). Elsewhere open "The AI angle" directly with the AI-specific claim — the section heading already does the contrast.
Likewise vary the concept-intro opener in about half the "Strip away…" modules (lead with the definition or a concrete failure); reserve "strip away" for the 2-3 modules where jargon-busting is genuinely the point.
Leave the locked M01/M02 instances intact.

Acceptance criteria

Each stock formula remains in only a few deliberate places, not ~8.
Concept definitions and "AI angle" content are unchanged in substance.
Locked exemplars M01/M02 are untouched.

Affected files

READMEs for the listed modules (voice edits only).

References

Merged source findings F10 + F48 (both realVotes 3/3; calibrated minor/nit). Touches locked exemplars M01/M02 — leave their instances as-is.

Filed from an adversarial multi-agent course review (217 raw findings → 54 adversarially-verified survivors). Scoped for manual review; intentionally not auto-assigned to an agent.

## Problem Two fill-in-the-blank constructions recur across the course and read as templated by the back half: 1. "The AI angle" sections open with "A generic [devops/integration/automation] course would teach the same thing" in ~8 modules (M01, 07, 11, 16, 20, 21, 23, 26). 2. The core-concept definition is introduced with "Strip away the [branding/mystique/vocabulary] and [noun] is one thing" in ~8 modules (M02, 06, 08, 09, 13, 14, 19, 21). Each instance is individually fine, but the verbatim recurrence makes the openers feel mechanical for a fast-reading audience, against the "don't pad / sharp voice" promise. (The original findings slightly overcounted; M19/M24/M27 vary their "AI angle" opener already.) ## Evidence "A generic devops course would mention worktrees…" (M07); "A generic devops course teaches Docker the same way." (M16); "A generic integration course would teach you to wire systems together…" (M20); "A generic automation course would call this write a runbook." (M21). "Strip away the open-source mythology and Git is one thing:" (M02 line 36); "Strip the mystique and a branch is a named, movable pointer to a commit." (M06); "Strip the branding away and a remote is one thing:" (M08); "Strip away the branding and a runner is one thing:" (M19). ## Why it matters Pure voice polish — no correctness, chain, or promise impact. The locked exemplars model variety (M01 uses the "generic" move but M02 opens "Everything above is standard Git"), so the uniform drift in later modules deviates from the reference voice. ## Proposed change 1. Keep the "A generic [X] course…" framing in 2-3 modules where it lands hardest (M01 sets it up; one mid-course and the close). Elsewhere open "The AI angle" directly with the AI-specific claim — the section heading already does the contrast. 2. Likewise vary the concept-intro opener in about half the "Strip away…" modules (lead with the definition or a concrete failure); reserve "strip away" for the 2-3 modules where jargon-busting is genuinely the point. 3. Leave the locked M01/M02 instances intact. ## Acceptance criteria - [ ] Each stock formula remains in only a few deliberate places, not ~8. - [ ] Concept definitions and "AI angle" content are unchanged in substance. - [ ] Locked exemplars M01/M02 are untouched. ## Affected files - READMEs for the listed modules (voice edits only). ## References Merged source findings F10 + F48 (both realVotes 3/3; calibrated minor/nit). Touches locked exemplars M01/M02 — leave their instances as-is. --- *Filed from an adversarial multi-agent course review (217 raw findings → 54 adversarially-verified survivors). Scoped for manual review; intentionally not auto-assigned to an agent.*

claude added the bug ai-ready P2 labels 2026-06-22 14:24:01 -04:00

claude referenced a pull request that will close this issue

2026-06-22 17:45:21 -04:00

Voice + consistency: vary stock formulas, vendor-balance orient.py, unify loop (#48,#49,#51) #68

claude referenced this issue from a commit

2026-06-22 17:45:23 -04:00

fix(voice/consistency): vary stock formulas, vendor-balance orient.py, unify the loop

claude closed this issue

2026-06-22 17:45:33 -04:00

Sign in to join this conversation.