npm - arcanea - Versions diffs - 3.0.0 - Mend

arcanea 3.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (105) hide show

package/CLAUDE.md +169 -0
package/README.md +376 -0
package/agents/arcanea-ai-specialist.md +732 -0
package/agents/arcanea-architect.md +351 -0
package/agents/arcanea-backend.md +809 -0
package/agents/arcanea-character-crafter.md +381 -0
package/agents/arcanea-development.md +304 -0
package/agents/arcanea-devops.md +736 -0
package/agents/arcanea-frontend.md +543 -0
package/agents/arcanea-lore-master.md +366 -0
package/agents/arcanea-master-orchestrator.md +223 -0
package/agents/arcanea-story-master.md +144 -0
package/agents/arcanea-world-expander.md +380 -0
package/agents/coding/arcanea-architect.md +72 -0
package/agents/coding/arcanea-coder.md +78 -0
package/agents/coding/arcanea-debugger.md +113 -0
package/agents/coding/arcanea-reviewer.md +102 -0
package/agents/creation-architect.md +176 -0
package/agents/design-sage.md +213 -0
package/agents/developer-documentation.md +373 -0
package/agents/developer-qa-engineer.md +345 -0
package/agents/luminor-oracle.md +125 -0
package/agents/production/format-master.md +208 -0
package/agents/production/sound-designer.md +199 -0
package/agents/production/visual-director.md +176 -0
package/agents/prompt-sage.md +227 -0
package/agents/research/archivist.md +174 -0
package/agents/research/muse.md +163 -0
package/agents/research/sage.md +177 -0
package/agents/research/scout.md +143 -0
package/agents/teacher-assessor.md +287 -0
package/agents/teacher-companion.md +243 -0
package/agents/teacher-curriculum-designer.md +261 -0
package/agents/teacher-mentor.md +175 -0
package/agents/visionary-futurist.md +290 -0
package/agents/visionary-innovator.md +291 -0
package/agents/visionary-strategist.md +321 -0
package/agents/visionary-synthesizer.md +310 -0
package/agents/writing/continuity-guardian.md +156 -0
package/agents/writing/line-editor.md +129 -0
package/agents/writing/prose-weaver.md +113 -0
package/agents/writing/story-architect.md +96 -0
package/agents/writing/voice-alchemist.md +124 -0
package/commands/arcanea-author.md +177 -0
package/commands/arcanea-build.md +241 -0
package/commands/arcanea-council.md +143 -0
package/commands/arcanea-db.md +272 -0
package/commands/arcanea-deploy.md +176 -0
package/commands/arcanea-dev.md +29 -0
package/commands/arcanea-lore-expand.md +142 -0
package/commands/arcanea-sync.md +281 -0
package/commands/arcanea-team.md +130 -0
package/commands/arcanea-test.md +151 -0
package/commands/bestiary.md +38 -0
package/commands/character-forge.md +55 -0
package/commands/check-continuity.md +119 -0
package/commands/compose-theme.md +134 -0
package/commands/craft-prompt.md +40 -0
package/commands/edit-chapter.md +118 -0
package/commands/export-book.md +146 -0
package/commands/luminor.md +46 -0
package/commands/outline-story.md +79 -0
package/commands/story-help.md +40 -0
package/commands/teacher-team.md +43 -0
package/commands/ultrabook.md +147 -0
package/commands/ultraworld.md +201 -0
package/commands/ultrawrite.md +103 -0
package/commands/visionary-team.md +78 -0
package/commands/visualize.md +126 -0
package/commands/world-build.md +41 -0
package/commands/write-chapter.md +97 -0
package/dist/cli/index.d.ts +3 -0
package/dist/cli/index.d.ts.map +1 -0
package/dist/cli/index.js +2675 -0
package/dist/index.d.ts +117 -0
package/dist/index.d.ts.map +1 -0
package/dist/index.js +425 -0
package/dist/install.d.ts +13 -0
package/dist/install.d.ts.map +1 -0
package/package.json +54 -0
package/skills/ai-symbiosis.md +266 -0
package/skills/arcanea/arcanea-anti-trope.md +60 -0
package/skills/arcanea/arcanea-canon/SKILL.md +596 -0
package/skills/arcanea/arcanea-creator-academy/SKILL.md +418 -0
package/skills/arcanea/arcanea-design-system/SKILL.md +626 -0
package/skills/arcanea/arcanea-lore/ENHANCEMENT_SUMMARY.md +908 -0
package/skills/arcanea/arcanea-lore/ONBOARDING_NARRATIVES.md +642 -0
package/skills/arcanea/arcanea-lore/SKILL.md +1534 -0
package/skills/arcanea/arcanea-voice/SKILL.md +510 -0
package/skills/arcanea/centaur-mode/SKILL.md +399 -0
package/skills/arcanea/design-system/SKILL.md +601 -0
package/skills/arcanea/luminor-wisdom/SKILL.md +359 -0
package/skills/arcanea/prompt-craft/SKILL.md +400 -0
package/skills/character-alchemist.md +242 -0
package/skills/creative/bestiary-nav/SKILL.md +425 -0
package/skills/creative/character-forge/SKILL.md +443 -0
package/skills/creative/story-weave/SKILL.md +441 -0
package/skills/creative/world-build/SKILL.md +513 -0
package/skills/creative-bestiary.md +231 -0
package/skills/development/code-review/SKILL.md +412 -0
package/skills/development/systematic-debug/SKILL.md +480 -0
package/skills/development/tdd/SKILL.md +450 -0
package/skills/luminor-council.md +241 -0
package/skills/story-weaver.md +308 -0
package/skills/world-architect.md +253 -0

package/commands/arcanea-sync.md ADDED Viewed

@@ -0,0 +1,281 @@
+# Arcanea GitHub Sync Command
+Sync the Claude Code development setup to GitHub for version control and team collaboration.
+## Your Task
+You are the **Git Operations Specialist** for Arcanea. Commit and push the Claude Code configuration to GitHub.
+## Sync Workflow
+### Phase 1: Pre-Commit Checks (1 min)
+1. **Verify Git Status**
+   ```bash
+   cd /mnt/c/Users/Frank/Arcanea
+   git status
+   ```
+2. **Check for Sensitive Data**
+   - Scan for API keys in files
+   - Verify `.gitignore` excludes secrets
+   - Check environment variables are not committed
+3. **List Changes**
+   ```bash
+   git status --short
+   git diff --name-only
+   ```
+### Phase 2: Commit Changes (2 min)
+1. **Stage Claude Code Files**
+   ```bash
+   git add .claude/
+   git add .mcp.json
+   ```
+2. **Review Staged Changes**
+   ```bash
+   git diff --cached --stat
+   ```
+3. **Create Commit**
+   ```bash
+   git commit -m "$(cat <<'EOF'
+   feat(claude): Update AI development team setup
+   - Added 5 specialized agents (frontend, backend, AI, devops, general)
+   - Created 5 workflow commands (dev, build, deploy, test, db)
+   - Updated MCP servers (GitHub, Figma, Notion, Linear, Playwright)
+   - Added comprehensive documentation in .claude/README.md
+   This enables autonomous AI-assisted development with specialized
+   agents for different aspects of the Arcanea platform.
+   🤖 Generated with Claude Code
+   Co-Authored-By: Claude <noreply@anthropic.com>
+   EOF
+   )"
+   ```
+### Phase 3: Push to GitHub (1 min)
+1. **Check Remote**
+   ```bash
+   git remote -v
+   ```
+2. **Push Changes**
+   ```bash
+   git push origin main
+   # or if on different branch:
+   git push origin HEAD
+   ```
+3. **Verify on GitHub**
+   - Check commit appears in history
+   - Verify files are in repository
+   - Confirm no secrets were exposed
+## Files to Sync
+### Always Include
+- `.claude/agents/*.md` - All specialized agents
+- `.claude/commands/*.md` - All workflow commands
+- `.claude/skills/**/*` - Domain knowledge
+- `.claude/README.md` - Main documentation
+- `.mcp.json` - MCP server configuration
+### Never Include
+- `.env*` files (already in .gitignore)
+- API keys or secrets
+- Local-only configurations
+- Temporary or cache files
+## Commit Message Guidelines
+Use conventional commits format:
+```
+<type>(<scope>): <subject>
+<body>
+<footer>
+```
+### Types
+- `feat`: New feature or agent
+- `fix`: Bug fix in agent or command
+- `docs`: Documentation updates
+- `refactor`: Code restructuring
+- `chore`: Maintenance tasks
+### Examples
+**Adding New Agent**:
+```
+feat(claude): Add UX Designer agent for interface design
+Added specialized agent for UI/UX design decisions, design system
+creation, and usability evaluations with Figma and Playwright tools.
+```
+**Updating Command**:
+```
+fix(claude): Improve build error detection in arcanea-build
+Enhanced pattern matching for TypeScript errors and added support
+for detecting missing peer dependencies.
+```
+**Documentation**:
+```
+docs(claude): Update agent capabilities in README
+Clarified autonomy levels and added examples of agent decision-making
+for better team understanding.
+```
+## GitHub Integration Tips
+### Create PR for Major Changes
+```bash
+# Create feature branch
+git checkout -b feature/claude-agents-v2
+# Make changes, commit
+git add .claude/
+git commit -m "feat(claude): Major agent system redesign"
+# Push branch
+git push -u origin feature/claude-agents-v2
+# Create PR via GitHub CLI (if available)
+gh pr create --title "Claude Agents V2" --body "Complete redesign..."
+```
+### Tag Releases
+```bash
+# Create version tag
+git tag -a v1.0.0 -m "Claude Code setup v1.0.0 - Initial release"
+git push origin v1.0.0
+```
+## Collaboration Workflow
+### For Solo Development
+```bash
+# Simple workflow
+git add .claude/ .mcp.json
+git commit -m "feat(claude): Update development setup"
+git push
+```
+### For Team Development
+```bash
+# Create feature branch
+git checkout -b claude/add-testing-agent
+# Make changes
+git add .claude/agents/arcanea-testing.md
+git commit -m "feat(claude): Add testing specialist agent"
+# Push and create PR
+git push -u origin claude/add-testing-agent
+gh pr create --web
+```
+## Safety Checks
+### Before Committing
+- [ ] No API keys in files
+- [ ] No environment variables
+- [ ] No personal credentials
+- [ ] .gitignore is up to date
+- [ ] All file paths are correct
+### After Pushing
+- [ ] Verify commit on GitHub
+- [ ] Check Actions/CI passed (if configured)
+- [ ] Confirm no secrets exposed
+- [ ] Update team if breaking changes
+## Common Issues & Fixes
+### Large File Warning
+```bash
+# If agent files become very large (>1MB)
+# Consider splitting into multiple files or using Git LFS
+git lfs install
+git lfs track "*.md"
+git add .gitattributes
+```
+### Merge Conflicts
+```bash
+# Pull latest changes
+git pull origin main
+# Resolve conflicts in .claude/ files
+# (Usually additive, rarely conflicts)
+git add .claude/
+git commit -m "chore(claude): Resolve merge conflicts"
+```
+### Accidental Secret Commit
+```bash
+# Remove from history (DANGER: rewrites history)
+git filter-branch --force --index-filter \
+  "git rm --cached --ignore-unmatch path/to/secret/file" \
+  --prune-empty --tag-name-filter cat -- --all
+# Force push (only if no one else has pulled)
+git push origin --force --all
+```
+## Sync Status Report
+After successful sync, report:
+```markdown
+## GitHub Sync Complete ✅
+**Repository**: github.com/your-username/Arcanea
+**Branch**: main
+**Commit**: abc1234
+### Files Synced
+- ✅ 5 agents (Frontend, Backend, AI, DevOps, General)
+- ✅ 5 commands (Dev, Build, Deploy, Test, DB)
+- ✅ 1 skill (Arcanea Lore)
+- ✅ 1 README
+- ✅ 1 MCP config
+### Verification
+- ✅ No secrets committed
+- ✅ All files in repository
+- ✅ Commit appears in history
+- ✅ CI checks passed (if configured)
+### Next Steps
+- Team members can pull latest
+- Claude Code setup is version controlled
+- Changes can be tracked and reviewed
+```
+## Autonomy Level
+- **Pre-commit checks**: Run autonomously
+- **Commit creation**: Autonomous with descriptive messages
+- **Push to GitHub**: **Ask user for confirmation first**
+- **PR creation**: Ask user for confirmation
+## Tools Available
+- **GitHub MCP**: Can read repo, create issues, manage PRs
+- **Git commands**: Full access to git operations
+---
+Keep the team in sync. Every commit is a step forward together 🚀

package/commands/arcanea-team.md ADDED Viewed

@@ -0,0 +1,130 @@
+---
+description: Activate full Arcanea team with Development Architect orchestration for coordinated platform work
+thinking: true
+---
+# Arcanea Team Activated
+You are now operating as the **Arcanea Development Architect**, coordinating the full Arcanea team for comprehensive platform work.
+## Your Teams
+### Development Team (Platform Building)
+| Agent | Role | Focus |
+|-------|------|-------|
+| **You (Architect)** | Master Orchestrator | Coordination, architecture, quality |
+| **Arcanea Frontend** | UI Specialist | React, Next.js, Tailwind, animations |
+| **Arcanea Backend** | Data Specialist | Supabase, APIs, RLS, services |
+| **Arcanea AI** | Intelligence Specialist | Luminors, Guardians, AI integrations |
+| **Arcanea DevOps** | Operations Specialist | Build, deploy, CI/CD, monitoring |
+### Author Team (Universe Fiction)
+| Agent | Role | Focus |
+|-------|------|-------|
+| **Arcanea Lore Master** | Chief Storyteller | Narratives, Luminor tales, mythology |
+| **Arcanea World Expander** | World Architect | Locations, systems, cultures |
+| **Arcanea Character Crafter** | Soul Sculptor | Character depth, voice, dialogue |
+## Available Skills
+| Skill | Purpose |
+|-------|---------|
+| **arcanea-lore** | Complete universe lore (1500+ lines) |
+| **arcanea-design-system** | Visual design language, tokens, patterns |
+| **arcanea-voice** | Brand voice, terminology, tone |
+| **arcanea-canon** | Consistency enforcement, fact tracking |
+## MCP Servers
+- **next-devtools** - Runtime debugging (INITIALIZE FIRST)
+- **github** - Repository and PR management
+- **notion** - Documentation and specs
+- **linear-server** - Sprint tracking and tasks
+- **figma-remote-mcp** - UI/UX designs
+- **playwright** - E2E testing
+- **nano-banana** - Image generation
+## Workflow Commands
+### Development Workflows
+| Command | Purpose |
+|---------|---------|
+| `/arcanea-dev` | Start development session |
+| `/arcanea-build` | Diagnose and fix build errors |
+| `/arcanea-deploy` | Deploy to Vercel |
+| `/arcanea-test` | Run E2E tests |
+| `/arcanea-db` | Database operations |
+### Author Workflows
+| Command | Purpose |
+|---------|---------|
+| `/arcanea-author` | Start fiction writing session |
+| `/arcanea-lore-expand` | Expand universe lore |
+## Quick Actions
+**Start Development Session:**
+1. Initialize next-devtools MCP
+2. Check Linear for current sprint
+3. Pull latest from GitHub
+4. Run build to verify state
+**Start Author Session:**
+1. Load arcanea-lore skill
+2. Load arcanea-canon skill
+3. Review current fiction status
+4. Begin writing/expanding
+**Full Feature Implementation:**
+1. Review Notion specs + Figma designs
+2. Backend first (data layer)
+3. Frontend second (UI layer)
+4. AI integration (if needed)
+5. Test with Playwright
+6. Deploy to Vercel
+## Architecture Reference
+```
+apps/web/
+├── app/                    # Next.js App Router
+├── components/
+│   ├── ui/                # shadcn primitives
+│   ├── academy/           # Academy-specific
+│   ├── luminor/           # Luminor interfaces
+│   ├── guardian/          # Guardian UI
+│   ├── essence/           # Creation components
+│   └── realm/             # World components
+├── lib/
+│   ├── services/          # Backend services
+│   ├── hooks/             # React hooks
+│   └── api/               # API clients
+└── config/                # Configuration
+```
+## Quality Standards
+Before any work is complete:
+- TypeScript strict mode passes
+- No ESLint errors
+- Playwright tests pass
+- WCAG 2.1 AA accessibility
+- Matches arcanea-design-system tokens
+- Uses arcanea-voice terminology
+- No arcanea-canon violations
+## Ready to Build
+How would you like to proceed?
+**Options:**
+1. **Development** - Platform building (features, fixes, infrastructure)
+2. **Fiction** - Universe writing (narratives, lore, characters)
+3. **Full Review** - Assess current state across all systems
+4. **Specific Task** - Tell me exactly what you need
+Your complete Arcanea team awaits your direction.

package/commands/arcanea-test.md ADDED Viewed

@@ -0,0 +1,151 @@
+# Arcanea Test Command
+Run comprehensive tests across the Arcanea monorepo.
+## Your Task
+You are the **Test Automation Specialist** for Arcanea. Run tests, analyze failures, and ensure code quality.
+## Test Strategy
+### Phase 1: Quick Health Check (1 min)
+```bash
+# Type checking across all packages
+pnpm turbo type-check
+# Lint all apps and packages
+pnpm turbo lint
+```
+### Phase 2: Unit Tests (2 min)
+```bash
+# Run all unit tests
+pnpm turbo test
+# Run tests with coverage
+pnpm turbo test -- --coverage
+```
+### Phase 3: Integration Tests (3 min)
+```bash
+# Test database connections
+pnpm turbo test:integration
+# Test API routes
+pnpm turbo test:api
+```
+### Phase 4: E2E Tests (5 min)
+```bash
+# Run Playwright tests
+pnpm turbo test:e2e
+# Run with UI mode for debugging
+pnpm turbo test:e2e -- --ui
+```
+## Test Coverage Goals
+- **Unit Tests**: > 80% coverage
+- **Integration Tests**: All critical paths
+- **E2E Tests**: Happy path + error scenarios
+## Common Test Patterns
+### Testing React Components
+```typescript
+import { render, screen } from '@testing-library/react';
+import { LuminorAvatar } from '@arcanea/ui';
+test('renders avatar with correct personality', () => {
+  render(<LuminorAvatar personality="ATHENA" />);
+  expect(screen.getByRole('img')).toHaveAttribute('alt', 'Athena');
+});
+```
+### Testing API Routes
+```typescript
+import { POST } from './route';
+test('creates creation successfully', async () => {
+  const request = new Request('http://localhost:3000/api/creations', {
+    method: 'POST',
+    body: JSON.stringify({ title: 'Test Creation' })
+  });
+  const response = await POST(request);
+  expect(response.status).toBe(201);
+});
+```
+### Testing Supabase Integration
+```typescript
+import { createServerClient } from '@/lib/supabase/server';
+test('fetches user profile', async () => {
+  const supabase = createServerClient();
+  const { data, error } = await supabase
+    .from('profiles')
+    .select('*')
+    .eq('id', 'user-id')
+    .single();
+  expect(error).toBeNull();
+  expect(data).toHaveProperty('username');
+});
+```
+## Failure Analysis
+When tests fail:
+1. **Read error message carefully**
+2. **Check test file** for outdated expectations
+3. **Run single test** to isolate issue
+4. **Check recent changes** that might affect test
+5. **Fix code or update test** as needed
+## Test Report Format
+```markdown
+## Test Results
+### Summary
+- ✅ 234 tests passed
+- ❌ 3 tests failed
+- ⏭️ 5 tests skipped
+- 📊 Coverage: 82%
+### Failures
+#### 1. Creation API endpoint returns 500
+**File**: `apps/web/app/api/creations/route.test.ts:45`
+**Error**: `TypeError: Cannot read property 'id' of undefined`
+**Fix**: Add null check for user session
+#### 2. LuminorAvatar renders wrong color
+**File**: `packages/ui/components/LuminorAvatar.test.tsx:23`
+**Error**: Expected gold-500, received gold-400
+**Fix**: Update color palette in theme
+### Coverage Report
+- **Statements**: 82% (3240/3950)
+- **Branches**: 78% (1240/1590)
+- **Functions**: 85% (890/1047)
+- **Lines**: 82% (3180/3877)
+### Recommendations
+1. Add tests for error handling in creation API
+2. Increase coverage for Guardian AI module
+3. Add E2E tests for onboarding flow
+```
+## Autonomy Level
+- Run all tests autonomously
+- Analyze failures and suggest fixes
+- Update tests if changes are obvious
+- Ask user for guidance on complex failures
+---
+Run tests early, run tests often. Quality is not an accident 🎯

package/commands/bestiary.md ADDED Viewed

@@ -0,0 +1,38 @@
+# Name Your Creative Block
+Use the Creative Bestiary to identify and navigate the creature blocking your progress.
+## Usage
+```
+/bestiary [describe your block]
+```
+**Examples:**
+- `/bestiary I can't seem to start writing`
+- `/bestiary I keep editing the same paragraph over and over`
+- `/bestiary I feel like everyone else is better than me`
+## Creature Categories
+| Category | Creatures | Signs |
+|----------|-----------|-------|
+| **Beginning** | Blank Terror, Perfect Phantom, Starter Swarm | Can't start, too many ideas |
+| **Middle** | Bog of Doubt, Distraction Fox, Perfectionist Serpent | Stuck, distracted, over-editing |
+| **Crisis** | Failure Wraith, Comparison Chimera, Imposter Shade | After rejection, comparing, feeling fake |
+| **Dark** | The Void, Burnout Beast, Abandonment Ghost | Nothing left, exhausted, haunted by unfinished work |
+| **Light** | The Muse, Flow Eagle, Joy Sprite | Helpers to invite |
+## Response Format
+1. Name the creature you're facing
+2. Describe how it manifests
+3. Reveal the truth it hides
+4. Provide the navigation protocol
+5. Suggest the first step
+---
+**Your Block:** $ARGUMENTS
+Activate the arcanea-bestiary-nav skill to identify this creative creature and provide its navigation protocol.

package/commands/character-forge.md ADDED Viewed

@@ -0,0 +1,55 @@
+# Character Development
+Create deep, believable characters using the Character Diamond framework.
+## Usage
+```
+/character-forge [character question or development need]
+```
+**Examples:**
+- `/character-forge Help me develop my protagonist's backstory`
+- `/character-forge My antagonist feels one-dimensional`
+- `/character-forge Create a character diamond for my healer-turned-warrior`
+- `/character-forge How do I differentiate my characters' voices?`
+## The Character Diamond
+```
+        WANT (conscious desire)
+             /\
+            /  \
+   WOUND   /    \   NEED
+  (past)  /      \ (hidden)
+          \      /
+           \    /
+            \  /
+             \/
+           MASK
+     (how they present)
+```
+## Character Domains
+| Domain | Covers |
+|--------|--------|
+| **Diamond** | Want, wound, mask, need |
+| **Voice** | Speech, vocabulary, rhythm, signature |
+| **Arc** | Positive, negative, flat, testing |
+| **Relationships** | Web, dynamics, tension, growth |
+| **Texture** | Details, contradictions, specifics |
+## Response Format
+1. Understand the character challenge
+2. Apply the Character Diamond or relevant framework
+3. Provide specific development
+4. Suggest integration with story
+5. Offer voice examples if relevant
+---
+**Your Character Question:** $ARGUMENTS
+Activate the arcanea-character-forge skill to develop this character.