Enhance copy and capitalization guidelines

[dekanbro]

Added guidelines for copy and capitalization, including title casing and usage of small caps.

Summary by CodeRabbit

• Documentation
  • Updated design handbook with expanded typography guidelines for capitalization and copy styling.
  • Enhanced asset references with SVG icon usage recommendations and cohort guide resources.
  • Added technical guidance for proper icon styling with documentation themes.

_{✏️ Tip: You can customize this high-level summary in your review settings.}

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Review	Updated (UTC)
brand	Ready	Preview, Comment	Dec 18, 2025 2:39pm

[coderabbitai]

Walkthrough

The AGENTS.md brand guidelines document is updated with a simplified title, new typography guidelines for copy and capitalization, Nextra theme technical notes, and expanded asset guidance emphasizing SVG icon usage over emojis. Some content sections are reiterated across the document.

Changes

Cohort / File(s)	Summary
Documentation Update AGENTS.md	Title simplified; added Copy & capitalization guidelines; added Nextra docs theme styling notes; expanded Assets & References with icon asset locations, SVG preference guidance with img tag examples, and alt text recommendations; some content duplicated across sections

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~5 minutes

• Documentation-only changes with no code logic or logic density to evaluate
• Single file affected with straightforward content additions and restructuring
• Note: Verify whether content duplication (Copy & capitalization, Nextra note, icon sections appearing in parallel spots) is intentional or should be consolidated

Possibly related PRs

• add AGENTS file and note in README #22: Originally added the AGENTS.md file; this PR expands and refines the same document with additional typography, assets, and Nextra guidance.

Poem

🐰 A handbook of agents refined,
With icons and caps perfectly aligned,
SVGs shine where emojis once stood,
Brand guidelines clear—as they should,
Typography magic, now understood! ✨

Pre-merge checks and finishing touches

✅ Passed checks (3 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title accurately reflects the primary change—adding guidelines for copy and capitalization to the AGENTS.md documentation file.
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
• Post copyable unit tests in a comment
• Commit unit tests in branch dekanbro-agents-file-patch-1

---

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

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[coderabbitai]

Actionable comments posted: 1

📜 Review details

Configuration used: defaults

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 1d481f2 and dc00472.

📒 Files selected for processing (1)

• AGENTS.md (3 hunks)

🧰 Additional context used

🧠 Learnings (5)

📓 Common learnings

Learnt from: CR
Repo: raid-guild/brand PR: 0
File: AGENTS.md:0-0
Timestamp: 2025-12-11T23:45:04.287Z
Learning: Keep the RaidGuild Agent Handbook (RG_BRAND_AGENTS.md or AGENTS.md) synchronized when design tokens, component APIs, asset locations, or setup steps change

📚 Learning: 2025-12-11T23:45:04.287Z

Learnt from: CR
Repo: raid-guild/brand PR: 0
File: AGENTS.md:0-0
Timestamp: 2025-12-11T23:45:04.287Z
Learning: Keep the RaidGuild Agent Handbook (RG_BRAND_AGENTS.md or AGENTS.md) synchronized when design tokens, component APIs, asset locations, or setup steps change

Applied to files:

• AGENTS.md

📚 Learning: 2025-12-11T23:45:04.287Z

Learnt from: CR
Repo: raid-guild/brand PR: 0
File: AGENTS.md:0-0
Timestamp: 2025-12-11T23:45:04.287Z
Learning: Applies to **/*.{ts,tsx} : Use brand typography utility classes (type-display-lg/md/sm, type-heading-lg/md/sm, type-body-lg/md/sm, type-label, type-label-md, type-label-sm, type-code-lg/md/sm) instead of custom font sizes and weights

Applied to files:

• AGENTS.md

📚 Learning: 2025-12-11T23:45:04.287Z

Learnt from: CR
Repo: raid-guild/brand PR: 0
File: AGENTS.md:0-0
Timestamp: 2025-12-11T23:45:04.287Z
Learning: Applies to src/app/**/*.{ts,tsx} : Wrap the `<body>` element with font variables (maziusDisplay, ebGaramond, ubuntuMono) from `src/lib/fonts.ts` and the `<ThemeProvider>` from `src/lib/theme-context.tsx`

Applied to files:

• AGENTS.md

📚 Learning: 2025-12-11T23:45:04.287Z

Learnt from: CR
Repo: raid-guild/brand PR: 0
File: AGENTS.md:0-0
Timestamp: 2025-12-11T23:45:04.287Z
Learning: Applies to **/*.{ts,tsx} : Follow tokens and utilities from `src/app/globals.css` and fonts from `src/lib/fonts.ts` for styling and typography

Applied to files:

• AGENTS.md

🪛 LanguageTool

AGENTS.md

[grammar] ~60-~60: Ensure spelling is correct
Context: ..., flasks). the /8bit folder has special 8bit style icons for the different roles in ...

(QB_NEW_EN_ORTHOGRAPHY_ERROR_IDS_1)

🔇 Additional comments (3)

AGENTS.md (3)

39-61: Verify no unintended content duplication across document sections.

The AI summary notes that "Copy & capitalization, Nextra note, and Cohort icons sections are reiterated and integrated similar sections, effectively duplicating these content blocks within the document." The provided code excerpt shows these sections appearing once (lines 39–49 and 60–61), but since old/removed lines are not displayed, confirm that these guidelines are not redundantly repeated elsewhere in the full file.

Per learnings, keep AGENTS.md synchronized with design tokens and asset locations. Duplication could obscure updates when changes are needed in the future.

---

1-1: Verify title simplification is intentional.

The title changed from "RaidGuild Agent Handbook (Design & Brand)" to "RaidGuild Agent (Design & Brand)". While the document's purpose is still clear from line 3, confirm that removing "Handbook" was an intentional brand/messaging decision rather than an oversight.

---

39-48: Copy & capitalization and Nextra theme guidance looks solid.

The new sections clearly document title casing conventions, small-caps avoidance, and OpenType caps feature resets for Nextra. The font-level fix (line 47) with explicit OpenType feature toggles is technically sound. Good addition for maintainability.

[coderabbitai]

⚠️ Potential issue | 🟡 Minor

Fix capitalization error at start of sentence.

Line 60 begins with lowercase "the" after the previous sentence ends. Capitalize to "The" for proper grammar.

- Cohort guide icon assets: this repo also exposes a subset of brand icons under `/dd` (D&D-style line icons for roles, tools, and encounters) and `public/assets/icon/magic` (magic UI glyphs like stars, crystals, lanterns, flasks). the /8bit folder has special 8bit style icons for the different roles in RaidGuild
+ Cohort guide icon assets: this repo also exposes a subset of brand icons under `/dd` (D&D-style line icons for roles, tools, and encounters) and `public/assets/icon/magic` (magic UI glyphs like stars, crystals, lanterns, flasks). The /8bit folder has special 8bit style icons for the different roles in RaidGuild

🧰 Tools

🪛 LanguageTool

[grammar] ~60-~60: Ensure spelling is correct
Context: ..., flasks). the /8bit folder has special 8bit style icons for the different roles in ...

(QB_NEW_EN_ORTHOGRAPHY_ERROR_IDS_1)

🤖 Prompt for AI Agents

In AGENTS.md around lines 60 to 61, the second sentence begins with a lowercase
"the" ("the /8bit folder..."); change it to "The" to correct capitalization at
the start of the sentence so it reads properly ("The /8bit folder has special
8bit style icons...").