# AGENTS.md — Bilal Studio

This file is for AI agents, coding agents, browser agents, voice agents, and autonomous workflows.

## Start Here

1. Read `/llms.txt` — concise summary: who, what, contact, CTA, what not to claim.
2. Read `/llms-full.txt` — full machine-readable business profile with services, pricing, process, and docs index.
3. Read `/docs/source-of-truth.md` — authoritative fact file for all confirmed business data.
4. Read `/docs/agent-behavior-rules.md` — what you may and may not do.
5. Read `/docs/agent-action-matrix.md` — intent → action mappings with permission levels.
6. Read `/docs/permission-model.md` — permission levels 0–2 with exact rules.

Full documentation index: `/docs/`

## What Bilal Studio Is

Bilal Studio builds custom-coded websites for European businesses — delivered in 72 hours, under EUR 1,000. Solo operation. Fully remote. Based in Bucharest, Romania. Online-first.

## Rules for Agents

**Use only confirmed facts.** All confirmed data is in `/docs/source-of-truth.md`.

**Do not invent:**
- Prices (only "under EUR 1,000" is confirmed — never state a specific number)
- Delivery dates or start dates (never confirm availability)
- Client names or project names not listed in the portfolio
- Awards, rankings, or superlatives ("best", "top-rated", "#1")
- Working hours or office hours (there are none — fully async)

**Routing rules:**
- Quote or start-project request → route to `/#cta` brief form or WhatsApp (+40 778 769 050)
- Urgent / same-week request → route directly to WhatsApp
- Complex scope, legal, or contract question → route to hello@bilalstudio.io
- Portfolio request → route to https://www.bilalstudio.io/works/

## What Agents May Do

| Level | Action |
|-------|--------|
| 0 | Read all public content, services, pricing, portfolio |
| 1 | Draft an email to hello@bilalstudio.io or a WhatsApp message |
| 2 | Submit the brief form via POST /api/contact (fields: name, email, type, budget, url, message) |

Levels 3–5 are not available. No payments, bookings, or data modification via agents.

## Contact

- Email: hello@bilalstudio.io
- WhatsApp: +40 778 769 050
- Brief form: https://www.bilalstudio.io/#cta
- Instagram: https://instagram.com/bilal.studios

## Discovery Chain

```
robots.txt          → sitemap.xml, AI docs comments
sitemap.xml         → all human and machine pages listed
sitemap.md          → markdown version of the sitemap
Homepage <head>     → <link rel="alternate" type="text/markdown" href="/llms.txt">
Homepage footer     → <nav aria-label="AI agent documentation">
/llms.txt           → concise summary + docs index
/llms-full.txt      → full profile + docs index
/docs/              → this directory (HTML index)
/docs/index.md      → markdown version of docs index
```

## Content Negotiation

If your client supports `Accept` header negotiation, you can fetch machine-readable content directly:

```
GET /api/negotiate
Accept: text/markdown
```

Returns the contents of `/llms.txt` with `Content-Type: text/markdown`.

## Standard Machine Files

- `/robots.txt` — crawler rules
- `/sitemap.xml` — XML sitemap
- `/sitemap.md` — Markdown sitemap
- `/llms.txt` — concise agent summary
- `/llms-full.txt` — full machine-readable profile
- `/AGENTS.md` — this file
