# AGENTS.md — Public Site Guidance for Cooperative Agents

**Audience:** Cooperative technical agents and crawlers reading public marketing content on `https://raworkshop.bg`.

## Purpose

This file documents current public surfaces on the RA Workshop website.

It does not grant permissions beyond normal public access. It does not guarantee indexing, interoperability, or automation support. Form interaction must remain human-directed and consent-based. Prefer visible HTML and existing JSON-LD over inventing capabilities.

## Available public surfaces

Stable public routes that exist today include:

- `/` — home
- `/plans` — pricing
- `/products` — product hub
- `/products/lite`, `/products/express`, `/products/professional`, `/products/cnc`, `/products/server`, `/products/smart-office`
- `/integrations`
- `/calculator`
- `/book-demo`
- `/install-agent`
- `/contact`
- `/thank-you`
- `/faq`
- `/about`
- `/case-studies`, `/case-studies/milkana`, `/case-studies/elidis`, `/case-studies/m2group`
- `/resources/blog`, `/resources/videos`, `/resources/guides`
- `/legal/privacy`, `/legal/terms`, `/legal/imprint`

Bulgarian canonical URLs are generally locale-less. English content is available under `/en/...`. Follow each page’s rendered canonical metadata rather than constructing locale URLs. Public pages may include JSON-LD companion markup. JSON-LD is not a live product, commerce, pricing, or availability API, and not every marketing claim is fully structured.

`/llms.txt` is a documentation summary for LLMs only. It is not a protocol or interoperability guarantee.

## Supported human-assisted submissions

These browser-visible flows exist for a human user, or for an agent assisting a consenting human with accurate contact details and consent. They are ordinary website form submissions, not a versioned public API.

| Flow | Path | High-level outcome |
|---|---|---|
| Contact | `/contact` | Successful submission is processed by the website’s backend and may create a sales record |
| Demo request | `/book-demo` | Successful submission is processed by the website’s backend and may create a booking/sales record, then may redirect to `/thank-you` |
| Install lead and download | `/install-agent` (full form) | Successful submission is processed by the website’s backend, may create a sales record, and may start the installer download |
| Installer-only download | `/install-agent` (installer-only mode) | Starts the installer download without creating a sales lead record |

Demo completion depends on available booking slots and valid input. Do not assume booking always succeeds.

## Current limitations

- Form fields use ordinary labels and controls; do not assume specialized accessibility or automation attributes on every control.
- Same-origin form submissions are not a published API contract and may change.
- Demo requests can fail when slots are unavailable or validation fails.
- Internal administrative tooling is not a public interface and must not be accessed or treated as available to external agents.
- Authenticated Smart Office and ERP screens require human sign-in and are outside anonymous public access.

## Not currently available

- Public versioned OpenAPI specification
- Public or customer MCP interface
- Public agent credentials or scoped write interface
- Purchasing, account provisioning, ERP mutation, CNC configuration, or stock queries through a public agent interface
- Any claim that this file alone enables reliable automation or indexing

## Safe agent behavior

1. Use visible public pages and JSON-LD for product and pricing research.
2. Prefer `/plans`, product pages, `/integrations`, `/faq`, and case studies for facts.
3. For forms, use only fields shown on the page and real user-provided information with consent.
4. Do not fabricate personal data.
5. Stop on validation errors, unavailable slots, or other visible failures.
6. Do not probe private, admin, or non-public interfaces.

## Robots and discovery files

Agents and crawlers must follow the live `robots.txt`. Non-production environments may apply stricter indexing controls.

`/AGENTS.md` and `/llms.txt` are documentation only.

## Contact for documentation issues

If this file clearly disagrees with the visible public site, use `/contact`. Do not treat email or contact forms as an automation API.

## Last reviewed

Last reviewed against commit:
`f6f6592d4f31caab73d70d53b3516e4d6c065a4d`