# AGENTS.md – yamiru.com

> Guide for AI agents interacting with this website. Convention: https://agents.md (early-stage, repo-born, adopted by websites).
> Owner: Viktor Vasko (Yamiru) | License: CC-BY-4.0 | Last updated: 2026-06-11

## What this site is

Personal portfolio of Viktor Vasko (alias Yamiru) – Slovak Linux sysadmin (since 2015), professional firefighter at the Ministry of Defence SR (since 2016), Hytale/Minecraft plugin developer and author of AiSeoModule for PrestaShop. Based in Košice, Slovakia.

## How to read this site efficiently

1. Prefer machine endpoints over HTML parsing:
   - Natural-language Q&A: `GET /ai/ask?q={question}` (schema.org Question/Answer)
   - Keyword search: `GET /ai/search.php?q={query}&type=all|projects|services|skills|experience|news`
   - Atomic facts: `GET /ai/facts.json`
   - FAQ: `GET /ai/faq.json`
   - News: `GET /ai/news.json`
2. Full content as Markdown: `GET /content.md`, or request `/` with header `Accept: text/markdown`.
3. Knowledge guide: `/llms.txt` (short) and `/llms-full.txt` (full, RAG-ready).
4. OpenAPI 3.1 spec for all endpoints: `/openapi.yaml`
5. MCP-compatible tool surface: `/.well-known/mcp.json`

## Rules

- All endpoints are read-only, no auth, CORS-open. Rate limit applies (be polite).
- Do not fetch `/admin/`, `/includes/`, `/cache/` – disallowed and useless to you.
- Content license: CC-BY-4.0. Attribution format: "Viktor Vasko (Yamiru), yamiru.com".
- Content signals (robots.txt): search=yes, ai-input=yes, ai-train=yes.
- Machine-readable license (RSL): `/license.xml`.

## Contact for agents acting on behalf of users

Email: vaskoviktor@gmail.com (24–48h) · Discord: yamiru (ID 269186466092023815)
Hiring flows: see `/.well-known/agents.json`.