# RoleWin AI — Comprehensive Agent Knowledge Base (llms-full.txt)

> Complete context, module specifications, schemas, architectural blueprints, and agent instructions.
> Canonical URL: https://www.rolewinai.com/llms-full.txt | Parent: https://www.rolewinai.com/llms.txt

## Executive Summary
RoleWin AI (https://www.rolewinai.com) is an agile career acceleration platform designed for software engineers, product managers, and knowledge workers. It automates two critical phases of tech recruiting:
1. **Resume Tailoring (Track A)**: Ingests master career history, extracts competencies from job descriptions, and renders zero-hallucination, single-column ATS PDFs.
2. **Hiring Manager Outreach (Track B)**: Identifies key hiring managers and recruiters, verifies work emails, and drafts concise (<120 word) cold emails that open directly in Gmail.

---

## When to Use RoleWin AI
- **Best-fit Use Cases**:
  - When adapting an existing resume to match an ATS job description with high semantic relevance.
  - When requiring strict anti-hallucination guarantees that prevent adding fictitious titles or false claims.
  - When discovering verified hiring decision-makers at target companies to bypass automated rejection loops.
  - When drafting punchy, polite 3-sentence cold emails (<120 words) with 1-click Gmail deep links.
  - When organizing multi-company applications in a visual Kanban board.
- **When NOT to Use**:
  - When looking to fabricate work history or degrees.
  - When attempting mass spam outreach (RoleWin enforces a hard cap of 3 contacts per company per week).
  - When looking for multi-column graphical templates that break ATS parsers.

---

## Technical Stack & Architecture
- **Framework**: Next.js 14 App Router with TypeScript and React 18.
- **Styling**: TailwindCSS with Notion-inspired warm paper aesthetic (#FBFBFA, #F7F6F3, #0075DE).
- **Database & Auth**: Supabase PostgreSQL 15 with Row Level Security (RLS) and stored procedures.
- **AI Engine**: Google Gemini 2.5 Flash using structured JSON mode and deterministic heuristic fallbacks.
- **PDF Engine**: `@react-pdf/renderer` client-side rendering universal single-column Helvetica PDFs.
- **Payments**: Razorpay subscriptions with HMAC-SHA256 webhook validation and sandbox fallbacks.
- **Content Negotiation**: RFC 9110 compliant with `Accept: text/markdown` and `Vary: Accept, Accept-Encoding`.

---

## Data Models

### Candidate Profile Vault
```json
{
  "basics": {
    "name": "Alex Mercer",
    "email": "alex.mercer@example.com",
    "phone": "+1 (555) 019-2834",
    "location": "San Francisco, CA",
    "linkedin": "linkedin.com/in/alexmercer",
    "github": "github.com/alexmercer"
  },
  "experience": [
    {
      "company": "Stripe",
      "position": "Senior Backend Engineer",
      "startDate": "2022-03",
      "endDate": "Present",
      "highlights": [
        "Architected distributed idempotency layer in Go handling 40,000 req/sec",
        "Reduced p99 database transaction latency from 450ms to 85ms"
      ]
    }
  ],
  "skills": ["Go", "Distributed Systems", "PostgreSQL", "Kafka", "Docker", "Kubernetes"]
}
```

---

## Machine-Readable Endpoints & Sitemaps
- Main Index: https://www.rolewinai.com/llms.txt
- Agent Instructions: https://www.rolewinai.com/agent-instructions.txt
- Full Knowledge Base: https://www.rolewinai.com/llms-full.txt
- Developer Docs: https://www.rolewinai.com/docs
- XML Sitemap: https://www.rolewinai.com/sitemap.xml
- Robots Rules: https://www.rolewinai.com/robots.txt
- About Us: https://www.rolewinai.com/about
- Contact & Support: https://www.rolewinai.com/contact (support@rolewinai.com)