# NurtureMe SEO & Technical Context (llms.txt)

> This document provides LLMs and agents with the necessary context, architecture, and business logic to understand and contribute to the NurtureMe SEO Platform.

## 1. Product Overview & Business Context

**NurtureMe** is an end-to-end, AI-powered recruiting and workforce management platform. Unlike traditional Applicant Tracking Systems (ATS) like Greenhouse or Workable that merely *store* data, NurtureMe leverages AI agents to *do the actual recruiting work* and continues managing employees through onboarding, retention, and workforce forecasting.

### Target Audience & Market
- **Primary Industries:** Home Services (Pest control, HVAC, Roofing, Solar, Windows), Sales-heavy teams (Insurance, MCA).
- **Company Profile:** $5M+ annual revenue, 50+ employees, operating in the US and Canada.
- **Key Pain Points Solved:** 
  - Manual recruiting work taking too much time.
  - High candidate no-show rates and "ghosting".
  - High turnover / poor retention.
  - Misaligned hiring forecasting (e.g., seasonal peaks in HVAC).

## 2. Platform Architecture & Tech Stack

The application is built around a modern, high-density React ecosystem with full-stack type safety. 

### Core Tech Stack
- **Framework:** Next.js 15 (App Router)
- **UI & Animation:** React 19, Tailwind CSS v4 (`@tailwindcss/postcss`), GSAP, Framer Motion
- **Full-Stack API:** tRPC (`@trpc/server`, `@trpc/client`, `@trpc/react-query`)
- **Database & State:** Prisma ORM (with PostgreSQL via `@prisma/adapter-pg`), TanStack Query v5 (React Query)
- **Programmatic Media:** Remotion (for programmatic SEO video generation)

### NurtureMe Core AI Agents
NurtureMe operates primarily through highly specialized AI agents:
- **Ava (Resume Screener):** Screens, ranks, and filters hundreds of resumes automatically. 
- **Stella (Recruiter & Outreach):** Contacts candidates via SMS/Email/Phone, handles follow-ups, and books interviews.
- **Mia (AI Interviewer):** Conducts conversational first-round interviews via Zoom/Teams/Meet and generates candidate evaluation reports.
- **Friendzy (Candidate Sourcing):** A standalone sourcing engine that bypasses traditional, expensive job boards using AI targeting and gamified candidate experiences.

## 3. Repository Structure

The `c:\Coding\SEO_NURTUREME` directory contains both the technical dashboard implementation and the foundational SEO data and content systems.

- `/dashboard/`: The main Next.js codebase.
  - `src/app/`: Next.js App Router definitions.
  - `src/server/`: Backend layer containing tRPC routers, queries/mutations, and backend utilities.
  - `src/components/`: Reusable React frontend components.
  - `prisma/`: Database schemas (`schema.prisma`) and seed definitions.
- `/content/`: The raw SEO content layer (e.g., case studies, programmatically generated articles).
- `/scripts/` & Python Root Scripts (`.py`): SEO analytics, keyword research (DataForSEO), and content pipeline handlers.
- **Business Logic & Guidelines:** Files like `_business_guide.txt`, `NurtureMe SEO Onboarding Document.md`, and `nurtureme_topical_map.md` house the core GTM (Go-To-Market) and topical SEO strategies.

## 4. SEO & Content Generation Strategy

NurtureMe's SEO strategy is driven by the **Princeton GEO Framework** (arXiv:2311.09735), which focuses on maximizing visibility in AI search engines (Perplexity, Google SGE). 

### GEO Framework Optimization Rules
When generating content or modifying the platform's SEO pages, the following rules are strictly enforced:
1. **Citations & Backlinks:** 2-3 accurate citations per major section.
2. **Data & Statistics:** Minimum 5 statistics per article, bolded for visibility.
3. **Format & Structure:** Mandatory comparison tables, bulleted lists, and Mermaid.js diagrams.
4. **Tone:** Authoritative, confident (Grade 6-8 reading level).
5. **Direct Integration:** Content consistently maps industry-specific pain points (e.g., "seasonal HVAC hiring spikes") directly to NurtureMe's AI Agents (e.g., "Forecasting + Stella").

### Content Pillars (Topical Map)
The topical map (`nurtureme_topical_map.md`) consists of 7 pillars targeting high-intent commercial and navigational keywords:
1. AI Interview & Pre-Screening ($10+ CPC)
2. AI Scheduling & Appointment Setting ($40-60+ CPC)
3. AI Resume Screening & Sourcing
4. Home Services Recruiting (Pest, HVAC, Roofing)
5. Insurance & Healthcare Recruiting (Seasonal)
6. Enterprise Recruiting & Consulting ($20k+ deals)
7. Competitor Comparisons (Greenhouse, Workable, HireVue)

## 5. Development Guidelines
- Always prioritize type safety across the tRPC boundary. 
- The project runs on standard package managers. The typical startup command is `npm run dev -- -p 3001` or `3000` inside the `/dashboard/` directory.
- For AI content generation in code (e.g., `article-generator.ts`), handle AI API responses defensively, ensuring robust JSON parsing.