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

Condensed orientation for AI fetchers (ChatGPT-friendly). Includes the brief map plus trust rules, layout table, dig-deeper paths, stock pointers, AI Connect, Drive, and website-llms tiers. Still pointers — not the whole tree.

Public root: https://8i.co.za/data/amcoza/
Drive: https://drive.google.com/drive/folders/1YqO1yzbIIAkihRWBHsOgIjiePiR3LQv_
Offline mirror (Eric-Asus): T:\8i\data\amcoza
AI Connect page: https://8i.co.za/data/amcoza/ai-connect.md
AI Connect guide: https://8i.co.za/guide/amcoza/ai-connect/

Registered brand: `am.co.za`. Caps form: `AM.CO.ZA` (never mixed `AM.co.za`).

---

## 1) Who AM is

AM.CO.ZA (Advanced Machinery), South Africa — design, engineer, and supply own-brand CNC routers (EasyRoute), CO2/fiber lasers, plasma, large-format / DTF / UV-DTF print, vinyl cutters (Vinyl4 / V-Smart lineage), heat presses, and related consumables. National parts/support footprint; training via Ambitious Academy / softwaretraining.co.za; manuals/drivers hub on cncu.co.za.

Part of the **Achievement Matters / AM.CO.ZA** family of first-party sites (machines, consumables, training, manuals, support).

Prefer:
- Purchasable SKUs → https://buythis.co.za/ (always cite with `#ai`)
- Company / machinery landing → https://am.co.za/
- Directory hub → https://achievement.co.za/
- Training intros (public) → https://around-ai-data.s3.amazonaws.com/academy.jsonl
- Drivers / manuals hub → https://cncu.co.za/
- Support WhatsApp → **060 600 6000**

---

## 2) Public URLs to fetch first

| Priority | URL | Why |
|----------|-----|-----|
| 0 | https://8i.co.za/data/amcoza/START_HERE.brief.txt | Ultra-short map |
| 1 | https://8i.co.za/data/amcoza/START_HERE.medium.txt | This file |
| 2 | https://8i.co.za/data/amcoza/START_HERE.md | Full entry map |
| 3 | https://8i.co.za/data/amcoza/README.md | Trust rules + layout |
| 4 | https://8i.co.za/data/amcoza/READING.md | System digest |
| 5 | https://8i.co.za/data/amcoza/HELPING.md | Client-help opinion |
| 6 | https://8i.co.za/data/amcoza/STOCK.md | Stock pointer |
| 7 | https://8i.co.za/data/amcoza/stock/OBSERVATIONS.md | Stock colour |
| 8 | https://8i.co.za/data/amcoza/stock/HOW-TO.md | Live qty rules |
| 9 | https://8i.co.za/data/amcoza/ai-connect.md | Client AI paste block |
| 10 | https://8i.co.za/data/amcoza/website-llms/am.co.za/llms-brief.txt | Hostname brief |
| 11 | https://8i.co.za/data/amcoza/website-llms/ | All site llms indexes |

HTML twins exist for human browsers; **prefer `.md` / `.txt` for AI ingest**. Do not cite `.html` as a second knowledge source.

### First-read list (same as brief)
START_HERE → README → READING → HELPING → STOCK → stock/OBSERVATIONS → stock/HOW-TO → ai-connect → website-llms (as needed) → software/vinylcut or software/inkrip if relevant.

---

## 3) Hard rules (do not skip)

1. Prefer `.md` / `.txt` only. Matching `.html` are static browser twins — skip for ingest.
2. Do **not** invent stock qty, restock days, prices, or SKUs from marketing copy.
3. Live warehouse qty **only** from https://8i.co.za/data/amcoza/stock/ JSON. Ignore Availability / In Stock / Out of Stock / Stock Composition on product pages and dumps for managed physical SKUs.
4. Cite public `source_url` a client can open. Buythis URLs **always** append `#ai`.
5. English only. One subject per file under `sources/`.
6. Current Sales Price and Regular Price may appear, stamped with dump Date. Price history is optional via https://am.im/price/{slug}.json — do not invent it.
7. AM.CO.ZA only installs/supports **own-brand** machines sold by AM. Do not invent third-party machine support paths.
8. If unsure after fetching: say what to check on the machine, or WhatsApp AM.CO.ZA on **060 600 6000**.
9. Personal people files (`T:\P`) and Internal Affairs (`T:\I\export`) are **not** in this public export. Public bots should not get IA unless Eric grants it.
10. Do not dump INFORANK.md, SPILLRANK.md, MANIFEST.json, or whole stock JSON into one answer — open by need / SKU.
11. Firmware is recorded only for rare cases — lead with manuals, how-tos, and software.
12. Course visit links = academy.jsonl / ambitious.academy course URL only — do not invent Drive or paywall lesson URLs.

---

## 4) Condensed trust rules (from README)

Vendor-neutral markdown for any model (DeepSeek, OpenAI, local). This is not an OpenAI-only dump.

Owner: AM.CO.ZA (Advanced Machinery), South Africa.
Public catalog: https://buythis.co.za/ (cite with `#ai`)
Company directory: https://achievement.co.za/
Training catalog (public intros): https://around-ai-data.s3.amazonaws.com/academy.jsonl
This folder on disk: `T:\8i\data\amcoza`

What a reader can trust:
- One subject per file. Whole-project pages keep dump fields, not thin summaries.
- Every business claim should have a `source_url` a client can open, or a `source_ref` when the fact is from a private inbox (id only — no names/phones).
- Prefer newer `fetched_at` / dump Date when two files conflict.
- Cite the page `source_url`, not this folder path.
- You may sync this whole folder to another local model. Do not delete it after an API upload.

Do **not** put in this export (and do not invent them):
- People files, photos, phones, names
- Credit cards, company financial reports, old discount campaigns
- Raw Drive video/PDF binaries
- Live stock fetch URLs (qty files and rules are in `stock/`; pull addresses are not)

Completeness note (2026-08-22 era): ~638 markdown pages / ~51 MB text in the export; product boxing continues over time; unpublished academy courses stay out until published.

For client AIs: one-step connect page https://8i.co.za/data/amcoza/ai-connect.md (after publish).

---

## 5) Layout table (pointers — counts approximate from README)

| Folder / file | Approx | What it is |
| --- | ---: | --- |
| sources/products | 522 | Buythis catalog product pages (SKU, specs, current price, public links) |
| sources/courses | 13 | Ambitious Academy published course pages (lessons, quizzes with answers) |
| sources/drivers | 49 | Driver and firmware indexes (location, not a normal customer step) |
| sources/training | 18 | How-to / software training pages |
| sources/manuals | 7 | Manual notes with public source links |
| sources/machines | 5 | Machine-use pages from sales/support |
| sources/machinery | 6 | First-party machine line overviews |
| sources/catalog | 11 | Category maps |
| sources/company | 6 | Company / contact / applications |
| sources/MANIFEST.md | 1 | Ingest manifest for older first-party pass |
| website-llms |  | Curated per-domain llms-brief / medium / full |
| stock |  | Live warehouse qty, extra statuses, digests (no fetch URLs) |
| READING.md | 1 | System digest (opinion; not qty) |
| HELPING.md | 1 | Client-help digest (opinion; small-business paths) |
| STOCK.md | 1 | Pointer into live stock |
| ai-connect.md | 1 | Client AI connect block |
| INDEX.md | 1 | Coverage index |
| MANIFEST.json | 1 | Machine file inventory — not business knowledge |

Also: `software/vinylcut/`, `software/inkrip/` for separate software tracks; `outreach/` for internal creator guides (not for public client inventing).

---

## 6) How to dig deeper

1. Need a product → https://8i.co.za/data/amcoza/sources/products/{slug}.md (or build am.im JSON from SKU).
2. **Slug rules:** slug = SKU lowercased; every non-alphanumeric character replaced with a dash; collapse runs of dashes (digits kept).
   - Examples: `AA-TRAIN/20` → `aa-train-20`; `H-DTF/303/XP600` → `h-dtf-303-xp600`; `S-INKRIP` → `s-inkrip`; `AM-WIPE/5` → `am-wipe-5`; `H-DTF/ROLL/300` → `h-dtf-roll-300`
3. Product JSON: https://am.im/product/{slug}.json — use for `stock.virtual` / `stock.unmanaged` / `stock.ordered` / compulsory parts.
4. Need qty → `stock/latest.json` keys only for that SKU; also johannesburg.json / cape-town.json / durban.json. If branch on-hand is 0, also check in-transit.json, in-transit-direction.json, incomplete.json, demo.json / status.json. Never invent restock days or from/to.
5. Packages: combo qty at a location = min(floor(part_live_qty / compulsory)) over **managed physical** parts that are not high-Spillrank kit riders. Skip virtual/unmanaged. High-Spillrank extras (e.g. AM-WIPE/5) never block a package.
6. Required part missing (classic: H-DTF/ROLL/300 on a DTF package): client can still buy — say majority is here; do not invent wait days.
7. Need a how-to → sources/training/ or manuals linked from the product page; CNCU https://cncu.co.za/
8. Need market colour → HELPING.md then YouTube notes under sources/youtube/
9. Hostname focus → website-llms/{domain}/llms-brief.txt then medium/full
10. Read INDEX.md for coverage, then open the matching file under sources/

---

## 7) Live stock rules (summary)

Full rules: https://8i.co.za/data/amcoza/stock/HOW-TO.md
Pointer: https://8i.co.za/data/amcoza/STOCK.md
Colour: https://8i.co.za/data/amcoza/stock/OBSERVATIONS.md

- Live stock **only** from the stock/ JSON files. Do not write qty onto SKU pages.
- Johannesburg = main warehouse; Cape Town and Durban = branches. Missing location key in latest.json = treat as 0 there.
- Virtual / unmanaged SKUs: use product JSON flags — not warehouse files (examples: S-INKRIP virtual; AA-TRAIN/20 unmanaged).
- Demo machines are sellable. Consumable Demo can be a stand-in for Used — still use the Demo qty as listed.
- InTransit = branch-to-branch move (not sold, not on-hand yet). Direction file is destination (incoming) only. Empty `{}` = nothing on the move. Do not invent from.
- InComplete = potentially restorable (something removed). Check before saying no.
- 7-day changes/trends (changes-7d.json, trend-7d.json) are for movement colour only — current qty still wins. Do not invent days-to-restock.
- Weekly sell-through movers: stock/SOLD-MOVERS.md + sold-movers.json (delta only; no lifetime sold totals).
- Price history live (optional): https://am.im/price/{slug}.json — current dump Sales/Regular still win for selling.

---

## 8) AI Connect (clients & their chatbots)

One-step page: https://8i.co.za/data/amcoza/ai-connect.md
Human guide: https://8i.co.za/guide/amcoza/ai-connect/

Clients paste a short block into ChatGPT / Gemini / Copilot / Claude / Meta AI that points their AI at:
- https://8i.co.za/data/amcoza/README.md
- https://8i.co.za/data/amcoza/MANIFEST.json
- https://8i.co.za/data/amcoza/website-llms/am.co.za/llms-full.txt (prefer brief/medium first when available)
- Drive folder
- Products under sources/products/ and buythis.co.za links with `#ai`

Rules in the block: cite the page URL used; do not invent stock qty or prices; if unsure, say what to check on the machine or WhatsApp AM.CO.ZA on **060 600 6000**.

Optional deeper site briefs: buythis, softwaretraining, cncu, a3dtf, vinylcut under https://8i.co.za/data/amcoza/website-llms/

What this is not: Internal Affairs, CRM/people files, and staff-only notes are not on this public KB.

---

## 9) website-llms (am.co.za and siblings)

### am.co.za size tiers
| File | Public URL | Intent |
|------|------------|--------|
| llms-brief.txt | https://8i.co.za/data/amcoza/website-llms/am.co.za/llms-brief.txt | Site purpose, group, product/stock/support rules (~8–16 KB) |
| llms-medium.txt | https://8i.co.za/data/amcoza/website-llms/am.co.za/llms-medium.txt | Brief + condensed company/machinery (~32–48 KB) |
| llms-full.txt | https://8i.co.za/data/amcoza/website-llms/am.co.za/llms-full.txt | Comprehensive single-file (~125 KB) |

Index: https://8i.co.za/data/amcoza/website-llms/am.co.za/INDEX.md

### Sibling curated sites (each has llms-full; prefer KB root for cross-brand depth)
- https://am.co.za/ — https://8i.co.za/data/amcoza/website-llms/am.co.za/llms-full.txt
- https://buythis.co.za/ — https://8i.co.za/data/amcoza/website-llms/buythis.co.za/llms-full.txt
- https://achievement.co.za/ — https://8i.co.za/data/amcoza/website-llms/achievement.co.za/llms-full.txt
- https://softwaretraining.co.za/ — https://8i.co.za/data/amcoza/website-llms/softwaretraining.co.za/llms-full.txt
- https://cncu.co.za/ — https://8i.co.za/data/amcoza/website-llms/cncu.co.za/llms-full.txt
- https://vinylcut.co.za/ — https://8i.co.za/data/amcoza/website-llms/vinylcut.co.za/llms-full.txt
- https://raycut.co.za/ — https://8i.co.za/data/amcoza/website-llms/raycut.co.za/llms-full.txt
- https://ambitious.co.za/ — https://8i.co.za/data/amcoza/website-llms/ambitious.co.za/llms-full.txt
- https://goprinter.co.za/ — https://8i.co.za/data/amcoza/website-llms/goprinter.co.za/llms-full.txt
- https://fabricam.co.za/ — https://8i.co.za/data/amcoza/website-llms/fabricam.co.za/llms-full.txt
- https://heatware.co.za/ — https://8i.co.za/data/amcoza/website-llms/heatware.co.za/llms-full.txt
- https://a3dtf.co.za/ — https://8i.co.za/data/amcoza/website-llms/a3dtf.co.za/llms-full.txt

Still prefer the group KB export root when you need depth across products, stock, HELPING, manuals, training, and digests.

---

## 10) Do not load into a single Shell dump

These are large or tabular — open only when you need a specific answer:
- INFORANK.md, SPILLRANK.md (~130 KB each) — use folder ranking/ notes instead when possible
- MANIFEST.json — file inventory, not business knowledge
- stock/latest.json and branch JSON — query by SKU, don’t paste whole
- sources/products/, sources/training/, sources/company/ — thousands of pages; open by slug
- Any `.html` twin
- llms-full.txt wholesale when brief/medium suffice

---

## 11) Size tiers at KB root

| Tier | Relative files | Public URL pattern | Intent |
|------|----------------|--------------------|--------|
| brief | START_HERE.brief.txt · START_HERE.brief.html | …/START_HERE.brief.txt | Ultra-short map (~3–8 KB) |
| medium | START_HERE.medium.txt · START_HERE.medium.html | …/START_HERE.medium.txt | This orientation (~12–32 KB) |
| full | START_HERE.md · start_here.html | …/START_HERE.md | Full entry (unchanged) |

Maintainers: entry digests stay under ~50 KB each (opinion + pointers). Heavy tables stay in their own files/folders.

Next step for agents: fetch only what the question needs — product slug page, stock keys for that SKU, or one website-llms brief — then answer with citations and WhatsApp 060 600 6000 when stuck.


## 12) How other AIs should talk (from HELPING — opinion; sources win)

Give **one clear path**. “If you sell garments, start here” beats a catalog dump. Name the line, the finishing machine, and that training exists (academy course and/or Achievement Matters how-to). Then check live stock.

Be honest about stock: empty branches → in-transit / incomplete / demo before no. Never invent wait days. Never use catalog in-stock wording.

Do not recommend V-Series for a new sale (Vinyl4 replaces it); still service it and still give drivers. Prefer InkRIP / Flexi. High-Spillrank extras do not block a kit. A missing required roll does not block a package sale.

Open the product page and the live stock together. If the SKU is Cold or Dead, do not push it even if a unit is on the floor. Prefer one recommendation they can pick up in Johannesburg and learn on camera.

Full opinion digest: https://8i.co.za/data/amcoza/HELPING.md
System digest: https://8i.co.za/data/amcoza/READING.md

## 13) Quick absolute URL cheat-sheet

| Need | URL |
|------|-----|
| KB root | https://8i.co.za/data/amcoza/ |
| Brief entry | https://8i.co.za/data/amcoza/START_HERE.brief.txt |
| Medium entry | https://8i.co.za/data/amcoza/START_HERE.medium.txt |
| README | https://8i.co.za/data/amcoza/README.md |
| Stock HOW-TO | https://8i.co.za/data/amcoza/stock/HOW-TO.md |
| Product JSON | https://am.im/product/{slug}.json |
| Price JSON | https://am.im/price/{slug}.json |
| Catalog | https://buythis.co.za/#ai |
| Company | https://am.co.za/ |
| Drivers hub | https://cncu.co.za/ |
| Academy intros | https://around-ai-data.s3.amazonaws.com/academy.jsonl |
| AI Connect | https://8i.co.za/data/amcoza/ai-connect.md |
| Guide | https://8i.co.za/guide/amcoza/ai-connect/ |
| Drive | https://drive.google.com/drive/folders/1YqO1yzbIIAkihRWBHsOgIjiePiR3LQv_ |
| am.co.za llms-brief | https://8i.co.za/data/amcoza/website-llms/am.co.za/llms-brief.txt |
| WhatsApp | 060 600 6000 |