sensara

Build Expo React Native apps with AI agents. Choose your workflow:

• Max — Persistent Claude Code teammates that message each other, accumulate context, and fix issues directly
• Min — Ephemeral builder/validator subagents spawned fresh per task

Both modes scaffold your project with skills, prompts, docs, and validation scripts optimized for the Convex + Expo + NativeWind stack.

Quick Start

npx sensara init --max
# or
npx sensara init --min

Then set up the Convex MCP and start building:

claude mcp add-json convex '{"type":"stdio","command":"npx","args":["convex","mcp","start"]}'
claude mcp get convex
claude

Modes

Max (--max)

Spawns persistent AI teammates that coordinate through direct messaging. Each teammate owns specific directories and accumulates context across tasks. A reviewer validates all work and messages builders directly to fix issues.

Default team: backend-builder, mobile-builder, reviewer

Workflow: /idea-to-spec → /plan-for-team → /create-expo-team

Min (--min)

Spawns ephemeral builder/validator agent pairs per task. Each agent starts fresh with only its task context. Validators are active — they create fix tasks and spawn new builders on failure.

Workflow: /idea-to-spec → /planning-with-agents → /build-from-plan

Commands

sensara init [path] --max      # Bootstrap Max mode (persistent agent teams)
sensara init [path] --min      # Bootstrap Min mode (ephemeral agents)
sensara update [path]          # Update skills/prompts/docs (auto-detects mode)
sensara info [path]            # Show mode + version

init copies shared templates (docs, scripts, skills) plus mode-specific files. It skips user-request.md and settings.local.json if they exist, and writes .sensara suffixed copies of CLAUDE.md and settings.json if those already exist.

update overwrites updatable paths (skills, docs, scripts, prompts) while preserving your CLAUDE.md, settings.json, and specs.

What Gets Scaffolded

Shared (both modes):

| Path | Contents | |------|----------| | .claude/skills/idea-to-spec/ | Transform app idea into complete spec | | .claude/settings.local.json | Pre-configured permissions (Convex, Expo, git) | | docs/ | NativeWind v5 guides (6 files) | | scripts/ | Validation helpers | | specs/user-request.md | App spec template |

Max mode adds:

| Path | Contents | |------|----------| | .claude/settings.json | Agent Teams env + hooks | | .claude/skills/ | plan-for-team, create-expo-team | | prompts/ | Team lead, expo conventions, 5 teammate definitions | | CLAUDE.md | Team protocols and communication format |

Min mode adds:

| Path | Contents | |------|----------| | .claude/settings.json | Pre/Post/Stop hooks | | .claude/agents/ | builder, validator, plan-validator | | .claude/hooks/ | Post-tool-use validation | | .claude/skills/ | build-from-plan, planning-with-agents, stack-orchestrator | | .cursor/ | Cursor IDE mirror of agents + skills | | prompts/ | Orchestrator templates | | CLAUDE.md | Subagent workflow description |

Tech Stack

Every project scaffolded by sensara uses:

• Database: Convex
• Mobile: Expo / React Native with Expo Router
• Styling: NativeWind v5 + Tailwind CSS v4
• Admin: Next.js 14+ (when needed)
• Auth: Convex Auth

Requirements

• Node.js 18+
• Claude Code CLI
• For Max mode: CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS enabled (handled by scaffolded settings.json)

License

MIT