# Scenario roadmap — master path for client AIs

**Step 2 detail** (after stock-only asks). Stock: [STOCK.md](https://8i.co.za/data/amcoza/STOCK.md). Waterfall: [AI-GATES.md](https://8i.co.za/data/amcoza/AI-GATES.md).

Brand: **am.co.za** / AM.CO.ZA. Shortcut guide · 2026-09-07 03:15 SAST.

Read **one** lean file at a time. Prefer `.md`. All links absolute under `https://8i.co.za/data/amcoza/`. Do not invent prices, restock days, or qty.

## Flow (flowchart in bullets)

1. **Orient (once per session)**  
   - Entry map: [START_HERE.md](https://8i.co.za/data/amcoza/START_HERE.md)  
   - System digest: [READING.md](https://8i.co.za/data/amcoza/READING.md)  
   - Client-help opinion: [HELPING.md](https://8i.co.za/data/amcoza/HELPING.md)  
   - Then open the **scenario router**, not the whole tree: [scenarios/INDEX.md](https://8i.co.za/data/amcoza/scenarios/INDEX.md)

2. **Classify the question** (pick one primary lane)

| Client says… | Open first | Lane |
| --- | --- | --- |
| “I want to start a business / what machine?” | [first-shop.md](https://8i.co.za/data/amcoza/scenarios/first-shop.md) → category pack | HELPING path |
| Named category (DTF / UV-DTF / vinyl / press / laser / CNC / banners) | Matching **pack** in [INDEX.md](https://8i.co.za/data/amcoza/scenarios/INDEX.md) | Catalog pack |
| “Do you have SKU X?” / single part qty | [single-sku-stock.md](https://8i.co.za/data/amcoza/scenarios/single-sku-stock.md) | Stock |
| Named **starter package** / “can we pick up today?” | [packages-available.md](https://8i.co.za/data/amcoza/scenarios/packages-available.md) · how: [combo-how.md](https://8i.co.za/data/amcoza/scenarios/combo-how.md) | Combo stock |
| Ranks disagree / “what’s hot?” / online vs warehouse | [signals.md](https://8i.co.za/data/amcoza/scenarios/signals.md) · [online-vs-floor.md](https://8i.co.za/data/amcoza/scenarios/online-vs-floor.md) | Signals |
| Machine won’t run / how do I fix… | [troubleshoot.md](https://8i.co.za/data/amcoza/scenarios/troubleshoot.md) | How-to |
| InkRIP vs VinylCut / RIP / cut software | [software-inkrip-vinylcut.md](https://8i.co.za/data/amcoza/scenarios/software-inkrip-vinylcut.md) | Software |
| No three-phase / “220 to 380” for CNC | [phasemagic.md](https://8i.co.za/data/amcoza/scenarios/phasemagic.md) | PhaseMagic |
| “List all products / full catalogue” | [catalogue-list-all-products.md](https://8i.co.za/data/amcoza/scenarios/catalogue-list-all-products.md) | Router |
| VIP / quotation % (staff) | [vip-quote-math.md](https://8i.co.za/data/amcoza/scenarios/vip-quote-math.md) | Staff policy |
| Varnish/vanish printhead SKU | [printhead-varnish-xp600.md](https://8i.co.za/data/amcoza/scenarios/printhead-varnish-xp600.md) | Parts |
| F vs F2 eco ink / H-INK | [eco-solvent-ink-f-vs-f2.md](https://8i.co.za/data/amcoza/scenarios/eco-solvent-ink-f-vs-f2.md) | Consumables |
| No 2-in-1 print+cut | [print-and-cut-alternative.md](https://8i.co.za/data/amcoza/scenarios/print-and-cut-alternative.md) | Combo |
| A4 label contour cutter | [vinyl-a4-label-cutter.md](https://8i.co.za/data/amcoza/scenarios/vinyl-a4-label-cutter.md) | Vinyl |
| RayCut / MorCut / TruCUT | [raycut-morcut-trucut.md](https://8i.co.za/data/amcoza/scenarios/raycut-morcut-trucut.md) | Laser family |
| Fibre laser lens SKU | [fibre-laser-lens-skus.md](https://8i.co.za/data/amcoza/scenarios/fibre-laser-lens-skus.md) | Parts |
| Heat press MT/MTE variants | [heat-press-mt-variants.md](https://8i.co.za/data/amcoza/scenarios/heat-press-mt-variants.md) | Heatware |
| Golf club fibre marking | [golf-club-fibre-marking.md](https://8i.co.za/data/amcoza/scenarios/golf-club-fibre-marking.md) | LabelMark |
| Banners / vehicle wrap / large format eco | [wide-format-eco.md](https://8i.co.za/data/amcoza/scenarios/wide-format-eco.md) | FastCOLOUR |

3. **When to open stock vs catalog vs HELPING**

```
                    ┌─────────────────────────┐
                    │  What do they need?     │
                    └───────────┬─────────────┘
           ┌────────────────────┼────────────────────┐
           ▼                    ▼                    ▼
   Sell / recommend        On-hand qty?         How to run/fix?
   (path / line)           (SKU or package)     (already own it)
           │                    │                    │
           ▼                    ▼                    ▼
   HELPING.md +            stock HOW-TO +       training / youtube
   category pack           latest.json or       / softt pointers
   (machines list)         packages-available   (troubleshoot.md)
           │                    │
           └────────┬───────────┘
                    ▼
         Always: product page + live stock together
         before promising pick-up. Catalog ≠ stock.
```

| Need | Open | Do **not** |
| --- | --- | --- |
| Which **line** / first shop | HELPING + pack | Dump whole `sources/products/` |
| Specs / variants | Pack → `sources/products/{slug}.md` or `https://am.im/product/{slug}.json` | Invent specs |
| Branch **qty** | [stock/HOW-TO.md](https://8i.co.za/data/amcoza/stock/HOW-TO.md) → [latest.json](https://8i.co.za/data/amcoza/stock/latest.json) | Catalog “In Stock” text |
| Named combo sellable qty | [packages-available.json](https://8i.co.za/data/amcoza/scenarios/packages-available.json) | Recompute unless SKU missing from that file |
| Available = 0 | [status.json](https://8i.co.za/data/amcoza/stock/status.json) (InTransit / InComplete / Demo) | Invent restock days |
| Online demand colour | [buythis-sales](https://8i.co.za/data/amcoza/stock/buythis-sales.json) + [online-vs-floor.md](https://8i.co.za/data/amcoza/scenarios/online-vs-floor.md) | Treat as warehouse qty |
| Market steer | HELPING + company/YouTube | Confuse with Spillrank |

4. **Answer shape**  
   One clear path → name the line / finishing / that training exists → check live stock → stop. Prefer Johannesburg pick-up honesty.

## Category packs (catalog)

| Pack | URL |
| --- | --- |
| DTF textile | [dtf-printers.md](https://8i.co.za/data/amcoza/scenarios/dtf-printers.md) |
| UV-DTF | [uvdtf-printers.md](https://8i.co.za/data/amcoza/scenarios/uvdtf-printers.md) |
| Vinyl4 | [vinyl-cutters.md](https://8i.co.za/data/amcoza/scenarios/vinyl-cutters.md) |
| Heat press | [heat-presses.md](https://8i.co.za/data/amcoza/scenarios/heat-presses.md) |
| Hobby laser | [laser-hobby.md](https://8i.co.za/data/amcoza/scenarios/laser-hobby.md) |
| EasyRoute CNC | [cnc-easyroute.md](https://8i.co.za/data/amcoza/scenarios/cnc-easyroute.md) |
| Wide-format eco | [wide-format-eco.md](https://8i.co.za/data/amcoza/scenarios/wide-format-eco.md) |
| Catalogue dump router | [catalogue-list-all-products.md](https://8i.co.za/data/amcoza/scenarios/catalogue-list-all-products.md) |
| Print-and-cut alt | [print-and-cut-alternative.md](https://8i.co.za/data/amcoza/scenarios/print-and-cut-alternative.md) |
| A4 label cutter | [vinyl-a4-label-cutter.md](https://8i.co.za/data/amcoza/scenarios/vinyl-a4-label-cutter.md) |
| Laser family map | [raycut-morcut-trucut.md](https://8i.co.za/data/amcoza/scenarios/raycut-morcut-trucut.md) |
| Golf fibre marking | [golf-club-fibre-marking.md](https://8i.co.za/data/amcoza/scenarios/golf-club-fibre-marking.md) |
| Heat press MT variants | [heat-press-mt-variants.md](https://8i.co.za/data/amcoza/scenarios/heat-press-mt-variants.md) |
| DTF consumables | [consumables-dtf.md](https://8i.co.za/data/amcoza/scenarios/consumables-dtf.md) |

## Trust rules (short)

- Catalog packs list machines; stock only via packages-available or `latest.json` / status files.
- buythis-sales ≠ warehouse qty ≠ Inforank/Hot-Cold ≠ company push — [signals.md](https://8i.co.za/data/amcoza/scenarios/signals.md).
- Virtual/unmanaged SKUs (training codes, some software) are always in stock — do not look them up in warehouse JSON.
- High-Spillrank kit riders (e.g. `AM-WIPE/5`) never block a package.

Router: [INDEX.md](https://8i.co.za/data/amcoza/scenarios/INDEX.md).


## Navigate

- Scenario router: [INDEX.md](https://8i.co.za/data/amcoza/scenarios/INDEX.md) (AIs) · [index.html](https://8i.co.za/data/amcoza/scenarios/index.html) (browsers)
- Master path: [roadmap.md](https://8i.co.za/data/amcoza/scenarios/roadmap.md) · [roadmap.html](https://8i.co.za/data/amcoza/scenarios/roadmap.html)
- KB entry: [START_HERE.md](https://8i.co.za/data/amcoza/START_HERE.md)