docs: rename Evaluate to Evals; inline naming conventions into CLAUDE.md

[keydunov]

Summary

Three related docs changes around the Evals feature:

1. Rename the product UI labels on the Evals docs page — the model IDE tab and runs sub-tab are now Evals (previously Evaluate / Evaluations).
2. Record the canonical terms in the product taxonomy / naming conventions.
3. Migrate the naming conventions out of .cursor/rules/ — we no longer use Cursor — by inlining them into docs-mintlify/CLAUDE.md.

Changes

admin/ai/evals.mdx — UI label rename:

• "Evaluate tab" → "Evals tab"; "Evaluations" sub-tab → "Evals"
• "Evaluation (run)" → "Eval (run)"; "Running an evaluation" → "Running an eval"
• Action button → "Run eval"; "Evaluation name" column → "Eval name"; image alt text updated

docs-mintlify/CLAUDE.md + .cursor/rules/namings-rule.mdc (deleted):

• Added Evals (Questions, eval run) under the Agent node in the Product Taxonomy tree, plus an Evals Terminology section flagging "Evaluate"/"Evaluation" as legacy.
• Inlined the full naming conventions into docs-mintlify/CLAUDE.md (headings nested under "Naming conventions") and removed the @../.cursor/rules/namings-rule.mdc import.
• Deleted the now-orphaned Cursor rule file. No remaining references to it in the repo.

Generic uses of "evaluate" elsewhere in the docs (expression evaluation, etc.) are unrelated and untouched.

🤖 Generated with Claude Code

[mintlify]

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated (UTC)
cubed3	🟢 Ready	View Preview	Jun 23, 2026, 5:25 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

[claude]

Claude finished @keydunov's task in 28s —— View job

---

Code Review

✅ LGTM — docs-only label rename, no issues found

• Read diff and surrounding context
• Verified no stale "Evaluate"/"Evaluation" strings remain in docs-mintlify/admin/ai/evals.mdx
• Checked link/anchor and alt-text consistency

Scope: 7/-7 in docs-mintlify/admin/ai/evals.mdx — UI label rename (Evaluate → Evals, Evaluation → Eval) to match the product.

Findings:

Area	Result
Quality	Clean, consistent substitution. Image alt text updated alongside the visible copy.
Correctness	No leftover "Evaluat*" tokens in the file. PR description correctly notes that generic "evaluate" usages elsewhere (expression evaluation, etc.) are intentionally untouched.
Anchors/links	The "Running an eval" heading was renamed from "Running an evaluation" — slug changes from #running-an-evaluation to #running-an-eval. No internal links to the old anchor exist in docs-mintlify/, and no entries in docs.json reference it, so nothing to fix. External deep links (if any) would 404, but that's expected for a rename.
Security/Perf/Tests	N/A — docs-only.

Nothing blocking. Ship it.

• Branch: [`docs/evals-rename-evaluate-to-evals`](https://github.com/cube-js/cube/tree/docs/evals-rename-evaluate-to-evals)

[claude]

Claude finished @keydunov's task in 35s —— View job

---

Code Review

✅ LGTM — docs + naming-rule update, no issues found (0 high, 0 medium, 0 low)

• Read diff for both changed files
• Verified .cursor/rules/namings-rule.mdc additions are consistent with evals.mdx terminology
• Confirmed no stale "Evaluate"/"Evaluation" strings remain in the evals docs page
• Checked taxonomy insertion point and link consistency

Scope: .cursor/rules/namings-rule.mdc (+17/-0) and docs-mintlify/admin/ai/evals.mdx (+7/-7) — UI label rename (Evaluate → Evals, Evaluation → Eval) plus a new Evals Terminology section in the cursor naming rules so future docs work stays aligned.

Findings:

Area	Result
Quality	Clean substitution in evals.mdx; image alt text updated alongside visible copy. New naming-rule section is concise and matches the product taxonomy entry inserted under Agent.
Correctness	No leftover "Evaluat*" tokens in evals.mdx. The naming rule correctly carves out generic verb uses ("evaluate the expression") so unrelated docs aren't touched. Taxonomy nesting (Evals → Questions / Eval run) under Agent reads correctly.
Anchors	## Running an evaluation → ## Running an eval changes the slug from #running-an-evaluation to #running-an-eval. No internal links in docs-mintlify/ or docs.json reference the old anchor, so nothing to fix. External deep links would 404 (expected for a rename).
Consistency	Terminology in the cursor rule (Evals, eval run, New eval, Eval name, Question) matches the docs page 1:1.
Security / Perf / Tests	N/A — docs + editor-config only.

Nothing blocking. Ship it.

• Branch: docs/evals-rename-evaluate-to-evals
•

[claude]

Claude finished @keydunov's task in 44s —— View job

---

Code Review

✅ LGTM — docs-only rename + inlined naming rules, no issues found (0 high, 0 medium, 0 low)

• Read PR diff for all 3 files
• Verified .cursor/rules/namings-rule.mdc deletion is intentional — content was inlined into docs-mintlify/CLAUDE.md and the previous @../.cursor/rules/namings-rule.mdc import was removed in the same commit
• Confirmed no other files reference the deleted .cursor rule path
• Verified no stale "Evaluate"/"Evaluation"/"Evaluations" UI-label strings remain in docs-mintlify/ (only the intentional legacy callout in docs-mintlify/CLAUDE.md:236)
• Checked anchor/link consistency

Scope: .cursor/rules/namings-rule.mdc (-205) deleted, docs-mintlify/CLAUDE.md (+219/-3) gains the inlined naming conventions plus a new Evals Terminology section, docs-mintlify/admin/ai/evals.mdx (+7/-7) UI label rename (Evaluate → Evals, Evaluation → Eval).

Findings:

Area	Result
Quality	Clean substitution in evals.mdx; image alt text updated alongside visible copy. The inlined naming rule in CLAUDE.md is well-organized and matches the prior .cursor rule 1:1 plus the new Evals section.
Correctness	No leftover "Evaluat*" UI tokens in evals.mdx. The @../.cursor/rules/namings-rule.mdc import was properly removed when the file was deleted — no dangling references. No other consumers of the deleted .cursor rule.
Anchors	## Running an evaluation → ## Running an eval changes the slug from #running-an-evaluation to #running-an-eval. No internal links in docs-mintlify/ or docs.json reference the old anchor. External deep links would 404 (expected for a rename).
Consistency	New Evals Terminology section (Evals, eval run, New eval, Eval name, Question) matches the docs page exactly. Taxonomy entry under Agent (Evals → Questions / Eval run) reads correctly.
Security / Perf / Tests	N/A — docs + editor-config only.

Nothing blocking. Ship it.

• Branch: [`docs/evals-rename-evaluate-to-evals`](https://github.com/cube-js/cube/tree/docs/evals-rename-evaluate-to-evals)

[claude]

Claude Code is working…

I'll analyze this and get back to you.

View job run

[claude]

Claude finished @keydunov's task in 31s —— View job

---

✅ LGTM — docs rename + inlined naming rules, no issues found (0 high, 0 medium, 0 low)

• Read diff for all 3 files (.cursor/rules/namings-rule.mdc deleted, docs-mintlify/CLAUDE.md +219/-3, docs-mintlify/admin/ai/evals.mdx +7/-7)
• Verified the .cursor rule deletion is matched by inlining into docs-mintlify/CLAUDE.md and removal of the @../.cursor/rules/namings-rule.mdc import
• Confirmed no other repo references to the deleted .cursor path
• Confirmed no stale "Evaluate"/"Evaluation"/"Evaluations" UI labels remain in docs-mintlify/ (only the intentional legacy callout in the Evals Terminology section)
• Checked anchor/link consistency for the renamed ## Running an eval heading

Scope: Docs-only — UI-label rename (Evaluate → Evals, Evaluation → Eval) on the Evals page, plus migration of the naming conventions from the deleted .cursor/rules/namings-rule.mdc into docs-mintlify/CLAUDE.md with a new Evals Terminology section.

Findings:

Area	Result
Quality	Clean substitution in evals.mdx; image alt text updated alongside visible copy. Inlined naming rule is well-organized and matches the prior cursor rule 1:1 plus the new Evals section.
Correctness	No leftover "Evaluat*" UI tokens. The @../.cursor/rules/namings-rule.mdc import was removed when the file was deleted — no dangling references.
Anchors	#running-an-evaluation → #running-an-eval. No internal links in docs-mintlify/ or docs.json reference the old slug. External deep links would 404 (expected for a rename).
Consistency	Terminology in the new section (Evals, eval run, Run eval, Eval run, Question) matches the page exactly. Taxonomy entry under Agent reads correctly.
Security / Perf / Tests	N/A — docs-only.

Nothing blocking. Ship it.

• Branch: docs/evals-rename-evaluate-to-evals
•