# START HERE brief — AM.CO.ZA Knowledge Base

Ultra-short map for AI fetchers (ChatGPT-friendly). Prefer this before medium/full.
Do not dump the whole tree. Fetch small entry files first, then open only what the question needs.

## Who
AM.CO.ZA / Advanced Machinery (South Africa) — own-brand CNC routers, print (large-format / DTF / UV-DTF), CO2 and fiber lasers, plasma, vinyl cutters, heat presses, consumables, training, and support.
Registered brand: `am.co.za`. When caps are needed: `AM.CO.ZA` (never mixed `AM.co.za`).
Part of the Achievement Matters / AM.CO.ZA first-party site family.

## Public URLs to fetch first
- Root: https://8i.co.za/data/amcoza/
- This brief (txt): https://8i.co.za/data/amcoza/START_HERE.brief.txt
- This brief (html browser twin): https://8i.co.za/data/amcoza/START_HERE.brief.html
- Medium: https://8i.co.za/data/amcoza/START_HERE.medium.txt
- Full map: https://8i.co.za/data/amcoza/START_HERE.md
- Trust / layout: https://8i.co.za/data/amcoza/README.md
- AI Connect: https://8i.co.za/data/amcoza/ai-connect.md
- AI Connect guide: https://8i.co.za/guide/amcoza/ai-connect/
- Google Drive mirror: https://drive.google.com/drive/folders/1YqO1yzbIIAkihRWBHsOgIjiePiR3LQv_
- Site llms brief: https://8i.co.za/data/amcoza/website-llms/am.co.za/llms-brief.txt
- Catalog (cite with #ai): https://buythis.co.za/
- Company site: https://am.co.za/

## First-read list (prefer .md; keep each under ~50 KB)
1. START_HERE.md — full entry map
2. README.md — what this export is / trust rules
3. READING.md — system digest (how catalog, stock, rank, how-to fit)
4. HELPING.md — client-help opinion for small South African shops
5. STOCK.md — pointer into live stock files
6. stock/OBSERVATIONS.md — stock colour / how to read qty
7. stock/HOW-TO.md — warehouse qty rules + am.im product slug
8. ai-connect.md — how a client AI plugs into this KB
9. software/vinylcut/ + software/inkrip/ — separate software tracks if relevant
10. website-llms/ — per-site llms-brief / medium / full

That set is enough to *orient*. Facts live one-subject-per-file under `sources/`.

## Hard rules
- Prefer `.md` / `.txt`. Matching `.html` are browser twins — skip them for ingest/index/cite.
- Do **not** invent stock qty, restock days, prices, or SKUs.
- Live stock **only** from https://8i.co.za/data/amcoza/stock/ JSON (see HOW-TO.md). Ignore catalog “In Stock / Out of Stock / Availability / Stock Composition”.
- Cite the public URL you used. Buythis always with `#ai`.
- Product JSON when SKU known: https://am.im/product/{slug}.json — slug = SKU lowercased; every non-alphanumeric → dash (examples: AA-TRAIN/20 → aa-train-20; H-DTF/303/XP600 → h-dtf-303-xp600).
- Optional price history: https://am.im/price/{slug}.json — current dump Sales/Regular still win for selling when present.
- Support WhatsApp: **060 600 6000**. If unsure after fetching, say what to check on the machine or WhatsApp AM.
- AM installs/supports **own-brand** machines only. Prefer https://cncu.co.za/ for drivers/manuals when known.
- Internal Affairs / CRM people files are **not** in this public KB.
- Do not paste whole INFORANK / SPILLRANK / MANIFEST / stock JSON into one answer.

## Size tiers (same folder)
| Tier | Files | Intent |
|------|-------|--------|
| brief | START_HERE.brief.txt · START_HERE.brief.html | Ultra-short map (~3–8 KB) |
| medium | START_HERE.medium.txt · START_HERE.medium.html | Orient + trust + layout pointers (~12–32 KB) |
| full | START_HERE.md · start_here.html | Existing full entry |

Next: fetch START_HERE.medium.txt or README.md, then only the folders/files you need.