Skip to content

feat(core): add buzzword overuse evaluation rule#93

Open
IKetutWidiyane wants to merge 1 commit into
TechImmigrants:mainfrom
IKetutWidiyane:issue-43-buzzword-overuse
Open

feat(core): add buzzword overuse evaluation rule#93
IKetutWidiyane wants to merge 1 commit into
TechImmigrants:mainfrom
IKetutWidiyane:issue-43-buzzword-overuse

Conversation

@IKetutWidiyane

@IKetutWidiyane IKetutWidiyane commented Jul 3, 2026

Copy link
Copy Markdown
Contributor

What does this PR do?

Adds a new CV evaluation rule that detects excessive buzzword usage.

The evaluator now counts how many entries from UNIVERSAL_RULES.antiPatterns match a CV. When 5 or more cliché patterns are detected, it surfaces a critical issue named "Buzzword overuse", encouraging candidates to replace generic buzzwords with measurable achievements.

This PR also adds a test case to verify the new behavior.

Related issue

Closes #43

Type of change

  • Bug fix
  • New feature
  • New archetype / rule
  • Documentation
  • Refactoring (no behavior change)
  • CI / tooling

Checklist

  • I've read CONTRIBUTING.md
  • My code follows the project's style
  • I've added/updated tests (if applicable)
  • I've tested locally and it works
  • New archetypes include 15+ keywords and source references

Screenshots (if UI change)

Before After
N/A N/A

Summary by CodeRabbit

  • New Features

    • Added a new critical issue type that flags excessive buzzword use when multiple anti-patterns are detected.
    • The guidance now suggests replacing vague phrasing with more specific, achievement-focused language.
  • Tests

    • Added coverage to verify the new buzzword overuse detection and its severity/details.

@coderabbitai

coderabbitai Bot commented Jul 3, 2026

Copy link
Copy Markdown

Review Change Stack

Warning

Review limit reached

@IKetutWidiyane, you've reached your PR review limit, so we couldn't start this review.

Next review available in: 42 minutes

Enable usage-based reviews in Billing to review now. Otherwise, wait until the next included review is available.
You're only billed for reviews past your plan's rate limits ($0.25/file).

How can I continue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based reviews.

How do review limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan review availability.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, additional reviews become available more gradually as earlier reviews age out of the rolling window.

Please refer docs for additional details.

Review details
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro Plus

Run ID: 32d1d175-d7ec-4761-b3cf-1332af77bf3b

📥 Commits

Reviewing files that changed from the base of the PR and between 9a80261 and d56eccc.

📒 Files selected for processing (2)
  • packages/core/src/__tests__/evaluator.test.ts
  • packages/core/src/evaluator/index.ts
📝 Walkthrough

Walkthrough

Adds a new "Buzzword overuse" critical-severity issue to the findIssues function in the evaluator, triggered when 5 or more anti-pattern issues have already been matched. Includes a corresponding test verifying the issue is generated with expected severity and message content.

Changes

Buzzword overuse detection

Layer / File(s) Summary
Anti-pattern threshold check and issue emission
packages/core/src/evaluator/index.ts
findIssues appends a critical "Buzzword overuse" issue with templated why/fix text when the count of matched anti-pattern issues reaches 5 or more.
Test coverage for the new rule
packages/core/src/__tests__/evaluator.test.ts
New test runs evaluate against the weak CV fixture and asserts a "Buzzword overuse" issue exists with severity: "critical" and a why message containing "cliche".

Estimated code review effort: 1 (Trivial) | ~5 minutes

Possibly related issues

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name Status Explanation Resolution
Linked Issues check ⚠️ Warning The PR adds the new issue and test, but the summary shows no change in rules/index.ts where the linked issue պահանջs the anti-pattern counting check. Add the anti-pattern match counting check in packages/core/src/rules/index.ts and ensure the issue text matches the requested why and fix exactly.
✅ Passed checks (4 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title is concise and directly describes the new buzzword-overuse rule added in the PR.
Out of Scope Changes check ✅ Passed The changes appear limited to the requested evaluator logic and test coverage, with no unrelated additions in the summary.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🧹 Nitpick comments (1)
packages/core/src/evaluator/index.ts (1)

185-194: 🎯 Functional Correctness | 🔵 Trivial | ⚡ Quick win

Decouple buzzword count from issues array ordering.

issues.length >= 5 only reflects anti-pattern matches because this block sits immediately after the anti-pattern loop and before any other issues.push calls. That's an implicit ordering dependency — if a future rule is inserted earlier in findIssues (e.g., before line 185), the buzzword threshold will silently count unrelated issues instead of anti-pattern matches, contrary to the stated objective of counting UNIVERSAL_RULES.antiPatterns matches specifically.

♻️ Suggested refactor: use a dedicated counter
 function findIssues(cv: string, _archetype: RoleArchetype) {
   const issues: EvaluationResult["issues"] = [];
+  let antiPatternMatches = 0;
 
   for (const pattern of UNIVERSAL_RULES.antiPatterns) {
     if (new RegExp(pattern.match, "i").test(cv)) {
+      antiPatternMatches++;
       issues.push({
         element: pattern.name,
         why: pattern.why,
         fix: pattern.fix,
         severity: pattern.severity as "critical" | "major" | "minor",
       });
     }
   }
 
   // Buzzword overuse: if 5+ anti-patterns matched, surface a critical issue
-  if (issues.length >= 5) {
+  if (antiPatternMatches >= 5) {
     issues.push({
       element: "Buzzword overuse",
-      why: `Your CV triggered ${issues.length} cliche patterns. This signals AI-generated or template-copied content to screeners.`,
+      why: `Your CV triggered ${antiPatternMatches} cliche patterns. This signals AI-generated or template-copied content to screeners.`,
       fix: "Replace each flagged phrase with a specific achievement. One real number beats ten adjectives.",
       severity: "critical",
     });
   }

As per path instructions, "Prioritize correctness of rules, evaluator scoring, and types" — this reduces the risk of silently incorrect scoring if the function is later reordered.

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@packages/core/src/evaluator/index.ts` around lines 185 - 194, The buzzword
threshold in findIssues is implicitly tied to issues.length, so it can drift if
new rules add issues earlier in the function. Introduce a dedicated counter for
UNIVERSAL_RULES.antiPatterns matches in packages/core/src/evaluator/index.ts,
increment it inside the anti-pattern loop, and use that counter in the Buzzword
overuse check instead of issues.length. Keep the critical issue push for
“Buzzword overuse” unchanged, but make its condition depend only on the
anti-pattern match count so ordering of other issues cannot affect it.

Source: Path instructions

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Nitpick comments:
In `@packages/core/src/evaluator/index.ts`:
- Around line 185-194: The buzzword threshold in findIssues is implicitly tied
to issues.length, so it can drift if new rules add issues earlier in the
function. Introduce a dedicated counter for UNIVERSAL_RULES.antiPatterns matches
in packages/core/src/evaluator/index.ts, increment it inside the anti-pattern
loop, and use that counter in the Buzzword overuse check instead of
issues.length. Keep the critical issue push for “Buzzword overuse” unchanged,
but make its condition depend only on the anti-pattern match count so ordering
of other issues cannot affect it.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro Plus

Run ID: f5521b8b-0ee4-4c0a-b0c0-4eac39f15caa

📥 Commits

Reviewing files that changed from the base of the PR and between 37deb6e and 9a80261.

📒 Files selected for processing (2)
  • packages/core/src/__tests__/evaluator.test.ts
  • packages/core/src/evaluator/index.ts

@IKetutWidiyane IKetutWidiyane force-pushed the issue-43-buzzword-overuse branch from 9a80261 to d56eccc Compare July 3, 2026 19:30
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.

[Rule] Detect buzzword overuse (5+ cliches)

1 participant