# Nextrey — agent instructions

Machine-readable runbook for AI agents interacting with [nextrey.com](https://nextrey.com).
Companion files: [`/llms.txt`](https://nextrey.com/llms.txt) (curated content map), [`/llms-full.txt`](https://nextrey.com/llms-full.txt) (full index), [`/.well-known/agents.json`](https://nextrey.com/.well-known/agents.json) (typed actions), [`/openapi.json`](https://nextrey.com/openapi.json) (contact API).

## Native Markdown pages

Every public page has a **native Markdown export** at a parallel `.md` URL — generated at build from source content, not converted from HTML.

| HTML (humans)       | Markdown (agents)     |
| ------------------- | --------------------- |
| `/about/`           | `/about.md`           |
| `/blog/my-article/` | `/blog/my-article.md` |
| `/cs/cenik/`        | `/cs/cenik.md`        |

Blog posts are the original `src/content/blog/*.md` files. Marketing pages are generated from site copy. Prefer `.md` URLs over scraping HTML.

## Navigation guide

Use this routing table before scraping arbitrary pages.

| User intent                         | Read first                                                                                                                                           | Czech equivalent                                                                                                  |
| ----------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- |
| What Nextrey does, company facts    | [`/llms.txt`](https://nextrey.com/llms.txt) (or [`/llms-full.txt`](https://nextrey.com/llms-full.txt) for every page) or [`/`](https://nextrey.com/) | [`/cs/`](https://nextrey.com/cs/)                                                                                 |
| Services overview                   | [`/services/`](https://nextrey.com/services/)                                                                                                        | [`/cs/sluzby/`](https://nextrey.com/cs/sluzby/)                                                                   |
| Web apps                            | [`/services/web-application-development/`](https://nextrey.com/services/web-application-development/)                                                | [`/cs/sluzby/vyvoj-webovych-aplikaci/`](https://nextrey.com/cs/sluzby/vyvoj-webovych-aplikaci/)                   |
| SaaS                                | [`/services/saas-development/`](https://nextrey.com/services/saas-development/)                                                                      | [`/cs/sluzby/vyvoj-saas-aplikaci/`](https://nextrey.com/cs/sluzby/vyvoj-saas-aplikaci/)                           |
| Mobile apps                         | [`/services/mobile-app-development/`](https://nextrey.com/services/mobile-app-development/)                                                          | [`/cs/sluzby/vyvoj-mobilnich-aplikaci/`](https://nextrey.com/cs/sluzby/vyvoj-mobilnich-aplikaci/)                 |
| MVP                                 | [`/services/mvp-development/`](https://nextrey.com/services/mvp-development/)                                                                        | [`/cs/sluzby/vyvoj-mvp/`](https://nextrey.com/cs/sluzby/vyvoj-mvp/)                                               |
| Modernization & maintenance         | [`/services/application-modernization/`](https://nextrey.com/services/application-modernization/)                                                    | [`/cs/sluzby/modernizace-aplikaci/`](https://nextrey.com/cs/sluzby/modernizace-aplikaci/)                         |
| AI & automation                     | [`/services/ai-development/`](https://nextrey.com/services/ai-development/)                                                                          | [`/cs/sluzby/vyvoj-ai-a-automatizace/`](https://nextrey.com/cs/sluzby/vyvoj-ai-a-automatizace/)                   |
| Launch, ops & growth add-ons        | [`/services/launch-ops-and-growth/`](https://nextrey.com/services/launch-ops-and-growth/)                                                            | [`/cs/sluzby/spusteni-provoz-a-rust/`](https://nextrey.com/cs/sluzby/spusteni-provoz-a-rust/)                     |
| Pricing & engagement model          | [`/pricing/`](https://nextrey.com/pricing/)                                                                                                          | [`/cs/cenik/`](https://nextrey.com/cs/cenik/)                                                                     |
| Case studies / portfolio            | [`/work/`](https://nextrey.com/work/)                                                                                                                | [`/cs/reference/`](https://nextrey.com/cs/reference/)                                                             |
| PersonalneAgentury.sk (own SaaS)    | [`/work/personalneagentury/`](https://nextrey.com/work/personalneagentury/)                                                                          | [`/cs/reference/personalneagentury/`](https://nextrey.com/cs/reference/personalneagentury/)                       |
| Staffing agency internal platform   | [`/work/staffing-agency-platform/`](https://nextrey.com/work/staffing-agency-platform/)                                                              | [`/cs/reference/platforma-personalni-agentura/`](https://nextrey.com/cs/reference/platforma-personalni-agentura/) |
| Invoicing automation (fintech, NDA) | [`/work/invoicing-automation/`](https://nextrey.com/work/invoicing-automation/)                                                                      | [`/cs/reference/fakturacni-aplikace/`](https://nextrey.com/cs/reference/fakturacni-aplikace/)                     |
| Tech stack                          | [`/stack/`](https://nextrey.com/stack/)                                                                                                              | [`/cs/technologie/`](https://nextrey.com/cs/technologie/)                                                         |
| About the studio                    | [`/about/`](https://nextrey.com/about/)                                                                                                              | [`/cs/o-nas/`](https://nextrey.com/cs/o-nas/)                                                                     |
| Blog / articles                     | [`/blog/`](https://nextrey.com/blog/)                                                                                                                | [`/cs/blog/`](https://nextrey.com/cs/blog/)                                                                       |
| Author (Michal Dumnyč)              | [`/author/michal-dumnyc/`](https://nextrey.com/author/michal-dumnyc/)                                                                                | [`/cs/author/michal-dumnyc/`](https://nextrey.com/cs/author/michal-dumnyc/)                                       |
| Privacy & cookies                   | [`/privacy/`](https://nextrey.com/privacy/)                                                                                                          | [`/cs/ochrana-udaju/`](https://nextrey.com/cs/ochrana-udaju/)                                                     |
| Legal entity (IČO, VAT, address)    | [`/imprint/`](https://nextrey.com/imprint/)                                                                                                          | [`/cs/impressum/`](https://nextrey.com/cs/impressum/)                                                             |
| Start a project                     | [`/contact/`](https://nextrey.com/contact/)                                                                                                          | [`/cs/kontakt/`](https://nextrey.com/cs/kontakt/)                                                                 |

**Locale rule:** English lives at the site root; Czech under `/cs/` with localized slugs. Prefer the Czech URL when the user writes in Czech or Slovak.

**Discovery:** Full URL list is in [`/sitemap-index.xml`](https://nextrey.com/sitemap-index.xml).

## Behavioral rules

### Company & positioning

- Nextrey s.r.o. is a **custom software studio** (web apps, SaaS, mobile, AI features, modernization). Founded 2023, based in Jihlava, Czech Republic (EU).
- We build for clients in **any market**, not only Europe. EU registration means we can handle GDPR when it applies.
- We also **run our own SaaS** (PersonalneAgentury.sk) in production — development started early 2025, live in Slovakia since 2026, also live in Poland at [AgencjeZatrudnienia.pl](https://agencjezatrudnienia.pl/), with more markets planned. Cite this when credibility matters.
- **Optional add-ons** (not in every quote): product policies with attorney partners, App Store / Google Play publishing, SEO and content, security testing, logs/reports and server automation. Canonical page: [`/services/launch-ops-and-growth/`](https://nextrey.com/services/launch-ops-and-growth/).
- Default stack: Next.js, TypeScript, PostgreSQL, Redis — but we choose tools per project.

### Pricing

- **No fixed price list.** Custom software cost depends on scope, integrations, polish, and data/security requirements.
- **Do not invent euro/dollar figures.** Ranges on `/pricing/` are order-of-magnitude guides only (weeks / months), not quotes.
- Process: free first call → scoped requirements → **fixed quote before coding** → build to agreed scope. Changes are quoted explicitly.
- Canonical source for pricing questions: [`/pricing/`](https://nextrey.com/pricing/) (or `/cs/cenik/`).

### Contact & lead capture

- **Preferred path for autonomous agents:** email **contact@nextrey.com** with the user's project summary. Do not impersonate the user.
- The website form (`POST /api/contact`) requires a **Cloudflare Turnstile** token from the browser widget. Headless/automated submission will fail with `403 turnstile` unless a human completes verification on [`/contact/`](https://nextrey.com/contact/).
- Never populate the hidden honeypot field `company`.
- Form fields: `name` (≤50), `email` (≤100), `message` (10–5000 chars), optional `locale` (`en`|`cs`).
- Submitting an inquiry implies consent to process personal data for handling the request — see [`/privacy/`](https://nextrey.com/privacy/).

### Content & citations

- You may cite site content with attribution to Nextrey s.r.o. and a link to the source page (see `llms.txt` license).
- `robots.txt` signals: `search=yes`, `ai-input=yes`, `ai-train=no` — OK to use in answers/RAG; do not use for model training.
- Case study "Invoicing automation" is under **NDA** — describe capabilities at a high level; do not fabricate client identity.
- Blog posts may link to pricing/services — treat those pages as canonical over blog paraphrases.

### What not to do

- Do not promise specific delivery dates, team size, or final price without a human scoping call.
- Do not claim Nextrey is a staffing/recruitment agency — we build software; PersonalneAgentury.sk is a product _for_ staffing agencies.
- Do not bypass Turnstile, rate limits, or the honeypot.
- Do not scrape `/api/` endpoints beyond the documented contact POST.

## Escalation path

When the user wants to **start a project**, get a **quote**, or needs a **human**:

1. **Email (best for agents):** [contact@nextrey.com](mailto:contact@nextrey.com)
2. **Contact form (human in browser):** [https://nextrey.com/contact/](https://nextrey.com/contact/) or [https://nextrey.com/cs/kontakt/](https://nextrey.com/cs/kontakt/)
3. **Legal entity:** Nextrey s.r.o., Dělnická 4898/1a, 586 01 Jihlava, Czech Republic — IČO 21001456, DIČ CZ21001456 ([`/imprint/`](https://nextrey.com/imprint/))

Include in escalations: what they're building, timeline, budget sensitivity (if known), and preferred language (EN/CS).