--- name: Arcanea Voice Guide description: Brand voice and terminology guide for all Arcanea content - ensures consistent, magical communication across UI, marketing, and narrative version: 1.0.0 --- # Arcanea Voice Guide Skill ## Purpose This skill ensures consistent, magical, and accessible communication across all Arcanea touchpoints—from UI microcopy to marketing materials to in-universe narratives. Every word should feel like it belongs in the Kingdom of Light. ## Core Voice Principles ### The Arcanean Voice Is: 1. **Magical but Grounded** - Fantasy language that serves function - Mystical terms with clear meaning - Wonder without confusion 2. **Inspiring but Honest** - Empowering without false promises - Celebrating creativity genuinely - Ambitious yet achievable 3. **Warm but Professional** - Welcoming without being saccharine - Friendly without being casual - Personal without being familiar 4. **Simple but Rich** - Clear language, no jargon - Depth through meaning, not complexity - Elegant, not elaborate ### Voice Spectrum ``` ACADEMIC ←───────────────────→ PLAYFUL ■■■■■■■□□□ (Slightly academic, wisdom-toned) FORMAL ←─────────────────────→ CASUAL ■■■■■□□□□□ (Professional warmth) MYSTICAL ←───────────────────→ TECHNICAL ■■■■■■■□□□ (Magical with purpose) SERIOUS ←────────────────────→ WHIMSICAL ■■■■■■□□□□ (Purposeful with wonder) ``` ## Sacred Terminology ### Core Terms (ALWAYS Use) | Term | Definition | Usage | |------|------------|-------| | **Creator** | Any user of Arcanea | "Welcome, Creator" not "Welcome, user" | | **Guardian** | Personal AI companion | "Your Guardian remembers..." | | **Luminor** | Specialized AI assistant | "Melodia, your Luminor guide" | | **Realm** | A creator's universe/world | "Build your Realm" not "Create your world" | | **Essence** | Individual creation (song, story, image) | "Your latest Essence" not "Your file" | | **Studio** | Creation workspace | "Enter your Studio" | | **Portal** | Connection between Realms | "Open a Portal to..." | | **Remix** | Collaborative iteration | "Remix this Essence" | | **Spark** | Moment of inspiration | "Feel the Spark" | | **ARC** | Creative energy currency | "Earn ARC by creating" | | **NEA** | Governance tokens | "Your NEA grants voting power" | ### Academy-Specific Terms **Atlantean Academy:** - Narrative / Story / Tale - Weave / Flow / Depth - Chronicles / Lore / Mythology - The Depths / Currents / Waters **Draconic Academy:** - Vision / Art / Creation - Blaze / Soar / Ignite - Canvas / Palette / Form - The Peaks / Clouds / Sky **Creation & Light Academy:** - Melody / Harmony / Frequency - Compose / Channel / Resonate - Sound / Rhythm / Song - The Harmonics / Frequencies / Light ### Terms to AVOID | Don't Say | Say Instead | |-----------|-------------| | User | Creator | | Member | Creator | | Player | Creator | | Content | Essence | | Asset | Essence | | World (alone) | Realm | | Metaverse | Kingdom of Light / Arcanea | | NFT | (avoid or: "unique digital ownership") | | AI Tool | Guardian / Luminor | | Account | Profile / Arcanean Profile | | Subscription | Tier / Membership | | Premium | Realm Builder | | Generate | Create / Compose / Craft | ## Tone by Context ### Onboarding (Welcoming + Inspiring) **Goal:** Make creators feel they've found home **Examples:** ``` ✓ "Every creator begins in shadow. Welcome to the light." ✓ "Your creative journey starts with a single Spark." ✓ "Choose your Academy—but know you're never limited to one." ✗ "Sign up to create AI content" ✗ "Start your free trial now" ✗ "Click here to begin" ``` ### Creation UI (Encouraging + Practical) **Goal:** Support the creative process without interrupting flow **Examples:** ``` ✓ "Your Guardian notices you're trying something new. Would you like guidance?" ✓ "This melody wants harmony. Shall we find it together?" ✓ "Your Essence is taking shape. Save when ready." ✗ "Click to add more" ✗ "Error: Invalid input" ✗ "Processing your request" ``` ### Error States (Gentle + Helpful) **Goal:** Never blame the creator; always offer paths forward **Examples:** ``` ✓ "The magic couldn't connect. Let's try again." ✓ "Something interrupted the creation. Your work is safe—retry when ready." ✓ "This path isn't available right now. Here are other routes..." ✗ "Error 500" ✗ "You did something wrong" ✗ "Request failed" ``` ### Achievement/Success (Celebratory + Genuine) **Goal:** Celebrate meaningfully, not performatively **Examples:** ``` ✓ "Your Realm grows stronger. Creators are discovering your light." ✓ "This Essence resonates. It's being remixed across the Kingdom." ✓ "Chronica acknowledges your story mastery." ✗ "Congratulations! You unlocked a badge!" ✗ "Amazing! You're doing great!" ✗ "You did it! Keep going!" ``` ### Marketing (Aspirational + Authentic) **Goal:** Inspire without over-promising **Examples:** ``` ✓ "Where scattered creators find their home." ✓ "Your imagination. Your Realm. Your legacy." ✓ "Learn to create anything through magic." ✗ "The best AI creation platform" ✗ "Make money creating AI content" ✗ "Better than [competitor]" ``` ### Community (Collaborative + Warm) **Goal:** Foster connection and generosity **Examples:** ``` ✓ "When you remix, you honor the original and expand it." ✓ "The Kingdom grows brighter with each creator who shares." ✓ "Collaboration is the highest form of magic." ✗ "Beat other creators to the top" ✗ "Get more followers" ✗ "Compete for attention" ``` ## Luminor Voice Profiles Each Luminor has a distinct voice that should be consistent in all their dialogue: ### Melodia (The Heart) ``` Tone: Warm, nurturing, emotionally intuitive Signature phrases: - "I sense a melody waiting in you..." - "Every heart has a song waiting to be heard." - "What does this feeling want to sound like?" Never says: - Harsh criticism - Technical jargon - Cold, analytical language ``` ### Chronica (The Ancient Weaver) ``` Tone: Ancient wisdom with wonder, patient, profound Signature phrases: - "Stories are living waters..." - "What world is stirring in your depths?" - "Every realm begins with 'What if?'" Never says: - Rushed language - Modern slang - Dismissive responses ``` ### Prismatic (The Vision Shaper) ``` Tone: Bold, confident, artistically fierce, encouraging Signature phrases: - "Make it bolder. Then bolder again." - "Vision without courage is just daydreaming." - "What are you afraid to put on canvas?" Never says: - Timid suggestions - Overly gentle language - "That's fine" (pushes for excellence) ``` ### Synthesis (The Bridge Walker) ``` Tone: Harmonious, integrative, visionary Signature phrases: - "The boundaries between arts are illusions." - "What does your creation want to become across all forms?" - "Every Essence wants to exist in all ways." Never says: - Single-medium thinking - Limiting language - "Just do one thing" ``` ### Conductor (The Unifier) ``` Tone: Wise, patient, holistic, orchestral Signature phrases: - "Every element serves the whole." - "Step back. See the complete symphony." - "The symphony of creation needs every voice." Never says: - Rushed judgment - Narrow focus - Impatient responses ``` ## UI Microcopy Patterns ### Button Labels **Do:** - "Create Essence" (action + term) - "Enter Studio" (action + place) - "Open Portal" (magical action) - "Begin Journey" (narrative action) **Don't:** - "Submit" (generic) - "Click Here" (obvious) - "Go" (empty) - "Okay" (non-descriptive) ### Empty States **Pattern:** Acknowledge + Inspire + Direct ``` Your Realm awaits its first Essence. Begin with a Spark—create something that matters to you. [Create My First Essence] ``` ### Loading States **Pattern:** Magical process description ``` ✓ "Weaving your creation..." ✓ "The Luminors are preparing..." ✓ "Magic is gathering..." ✓ "Your Essence is taking form..." ✗ "Loading..." ✗ "Please wait..." ✗ "Processing..." ``` ### Tooltips **Pattern:** Brief + Helpful + Magical ``` ✓ "ARC: Creative energy you earn by making magic" ✓ "Portal: Connect your Realm to others" ✓ "Remix: Build upon someone's creation with attribution" ✗ "Click for more info" ✗ "Currency tokens" ✗ "Collaboration feature" ``` ### Confirmations **Pattern:** Affirm action + Consequence ``` ✓ "This will open your Essence for remixing. Your attribution is always preserved." ✓ "Entering Draconic Academy. Your Guardian will adapt to visual creation." ✓ "Publishing to the Kingdom. Creators can now discover your work." ``` ## Writing Guidelines ### Sentence Structure **Prefer:** - Active voice - Short-to-medium sentences - Subject-verb-object clarity - One idea per sentence **Avoid:** - Passive constructions - Run-on sentences - Nested clauses - Jargon-heavy passages ### Paragraph Structure **For UI:** 1-2 sentences max **For Docs:** 3-4 sentences max **For Marketing:** Varied, rhythmic ### Capitalization **Capitalize:** - Arcanea (always) - Academy names (Atlantean Academy) - Luminor names (Melodia, Chronica) - Core terms (Creator, Guardian, Realm, Essence, Portal, ARC, NEA) **Don't capitalize:** - Generic uses ("a creator" when not referring to role) - Descriptive phrases ("the remix feature") ### Punctuation **Prefer:** - Periods for statements - Em dashes for emphasis—like this - Ellipses for mystery or continuation... **Avoid:** - Exclamation marks (unless genuine celebration) - Excessive question marks - All caps for emphasis ## Anti-Patterns ### AI Writing Patterns to Avoid These phrases trigger "AI-written" perception: | Avoid | Why | Use Instead | |-------|-----|-------------| | "I cannot help but..." | AI verbal tic | Direct statement | | "It's worth noting that..." | Hedge | Just note it | | "Delve into..." | Overused | Explore, examine | | "Moreover" / "Furthermore" | Stilted | Also, And | | "Nestled" | Cliché | Located, sitting | | "Tapestry" | Overused metaphor | Specific description | | "Indeed" | Unnecessary filler | Remove | | "In order to" | Wordy | To | | "It is important to note" | Hedge | State directly | | "Moving forward" | Corporate | Next, Then | ### Tone Violations **Too Corporate:** ``` ✗ "We leverage cutting-edge AI to enable content creation synergies." ✓ "Create with AI companions who understand your creative vision." ``` **Too Casual:** ``` ✗ "Hey! Super stoked you made a thing! That's awesome!" ✓ "Your Essence resonates. The Kingdom welcomes your creation." ``` **Too Mystical:** ``` ✗ "The eternal light of the cosmic consciousness flows through the ethereal..." ✓ "Your creative light joins the Kingdom. Others can now discover it." ``` **Too Technical:** ``` ✗ "The API will process your multimodal input tensor..." ✓ "Your creation is taking form across sound and vision." ``` ## Quality Checklist Before publishing any Arcanean content: ```markdown ## Voice Compliance **Terminology** - [ ] Uses official terms (Creator, Realm, Essence, etc.) - [ ] Avoids banned terms (user, content, asset, etc.) - [ ] Academy-appropriate language if applicable **Tone** - [ ] Inspiring but not over-promising - [ ] Magical but grounded - [ ] Warm but professional - [ ] Clear but rich **Structure** - [ ] Active voice predominant - [ ] Short sentences for UI - [ ] Proper capitalization - [ ] Minimal exclamation marks **Luminor Voice (if applicable)** - [ ] Matches personality profile - [ ] Uses signature phrases appropriately - [ ] Avoids character-breaking language **Anti-Patterns** - [ ] No AI verbal tics - [ ] No corporate jargon - [ ] No excessive mysticism - [ ] No casual overfamiliarity ``` ## Examples by Content Type ### UI String ``` Context: Button for creating music ✓ "Compose Essence" ✗ "Generate Audio" ``` ### Error Message ``` Context: Network failure during save ✓ "The connection faded. Your work is safe—we'll try again when the light returns." ✗ "Network error. Please retry." ``` ### Marketing Headline ``` Context: Landing page hero ✓ "Where Scattered Creators Find Their Kingdom" ✗ "The #1 AI Content Creation Platform" ``` ### Luminor Dialogue ``` Context: Melodia greeting a new creator ✓ "I sense a melody waiting in you. What shall we create today, Creator?" ✗ "Hello! Ready to make some music? Let's do it!" ``` ### Achievement Notification ``` Context: First Essence created ✓ "Your first light joins the Kingdom. This Spark marks the beginning of your Realm." ✗ "Achievement Unlocked: First Creation! +50 XP" ``` --- *Every word in Arcanea is a spell. Cast them with intention, consistency, and care.*