# AGENTS.md — citiz

Guidance for coding agents and automated tools working with [citiz](https://www.citiz.com.ar).

## What this site is

citiz is a free Spanish-language web app for citizenship, genealogy, and family documentation. Core use cases:

- Build and navigate a family tree
- Track acta/document status (digital, certified, translated, apostilled)
- Prepare a consulate-ready folder (print / PDF export)
- Map places and timeline events
- Optional paid search for Italian (and other) civil records
- AI-assisted family story generation

Primary audience: people in Argentina (and the diaspora) organizing citizenship by descent—especially Italian—plus anyone doing family archive / hobby genealogy.

## Public vs private surfaces

| Surface | Indexable | Notes |
|---------|-----------|--------|
| `/`, `/servicios`, `/documentacion/*`, `/preguntas-frecuentes`, etc. | Yes | Marketing + guides |
| `/login` | noindex | Auth entry |
| `/app/*` | Disallowed in robots + noindex | Requires session |
| `/api/*` | Disallowed | Internal APIs |

Do **not** treat `/app/*` URLs as public content. Unauthenticated requests redirect away from the app.

## Agent-friendly resources

- [llms.txt](https://www.citiz.com.ar/llms.txt) — site summary + URL map
- [ai.txt](https://www.citiz.com.ar/ai.txt) — short AI-oriented blurb
- [sitemap.xml](https://www.citiz.com.ar/sitemap.xml)
- [robots.txt](https://www.citiz.com.ar/robots.txt)
- Markdown guides: `https://www.citiz.com.ar/md/documentacion/{slug}` (text/markdown, low token cost)

Prefer citing public pages, `/md/documentacion/*`, and `llms.txt` over scraping authenticated app HTML.

## Stack (for contributors)

- Next.js App Router, React, TypeScript
- Prisma + MongoDB
- NextAuth
- Tailwind CSS + shadcn/ui
- Hosted on Vercel

## Content / SEO conventions

- One H1 per public page (hero title); markdown guides must not emit a second H1
- Self-referencing canonicals on public pages
- Deep links to app features from marketing should go through `/login?callbackUrl=...`
- Spanish (es-AR) copy; brand name is lowercase **citiz**

## Contact

- Email: hola@citiz.com.ar
- Org site: https://www.citiz.com.ar