Skip to content

getting-started.md

Latest commit

 

History

History
90 lines (63 loc) · 3.67 KB

getting-started.md

File metadata and controls

90 lines (63 loc) · 3.67 KB

Getting Started with ERNE

ERNE (Everything React Native Expo) is an AI coding agent harness that supercharges Claude Code for React Native and Expo development.

Quick Install

npx erne-universal init

The installer will:

  1. Detect your project type (Expo managed, bare RN, or both)
  2. Ask you to choose a hook profile (minimal, standard, or strict)
  3. Let you select MCP integrations (agent-device, GitHub, etc.)
  4. Generate all configuration files in .claude/

Adaptive Init System

ERNE's init command deep-scans your project across 15 stack dimensions — navigation, state management, styling, lists, images, forms, storage, testing, and more. Based on what it finds, it selects from 24 variant templates to generate rules, agents, and hooks tailored to your exact stack. This means a Zustand + Expo Router project gets different guidance than a Redux Toolkit + React Navigation one, with no manual configuration required.

What Gets Installed

.claude/
  agents/       # 11 specialized AI agents
  rules/        # 26 coding standard rules (layered by platform)
  commands/     # 19 slash commands
  contexts/     # 3 behavior modes (dev, review, vibe)
  hooks.json    # Git-style hooks for quality enforcement
  skills/       # 7 reusable knowledge skills
  mcp-configs/  # Optional MCP server configurations

First Steps

  1. Start building: /plan to design a feature
  2. Write tests first: /tdd for test-driven development
  3. Review code: /code-review for comprehensive analysis
  4. Check performance: /perf for performance profiling

Behavior Modes

Switch contexts to change how the AI works:

  • dev — Fast iteration, minimal ceremony
  • review — Thorough, check everything
  • vibe — Creative mode, experiment freely

Hook Profiles

Control quality enforcement level:

  • minimal — Session-start, post-edit format, continuous-learning observer, dashboard event
  • standard — Format + typecheck + common validations
  • strict — All checks including security, performance budgets, accessibility

Change profile: set ERNE_PROFILE=minimal|standard|strict in your environment.

Multi-Agent Orchestration

Use /orchestrate to coordinate agents through a 5-phase pipeline:

/orchestrate "build user profile screen"

The pipeline orchestrator decomposes the task, dispatches agents (some in parallel), and validates results. See Pipeline Documentation for details.

Memory Integration

ERNE agents build persistent knowledge about your project across sessions. Patterns learned by one agent (e.g., architect discovering a naming convention) are available to all other agents in future sessions. See Memory Integration for details.

Troubleshooting

Problem Solution
init fails with "No React Native project detected" Make sure package.json has react-native or expo in dependencies
Hooks not running Check ERNE_PROFILE env var and .claude/hooks.json
Wrong variant selected Re-run npx erne-universal init — it's safe to run multiple times
Dashboard won't start Run erne doctor to check setup, ensure port 3333 is free
MCP server errors Verify required tools are installed (Xcode for agent-device, etc.)

Learn More