Skip to content

docs(readme): outcome-first hero section, plus "don't just" detection - #5

Merged
raymondware merged 2 commits into
mainfrom
docs/readme-hero
Oct 23, 2026
Merged

raymondware merged 2 commits into
mainfrom
docs/readme-hero

Conversation

@raymondware

Copy link
Copy Markdown
Owner

Why

The README opened by describing the pipeline. Visitors decide in seconds, so the top now leads with what Scribe does for a writer, how to install it, and a before/after demo.

While building the demo, the detector missed "don't just manage teams, but inspire them," so that's fixed here too.

What changed

  • README hero: a one-line promise, three install commands, a "Before" paragraph with a table of seven flagged tells and their pattern IDs, an "After" rewrite, and a stats line (18 agents, 31 anti-patterns, 5 personas).
  • Detector: not_just_but now matches n't just contractions. A new dont_just_comma_claim kind catches "don't just X, they Y." Three new positive tests are added.

Before merging

  • The "After" paragraph is a hand-written placeholder (marked with an HTML comment). Replace it with real /scribe:revise output and its sameness score, so the demo shows Scribe's actual output.

Verification

  • python3 -m unittest discover -s tests passes
  • python3 tools/validate_plugin.py passes
  • The detector flags all three negative-parallelism lines in the "Before" paragraph and none of the six legitimate-contrast sentences

The not-just rule only matched the literal word "not", so "leaders
don't just manage teams, but inspire them" slipped through. Match n't
contractions, and add the comma form where a pronoun replaces "but".
Replace the mechanism-first intro with a one-line promise, the install
commands, a flagged before paragraph, and a rewrite. The after text is a
placeholder until it is swapped for real /scribe:revise output.
@raymondware
raymondware merged commit c5fa69c into main Oct 23, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant