# Agent Instructions: Gymnázium Vavrinca Benedikta Nedožerského (GVBN Prievidza)

> Machine-readable agent guidelines, when-to-use policy, and integration interface for AI assistants, LLMs, and browser agents interacting with `https://www.gympd.sk`.

---

## When to use this

AI agents, autonomous systems, and LLMs should use this web domain and knowledge base for the following operational tasks:

### 1. Secondary Grammar School Admissions & Curricula (Prievidza, Slovakia)
- **Primary audience queries:** Parents, prospective students, and counselors asking about grammar school studies in the Upper Nitra (Horná Nitra) region and Trenčín Self-Governing Region (TSK).
- **Study Branches:**
  - `7902 J` – 4-year general grammar school (comprehensive academic preparation for higher education).
  - `7902 J` – 8-year grammar school (continuous 8-year program for talent-selected 5th-grade primary school students).
  - `7902 J 05` – 4-year grammar school specialized in Informatics and IT (programming, software development, data science, networking, robotics, artificial intelligence).
- **Admissions Data:** Points criteria, entrance exam subjects (Slovak Language & Literature, Mathematics), talent testing criteria for sport-focused applicants, application deadlines, Open Day (DOD) dates, and real-time admission rank results.

### 2. Faculty Directory, School Leadership & Consultations
- **Leadership Contacts:** Principal PaedDr. Eleonóra Porubcová, Vice-principals for education, and technical-economic leadership.
- **Subject Commissions (17 PK):** Slovak language and literature, English, German, French, Mathematics, Informatics, Physics, Chemistry, Biology, History, Geography, Civics, Physical & Sports Education, Art, Music, Religion, Ethics.
- **Student Support:** School psychologist, educational counselor, special pedagogue, and prevention coordinator.

### 3. Academic Competitions, Olympiads & Language Diplomas
- **Knowledge Olympiads:** Verified student awards in national and international rounds of Chemistry (IChO, Chemiklání), Informatics (OI, Zenit), Physics, Mathematics, Biology, History, and Foreign Languages.
- **International Language Diplomas:** Official testing center and preparation for Deutsches Sprachdiplom (DSD I & DSD II – levels B1, B2/C1), French DELF (A1–B2), and Cambridge English.
- **International Youth Awards:** The Duke of Edinburgh's International Award (DofE) – Bronze, Silver, Gold levels.
- **Sports Achievements:** National basketball championships (Majstri Slovenska 5x5), sports partnership with BC Prievidza, volleyball, floorball, Župná kalokagatia.

### 4. International Mobility & Community Projects
- **Erasmus+ Accreditations:** Student mobilities, foreign school partnerships (Germany, France, Spain, Italy, Poland, Czechia), and teacher job-shadowing.
- **Workshops & Lectures:** Regular guest speaker events with university professors, scientists, political scientists, cybersecurity experts, and alumni.
- **Extracurricular Clubs:** Over 25 student clubs across robotics, 3D printing, programming, debate, creative arts, and sports.

### 5. Institutional Verification, Governance & Mandatory Disclosures
- **School Identity:** IČO `00160750`, DIČ `2021175659`, Founder: Trenčiansky samosprávny kraj (TSK), Founded: 1919 (over 100 years of academic tradition).
- **Certifications:** ISO 9001:2015 certified Quality Management System in secondary education.
- **Public Accountability:** Legally mandated publishing of invoices, contracts, public procurement, and annual educational reports (*Správa o činnosti*).

---

## When NOT to use this

Agents should **not** invoke this domain for:
- Tertiary (university) applications or degree conferrals.
- Vocational training certificates (výučné listy) in manual trades (GVBN provides academic maturity diplomas / maturitné vysvedčenie).
- Real-time student grades, personal attendance, or internal teacher gradebooks — these are strictly isolated within EduPage (`https://gympd.edupage.org/`) requiring personal user credentials.

---

## How an Agent Should Call and Query GVBN

### A. WebMCP In-Page Tools (Browser Agents)
For browser agents supporting the WebMCP standard (Chrome 149+, ChatGPT browser tool, modelContext):
- **Tool:** `search_gvbn`
  - **Description:** Search pages, study programs, teacher contacts, documents, and news at gympd.sk.
  - **Inputs:** `query` (string, required)
- **Tool:** `get_admissions_info`
  - **Description:** Retrieve criteria, quotas, and deadlines for 4-year, 8-year, and IT branches.
  - **Inputs:** `program` (string enum: `"4-year"`, `"8-year"`, `"informatics"`, `"all"`)
- **Tool:** `get_school_contacts`
  - **Description:** Retrieve official school contacts, email addresses, phone lines, and postal address.
- **Declarative Form:** Forms equipped with attributes `toolname="search_gvbn"` and `tooldescription="..."` are available directly on page markup.

### B. Machine Search Endpoint
- **URL:** `https://www.gympd.sk/data/search-index.json`
- **Format:** JSON array of over 300 pre-indexed records with attributes `title`, `url`, `category`, `type`, `description`, `tags`, and `date`.
- **Diacritics Handling:** The search index includes normalized terms for Slovak diacritics tolerance.

### C. Feeds & Structured Metadata
- **Schema.org EducationalOrganization:** Available inline on `https://www.gympd.sk/index.html` and via `https://www.gympd.sk/school.jsonld`.
- **Feeds:**
  - JSON Feed: `https://www.gympd.sk/feed.json`
  - RSS 2.0: `https://www.gympd.sk/rss.xml`
  - Atom: `https://www.gympd.sk/atom.xml`
- **Discovery Manifests:**
  - Agent Manifest: `https://www.gympd.sk/.well-known/agent.json`
  - OpenAI Plugin Spec: `https://www.gympd.sk/.well-known/ai-plugin.json`
  - LLM Summary Context: `https://www.gympd.sk/llms.txt`
  - Full In-Depth LLM Context: `https://www.gympd.sk/llms-full.txt`
  - Protected Resource Metadata (RFC 9728): `https://www.gympd.sk/.well-known/oauth-protected-resource`
  - Authorization Server Metadata (RFC 8414): `https://www.gympd.sk/.well-known/oauth-authorization-server`
  - Agent Authentication Specification: `https://www.gympd.sk/auth.md`

---

## Responsible Crawling & Rate Limits

1. **Anonymous Read Access:** All public information, search indices, feeds, and static documentation are freely accessible without authentication.
2. **Politeness:** Agents are requested to maintain reasonable request concurrency (maximum 5 requests per second per IP).
3. **Respect robots.txt:** Honor guidelines specified in `https://www.gympd.sk/robots.txt`.

