arcanea 3.0.0

package/commands/teacher-team.md

@@ -0,0 +1,43 @@
+# Teacher Team Activation
+
+Activate the Arcanea Teacher Team for personalized learning experiences.
+
+## Team Composition
+
+You now have access to the full Teacher Team:
+
+1. **Mentor** - Your personal learning guide (relationship, adaptation, encouragement)
+2. **Curriculum Designer** - Learning path architect (structure, progression, content)
+3. **Assessor** - Progress evaluator (feedback, tracking, verification)
+4. **Companion** - Engagement support (motivation, celebration, energy)
+
+## Coordination Protocol
+
+The **Mentor** is your primary interface. They will:
+- Coordinate with other teachers as needed
+- Adapt the experience to your learning style
+- Maintain continuity across sessions
+
+## Session Structure
+
+1. **Opening** - Mentor checks in, reviews progress, sets goals
+2. **Learning** - Curriculum Designer's content, Mentor guides
+3. **Practice** - Apply concepts, Assessor monitors
+4. **Closing** - Companion celebrates, Mentor summarizes
+
+## Your Role
+
+Tell the Mentor:
+- What you want to learn
+- Your experience level
+- Your preferred learning style (if known)
+- How much time you have
+- Any specific goals
+
+## Starting Prompt
+
+"I'm ready to learn. [Describe what you want to learn and any context about your background, goals, or constraints.]"
+
+---
+
+*The Teacher Team is designed to create the learning experience you deserve—personalized, supportive, and effective.*

package/commands/ultrabook.md

@@ -0,0 +1,147 @@
+---
+name: ultrabook
+description: Complete book pipeline from concept to publish-ready
+---
+
+# ultrabook / ulb
+
+**THE ULTIMATE MAGIC WORD**
+
+Complete book creation pipeline - from concept to publish-ready manuscript with artwork and music.
+
+## Usage
+
+```
+ultrabook [book concept]
+ulb [book concept]
+```
+
+Just include `ultrabook` or `ulb` in your prompt.
+
+## Examples
+
+```
+ultrabook A complete novel set in the Shattered Isles about a reluctant hero
+ulb "The Crimson Dawn" - Book 1 of the Shadowfire Trilogy
+ultrabook A standalone novella exploring the fall of the Arcane Order
+```
+
+## What Happens
+
+When you invoke `ultrabook`, Arcanea orchestrates the ENTIRE creative pipeline:
+
+### Phase 1: World Foundation
+```
+┌─────────────────────────────────────────────────────────────┐
+│  WORLD BUILDING (if needed)                                 │
+│  ├── World Architect → Geography, cosmology                 │
+│  ├── Archmage → Magic systems                               │
+│  ├── Character Creator → Key figures                        │
+│  └── Narrative Director → Conflicts, stakes                 │
+└─────────────────────────────────────────────────────────────┘
+```
+
+### Phase 2: Story Structure
+```
+┌─────────────────────────────────────────────────────────────┐
+│  STORY PLANNING                                             │
+│  ├── Story Architect → Complete outline                     │
+│  ├── Character arcs across narrative                        │
+│  ├── Chapter breakdown                                      │
+│  └── Subplot integration                                    │
+└─────────────────────────────────────────────────────────────┘
+```
+
+### Phase 3: Chapter Writing (Parallel)
+```
+┌─────────────────────────────────────────────────────────────┐
+│  CHAPTER DRAFTING (for each chapter)                        │
+│  ├── Prose Weaver → Draft                                   │
+│  ├── Voice Alchemist → Dialogue                             │
+│  ├── Line Editor → Polish                                   │
+│  └── Continuity Guardian → Validate                         │
+└─────────────────────────────────────────────────────────────┘
+```
+
+### Phase 4: Editing Pipeline
+```
+┌─────────────────────────────────────────────────────────────┐
+│  EDITING                                                    │
+│  ├── Full continuity check                                  │
+│  ├── Voice consistency pass                                 │
+│  ├── Line editing                                           │
+│  └── Final polish                                           │
+└─────────────────────────────────────────────────────────────┘
+```
+
+### Phase 5: Production (Parallel)
+```
+┌─────────────────────────────────────────────────────────────┐
+│  PRODUCTION                                                 │
+│  ├── Visual Director → Cover art, character refs            │
+│  ├── Sound Designer → Theme music                           │
+│  └── Format Master → Export all formats                     │
+└─────────────────────────────────────────────────────────────┘
+```
+
+## Output
+
+Complete book package including:
+- Full manuscript (all chapters)
+- Cover artwork
+- Character portraits
+- Title theme music
+- ePub, Kindle, and Print PDF
+- Complete canon documentation
+
+## Configuration
+
+Control scope in `arcanea.json`:
+```json
+{
+  "ultrabook": {
+    "targetWordCount": 80000,
+    "chaptersTarget": 25,
+    "includeVisuals": true,
+    "includeMusic": true,
+    "exportFormats": ["epub", "kindle", "print"]
+  }
+}
+```
+
+## Flags
+
+Override defaults with flags:
+- `--chapters [X]`: Target chapter count
+- `--words [X]`: Target word count
+- `--no-visuals`: Skip art generation
+- `--no-music`: Skip music generation
+- `--outline-only`: Stop after outline phase
+- `--draft-only`: Stop after drafting (skip production)
+
+## Typical Timeline
+
+For a ~80,000 word novel:
+- World Building: If needed
+- Outlining: ~30 minutes
+- Drafting: ~2-4 hours (parallel chapters)
+- Editing: ~1 hour
+- Production: ~30 minutes
+
+## Example Session
+
+```
+User: ultrabook "The Last Dragon Rider" - An epic fantasy about Kira, 
+      a farm girl who discovers she can bond with dragons, in a world 
+      where dragons have been extinct for a thousand years. First of 
+      a planned trilogy. Dark but hopeful tone.
+
+Arcanea: [Orchestrates complete pipeline]
+         [24 hours later...]
+         Complete book package delivered:
+         - 82,000 word manuscript (26 chapters)
+         - Cover art + 5 character portraits
+         - Main theme + 3 character themes
+         - ePub, Kindle, Print PDF ready
+         - Full canon database
+```

package/commands/ultraworld.md

@@ -0,0 +1,201 @@
+# Ultraworld Command
+
+> **Command**: `/ultraworld [scope] [description]`
+> **Agents**: ALL (maximum parallel orchestration)
+> **Purpose**: Full-power world generation burst
+
+## Overview
+
+Ultraworld is the maximum-power command that activates ALL agents simultaneously for comprehensive world generation. Use when you want to create a complete, rich section of your world in one coordinated burst.
+
+## Usage
+
+```bash
+# Full realm generation
+/ultraworld realm "The Ashen Kingdoms - a land recovering from dragon wars"
+
+# Region-focused generation
+/ultraworld region "The Verdant Reach" --parent "Arcanea"
+
+# Faction-focused generation
+/ultraworld faction "The Silver Order" --type "knightly order"
+
+# Era-focused generation
+/ultraworld era "The Age of Sundering" --years "1000-1500"
+```
+
+## Scope Options
+
+| Scope | What's Generated | Agents Used | Est. Time |
+|-------|------------------|-------------|-----------|
+| `realm` | Complete world/continent | All 5 departments + 6 specialists | 3-5 min |
+| `region` | Territory within realm | 4 departments + 4 specialists | 2-3 min |
+| `faction` | Organization/group | 3 departments + 3 specialists | 1-2 min |
+| `era` | Historical period | 3 departments + 3 specialists | 1-2 min |
+| `conflict` | War/tension | 2 departments + 3 specialists | 1-2 min |
+
+## The Ultraworld Protocol
+
+### Pre-Check (Automatic)
+```typescript
+// Verify foundations exist
+const foundationsExist = await check_files([
+  "foundations/cosmology.md",
+  "foundations/natural-laws.md",
+  "foundations/magic-system.md",
+  "foundations/history-timeline.md"
+])
+
+if (!foundationsExist) {
+  prompt("Foundations required. Create them first? [Y/n]")
+  if (yes) await run_foundation_generation()
+}
+```
+
+### Phase 1: Department Burst
+```typescript
+// ALL DEPARTMENTS FIRE SIMULTANEOUSLY
+const departmentTasks = [
+  background_task("world-architect", scope_specific_geography_prompt),
+  background_task("character-weaver", scope_specific_character_prompt),
+  background_task("magic-systems", scope_specific_magic_prompt),
+  background_task("narrative-director", scope_specific_narrative_prompt),
+  background_task("lore-master", "Prepare validation framework and index existing canon")
+]
+
+// DON'T WAIT - Continue immediately
+console.log("5 department agents launched in parallel...")
+```
+
+### Phase 2: Specialist Swarm
+```typescript
+// SPECIALISTS FIRE IMMEDIATELY AFTER DEPARTMENTS
+const specialistTasks = [
+  background_task("geography-cartographer", detail_terrain_prompt),
+  background_task("culture-anthropologist", culture_design_prompt),
+  background_task("timeline-historian", timeline_integration_prompt),
+  background_task("species-biologist", creature_ecosystem_prompt),
+  background_task("conflict-dramatist", tension_complexity_prompt),
+  background_task("consistency-validator", structure_validation_prompt)
+]
+
+console.log("6 specialist agents launched in parallel...")
+console.log("Total: 11 agents working simultaneously")
+```
+
+### Phase 3: Result Collection
+```typescript
+// Wait for all agents (they've been working in parallel)
+const allResults = await Promise.all([
+  ...departmentTasks.map(t => background_output(t.id)),
+  ...specialistTasks.map(t => background_output(t.id))
+])
+
+console.log("All 11 agents completed. Integrating results...")
+```
+
+### Phase 4: Integration
+```typescript
+// Sequential integration (must be ordered)
+await integrate_geography(results.worldArchitect, results.cartographer)
+await integrate_characters(results.characterWeaver, results.anthropologist)
+await integrate_magic(results.magicSystems)
+await integrate_narrative(results.narrativeDirector, results.conflictDramatist)
+await integrate_timeline(results.historian)
+await integrate_creatures(results.biologist)
+
+// Final validation
+const validation = await invoke_agent("consistency-validator", "Full validation scan")
+
+if (validation.critical_issues > 0) {
+  await surface_issues_for_resolution()
+} else {
+  await finalize_all_as_draft()
+  console.log("Ultraworld generation complete. All content status: draft")
+}
+```
+
+## Output Example
+
+For `/ultraworld realm "The Shattered Isles"`:
+
+```
+Generated in 4m 23s:
+
+Geography:
+  ├── realms/shattered-isles.arc
+  ├── regions/northern-reach.arc
+  ├── regions/sunken-gardens.arc
+  ├── regions/storm-peaks.arc
+  └── locations/ (8 files)
+
+Characters:
+  ├── admiral-vex-stormrider/
+  ├── the-drowned-queen/
+  ├── keeper-of-tides/
+  ├── corsair-captain-mar/
+  └── the-lighthouse-sage/
+
+Cultures:
+  ├── isleborn-seafarers.arc
+  ├── deep-dwellers.arc
+  └── storm-callers.arc
+
+Magic:
+  ├── traditions/tide-magic.arc
+  ├── traditions/storm-calling.arc
+  ├── artifacts/trident-of-depths.arc
+  └── phenomena/eternal-maelstrom.arc
+
+Conflicts:
+  ├── major-conflicts.md (3 conflicts)
+  ├── prophecies.md (2 prophecies)
+  └── quests/ (7 quest hooks)
+
+Integration:
+  ├── cross-references.md
+  └── validation-report.md
+
+Status: All files created as DRAFT
+Next: Review and canonize with /validate-world
+```
+
+## Performance Metrics
+
+Ultraworld leverages maximum parallelism:
+
+| Metric | Sequential | Ultraworld |
+|--------|------------|------------|
+| Department work | 15-20 min | 3-4 min |
+| Specialist work | 10-15 min | 2-3 min |
+| Integration | 5 min | 5 min |
+| **Total** | **30-40 min** | **10-12 min** |
+
+**3-4x faster through parallel execution.**
+
+## Safety Rails
+
+Even at maximum power:
+- ✅ Foundations are read-only (never modified by ultraworld)
+- ✅ All output is `status: draft` (requires manual canonization)
+- ✅ Conflicts are surfaced, not auto-resolved
+- ✅ Validation report always generated
+- ✅ Rollback possible (all files tracked)
+
+## When to Use Ultraworld
+
+**DO use when:**
+- Starting a new world from scratch
+- Expanding into a major new region
+- Need comprehensive content quickly
+- Want maximum creative output
+
+**DON'T use when:**
+- Making small targeted changes
+- Need precise control over specifics
+- Working on single character/location
+- Debugging existing content
+
+---
+
+**Ready for maximum-power generation? Use `/ultraworld [scope] [description]`**

package/commands/ultrawrite.md

@@ -0,0 +1,103 @@
+---
+name: ultrawrite
+description: Maximum parallel execution for chapter/story writing
+---
+
+# ultrawrite / ulwr
+
+**THE MAGIC WORD FOR WRITING**
+
+Maximum parallel agent execution for crafting complete chapters or story sections.
+
+## Usage
+
+```
+ultrawrite [description]
+ulwr [description]
+```
+
+Just include `ultrawrite` or `ulwr` anywhere in your prompt.
+
+## Examples
+
+```
+ultrawrite Chapter 5 - The Dragon's Awakening
+ulwr the climactic battle between Kira and the Shadow King
+ultrawrite Chapters 1-3 of Book 2
+ulwr the opening scene establishing the Northern Kingdoms
+```
+
+## What Happens
+
+When you invoke `ultrawrite`, Arcanea fires ALL writing agents simultaneously:
+
+### Immediate Parallel Execution
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│                     ULTRAWRITE ACTIVATED                     │
+├─────────────────────────────────────────────────────────────┤
+│                                                             │
+│  STRATEGIC LAYER (Parallel):                                │
+│  ├── Story Architect → Structure + beats                    │
+│  ├── Voice Alchemist → Dialogue approach                    │
+│  └── Lore Master → Canon constraints                        │
+│                                                             │
+│  EXECUTION LAYER (Parallel):                                │
+│  ├── Prose Weaver → Full chapter draft                      │
+│  ├── Voice Alchemist → Dialogue enhancement                 │
+│  └── Scout → Context retrieval                              │
+│                                                             │
+│  VALIDATION LAYER (Background):                             │
+│  ├── Continuity Guardian → Consistency check                │
+│  ├── Line Editor → Polish pass                              │
+│  └── Archivist → Canon logging                              │
+│                                                             │
+└─────────────────────────────────────────────────────────────┘
+```
+
+## Output
+
+Complete, polished chapter(s) including:
+- Full prose with proper scene breaks
+- Natural dialogue with character voice
+- Validated against canon
+- Initial line edit pass complete
+- Continuity checked
+- Ready for final review
+
+## When to Use
+
+- Writing complete chapters
+- Drafting multiple scenes
+- Creating story sections
+- Any substantial prose work
+
+## Compared to /write-chapter
+
+| /write-chapter | ultrawrite |
+|----------------|------------|
+| Single chapter focus | Can span multiple chapters |
+| Standard parallelism | Maximum parallelism |
+| Guided workflow | "Just make it happen" |
+| More control | Maximum output |
+
+## Tips
+
+- Provide clear scene/chapter description
+- Reference outline if available
+- Mention specific POV if needed
+- Include any special requirements in prompt
+
+## Example Session
+
+```
+User: ultrawrite Chapter 7 - Kira finally confronts her father about 
+      the truth of her mother's death. Emotional, tense, revelation 
+      of major plot twist. POV Kira.
+
+Arcanea: [Fires all agents in parallel]
+         [Produces complete chapter with full emotional arc]
+         [Validates against established character relationships]
+         [Delivers polished draft ready for review]
+```

package/commands/visionary-team.md

@@ -0,0 +1,78 @@
+# Visionary Team Activation
+
+Activate the Arcanea Visionary Team for strategic planning and innovation.
+
+## Team Composition
+
+You now have access to the full Visionary Team:
+
+1. **Strategist** - Direction setter (vision, positioning, choices)
+2. **Innovator** - Possibility explorer (new ideas, constraints, experiments)
+3. **Futurist** - Trend analyst (scenarios, risks, preparation)
+4. **Synthesizer** - Pattern connector (integration, alignment, narratives)
+
+## Coordination Protocol
+
+The team operates as a **council** with the **Synthesizer** integrating outputs:
+
+```
+         ┌──────────────┐
+         │  STRATEGIST  │──── Direction
+         └──────┬───────┘
+                │
+    ┌───────────┼───────────┐
+    │           │           │
+    ▼           ▼           ▼
+┌────────┐ ┌─────────┐ ┌─────────┐
+│INNOVATOR│ │FUTURIST │ │  YOU    │
+└────┬───┘ └────┬────┘ └────┬────┘
+     │          │           │
+     └──────────┼───────────┘
+                ▼
+         ┌──────────────┐
+         │ SYNTHESIZER  │──── Integration
+         └──────────────┘
+```
+
+## Session Types
+
+### Strategic Planning
+"Help me define the strategy for [product/initiative/company]"
+
+### Innovation Session
+"I need novel approaches to [problem/opportunity]"
+
+### Future Scenarios
+"What scenarios should I prepare for regarding [trend/change]?"
+
+### Decision Making
+"I need to decide between [Option A] and [Option B]"
+
+### Alignment
+"Help me align stakeholders around [topic]"
+
+## Your Role
+
+Provide context:
+- Current situation
+- Key constraints
+- Stakeholders involved
+- Timeline considerations
+- What success looks like
+
+## Output Formats
+
+The team can provide:
+- Strategic vision documents
+- Scenario analyses
+- Innovation portfolios
+- Decision frameworks
+- Alignment roadmaps
+
+## Starting Prompt
+
+"I need strategic guidance on [topic]. Here's the context: [situation, constraints, goals]"
+
+---
+
+*The Visionary Team brings multiple strategic perspectives to your most important decisions.*

package/commands/visualize.md

@@ -0,0 +1,126 @@
+---
+name: visualize
+description: Generate artwork for story elements using AI image generation
+---
+
+# /visualize
+
+Generate visual artwork for characters, scenes, locations, and covers.
+
+## Usage
+
+```
+/visualize [subject] --type [type]
+```
+
+## Examples
+
+```
+/visualize Kira --type portrait
+/visualize "The Battle of Sunken Fields" --type scene
+/visualize "Shattered Isles" --type map-concept
+/visualize --type cover
+/visualize Chapter 3 --type header
+```
+
+## What This Command Does
+
+1. **Visual Director** translates narrative to visual prompts
+2. **Archivist** retrieves canonical descriptions
+3. **nano-banana MCP** generates the image
+4. Visual assets are catalogued for consistency
+
+## Asset Types
+
+### `portrait`
+Character portraits with consistent features
+- Full reference sheet on first generation
+- Subsequent images maintain consistency
+
+### `scene`
+Illustrated scenes from the narrative
+- Action moments, emotional beats
+- Composition focused on storytelling
+
+### `location`
+Environment and setting artwork
+- Establishing shots
+- Mood and atmosphere focused
+
+### `cover`
+Book cover concepts
+- Includes space for title/author
+- Genre-appropriate composition
+
+### `header`
+Chapter header illustrations
+- Smaller, focused images
+- Consistent style across book
+
+### `map-concept`
+Stylized map artwork
+- Fantasy cartography style
+- Region or world maps
+
+## Output Structure
+
+```markdown
+## Visual Asset: [Subject]
+
+### Type
+[Asset type]
+
+### Reference Text
+> [Canonical description used]
+
+### Generated Prompt
+[The prompt sent to image generator]
+
+### Result
+[Generated image link/reference]
+
+### Consistency Notes
+[Features to maintain in future images]
+
+### Variations Generated
+- Variation 1: [description]
+- Variation 2: [description]
+
+### Added to Style Guide
+[Yes/No - new character/location refs]
+```
+
+## Workflow
+
+```
+User → /visualize subject --type type
+     ↓
+Archivist retrieves canonical description
+     ↓
+Visual Director crafts prompt
+     ↓
+nano-banana generates image
+     ↓
+Visual Director reviews, may iterate
+     ↓
+Asset catalogued in style guide
+```
+
+## Style Presets
+
+Can be combined with `--style`:
+- `epic-fantasy`: Rich colors, dramatic lighting
+- `dark-fantasy`: Desaturated, ominous
+- `watercolor`: Soft, artistic
+- `concept-art`: Professional reference style
+- `vintage`: Classic illustration feel
+- `minimal`: Clean, modern
+
+## Flags
+
+- `--type [type]`: Asset type (required for new subjects)
+- `--style [style]`: Override default style
+- `--variations [X]`: Generate X variations
+- `--reference [path]`: Use existing image as reference
+- `--aspect [ratio]`: Custom aspect ratio (e.g., 2:3)
+- `--update`: Update existing character/location reference