therr-app

Audit changed TherrMobile files for the React Native failure classes that crash at runtime rather than at build time — native modules touched at import time, missing effect cleanup, unguarded navigation params and API responses, and system-bar/safe-area regressions. Fixes the safe ones, reports the rest, then verifies with the mobile tsc baseline and Jest.

Verify the full wiring matrix when a TherrMobile dependency is added, upgraded, or removed — which package.json owns it, Metro resolution and singleton blocking, Babel and tsconfig aliases, Jest mocks and transform patterns, patch-package version drift, and whether a native rebuild or pod install is required. Catches the module-resolution failures that only surface at runtime on device.

Go/no-go gate before cutting an Android or iOS build of a Therr mobile app. Verifies brand and branch agree, versionCode/versionName were bumped, patch-package patches match installed versions, no deprecated Android 15 APIs are referenced, locales are in parity, and the tsc baseline, lint, and Jest suites are green — then checks Play release notes and records post-release follow-ups.

Peer review the diff between general and stage branches. Implements low-risk improvements, fixes bugs, adds regression tests for bugfixes where valuable, resolves quality issues, and notes deployment steps. Runs local integration tests when the diff touches backend services (requires Docker Compose infrastructure for that case only).

Generate Knex migration files in the correct service and schema per docs/NICHE_APP_DATABASE_GUIDELINES.md. Enforces schema isolation (main.* core, habits.* / <niche>.* for niche features), correct naming convention, and up/down symmetry. Prevents the highest-cost mistake class in the backend — putting niche-specific tables on the main schema.

Check whether recent commits have made the root CLAUDE.md, docs/README.md, or key docs stale — new packages not listed, changed build commands, dependency version drift, new brand variants, or product changes that invalidate documented strategy. Run deliberately after a batch of work or before a release, not on every session.

Saves durable facts to context/MEMORY.md. Triggers on "remember this", "note that", "update memory", "save this", "forget about". Three actions: add (append under correct section), replace (substring match + swap), remove (confirm with user first). Enforces 2,500 char cap with dedup guard.

Read docs/WORK_IN_PROGRESS.md and propose a contained, near-term batch of highest-priority items to tackle next. Reconciles tier priority with the current git branch's deploy reality, surfaces unchecked Manual Operational Follow-ups, clusters related TODOs into one coherent commit/PR, and either starts implementation or asks the user the few decisions needed first.

Peer review the **new work** on the current niche/* branch (vs origin/<NICHE_BRANCH> on a -general branch, or vs origin/niche/<TAG>-general on a feature branch). Separately detects backend and shared-library leaks against origin/general (these would never reach production via stage→main) and cherry-picks clean backend-only commits introduced on this branch over to general. Implements low-risk improvements, fixes bugs, adds regression tests for bugfixes where valuable, and resolves quality issues. Requires local Docker Compose infrastructure to be running.

Audit SSR routes in therr-client-web for required SEO elements — OG tags, geo.position meta, hreflang for all 3 locales, sitemap inclusion, and LocalBusiness JSON-LD on space pages. Priority #1 in GROWTH_STRATEGY.md; silent regressions here kill organic indexing for weeks before Search Console surfaces them.

Measure the B2B claim funnel end-to-end (email sent → space page view → claim initiated → claim approved → paid subscription) against the Green/Yellow/Red thresholds in docs/GROWTH_STRATEGY.md. Reads from users-service and maps-service DBs; identifies the biggest drop-off and recommends the next highest-leverage action for a solo dev.

Verify translation dictionaries are in parity across all locales for a package, and flag hardcoded locale strings in code that matches against translated text. Enforces the CLAUDE.md rule "never add a key to one dictionary without adding it to all others".

Orchestrate B2B outreach email campaigns with preflight safety checks — SES bounce rate, blacklist freshness, dedupe counts, warm-up caps — then run throttled batches and report post-send metric deltas. Wraps scripts/import-spaces/send-unclaimed-emails.ts which per GROWTH_STRATEGY.md is the central activation lever for the 90-day revenue milestone.

Generate editorial guides and data-driven posts for /guides using production data (top spaces by city/category, activity stats). Writes static JSON to therr-client-web/src/content/guides/ for SSR rendering.

Decide whether TanStack Query (React Query) is appropriate for a proposed feature, and if so, scaffold it correctly per the repo's case-by-case adoption rules. Blocks misuse that would fragment state or duplicate Redux slices.

Run Android emulator/device, capture filtered React Native logs from ADB/logcat, and diagnose errors with source mapping. Designed for token-efficient remote debugging.

Analyze the current git branch and changed files to catch shared code committed to niche branches (or vice versa), and help navigate the branch strategy safely.

Run ESLint and TypeScript type-checking on changed or specified files, grouped by package. Required by CLAUDE.md before completing any code change.

Find business emails and websites for imported spaces by researching each business on the web, or use automated enrichment/import via manage-space CLI.