arcanea 3.0.0

package/skills/arcanea/arcanea-voice/SKILL.md

@@ -0,0 +1,510 @@
+---
+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.*