# Frank Martinez
> Personal site and AI agents terminal for Frank Martinez (Seattle, WA): RAG chat about Frank, collaboration matching, fractional executive offerings (CTO / CPO / CSO), and project portfolio.

Frank Martinez is a technology, product, and security executive focused on AI-native teams and products. This site is the public entry point for humans and agents.

Important notes for agents:
- Prefer the markdown files linked below over scraping the terminal UI (the home page is a client-heavy chat shell).
- Public health endpoints are read-only and safe to probe. Authenticated routes (journal, vector admin, knowledge writes) require owner login and must not be called without credentials.
- To contact Frank or schedule a meeting, direct humans to the terminal chat at the home page, or use the email on the fractional page.
- Do not invent availability, employment status, or commitments; use linked sources or the live chat agent.

## Pages
- [Home / AI agents terminal](https://frankmartinez.ai/): Browser terminal to ask questions about Frank (RAG), schedule meetings, contact Frank, or run `/match` for collaboration interviews
- [Fractional executive offering](https://frankmartinez.ai/fractional.md): Markdown summary of fractional CTO, CPO, and CSO services for AI startups (preferred for agents)
- [Fractional page (HTML)](https://frankmartinez.ai/fractional): Human-facing terminal-styled page for the same offering
- [Portfolio](https://frankmartinez.ai/portfolio): Public GitHub repositories for user `deboboy`
- [Recently shipped](https://frankmartinez.ai/shipped): Production highlights from PocketForeman, Field Pipeline, AMP, EB Automate, and Agent Phone
- [About (markdown)](https://frankmartinez.ai/about.md): Who Frank is, how to use this site, and contact guidance for agents

## Agents & product flows
- [RAG chat](https://frankmartinez.ai/): Answers questions about Frank from a private knowledge base; guests are read-only; owners can add facts
- [Match interview (Ixchel)](https://frankmartinez.ai/): Type `/match` in the terminal (or use `/match` page) for an AI project collaboration interview and profile email
- [Match page](https://frankmartinez.ai/match): Standalone match interview UI

## Public API (read-only health)
- [Gemini health](https://frankmartinez.ai/api/gemini/health): LLM provider connectivity check (legacy alias: `/api/blackbox/health`)
- [Calendar health](https://frankmartinez.ai/api/calendar/health): Google Calendar connectivity check
- [EspoCRM health](https://frankmartinez.ai/api/espocrm/health): CRM connectivity check (when configured)
- [Client IP](https://frankmartinez.ai/api/ip): Returns requester IP (utility)

## Collaboration Match API (agent access)
- [OpenAPI — Match](https://frankmartinez.ai/openapi/match.json): Sessioned interview API schema
- [POST /api/v1/match/sessions](https://frankmartinez.ai/api/v1/match/sessions): Start interview; returns `sessionId` and first question
- [POST /api/v1/match/sessions/{id}/answers](https://frankmartinez.ai/api/v1/match/sessions): Submit answer; returns next question or completed profile (`strongMatch` when score is high)
- [GET /api/v1/match/sessions/{id}/profile](https://frankmartinez.ai/api/v1/match/sessions): Fetch profile (null until complete)
- [POST /api/v1/match/sessions/{id}/contact](https://frankmartinez.ai/api/v1/match/sessions): Email profile + CRM lead
- [MCP tools](https://frankmartinez.ai/api/sse): `match_start`, `match_answer`, `match_get_profile`, `match_submit_contact` (same domain as REST)

## Identity & crawl
- [robots.txt](https://frankmartinez.ai/robots.txt): Crawl rules; points agents at `/llms.txt` and `/sitemap.xml`
- [sitemap.xml](https://frankmartinez.ai/sitemap.xml): Indexable pages and markdown sources
- HTML pages include schema.org JSON-LD (`Person`, `WebSite`, and on `/fractional` `ProfessionalService`)

## Optional
- [This file](https://frankmartinez.ai/llms.txt): Agent discovery index (llmstxt.org)
- [Project README (GitHub)](https://github.com/deboboy/fm-ai10): Source repository and setup notes
- [Shared sandbox collaboration plan](https://github.com/deboboy/fm-ai10/blob/main/docs/SHARED_SANDBOX_COLLAB_PLAN.md): Planned post-match Vercel Sandbox + Docker + Hermes workflow (not shipped yet)
- [Match MCP / collaboration graph plan](https://github.com/deboboy/fm-ai10/blob/main/docs/MATCH_MCP_PLAN.md): Domain API + MCP tools for the match system
- [MCP transport](https://frankmartinez.ai/api/sse): Vercel MCP adapter (`basePath` `/api`); tools: `match_start`, `match_answer`, `match_get_profile`, `match_submit_contact`