Scenario roadmap — master path for client AIs

Step 2 detail (after stock-only asks). Stock: STOCK.md. Waterfall: 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)

Orient (once per session)
- Entry map: START_HERE.md
- System digest: READING.md
- Client-help opinion: HELPING.md
- Then open the scenario router, not the whole tree: scenarios/INDEX.md
Classify the question (pick one primary lane)

Client says…	Open first	Lane
“I want to start a business / what machine?”	first-shop.md → category pack	HELPING path
Named category (DTF / UV-DTF / vinyl / press / laser / CNC / banners)	Matching pack in INDEX.md	Catalog pack
“Do you have SKU X?” / single part qty	single-sku-stock.md	Stock
Named starter package / “can we pick up today?”	packages-available.md · how: combo-how.md	Combo stock
Ranks disagree / “what’s hot?” / online vs warehouse	signals.md · online-vs-floor.md	Signals
Machine won’t run / how do I fix…	troubleshoot.md	How-to
InkRIP vs VinylCut / RIP / cut software	software-inkrip-vinylcut.md	Software
No three-phase / “220 to 380” for CNC	phasemagic.md	PhaseMagic
Banners / vehicle wrap / large format eco	wide-format-eco.md	FastCOLOUR

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 → latest.json	Catalog “In Stock” text
Named combo sellable qty	packages-available.json	Recompute unless SKU missing from that file
Available = 0	status.json (InTransit / InComplete / Demo)	Invent restock days
Online demand colour	buythis-sales + online-vs-floor.md	Treat as warehouse qty
Market steer	HELPING + company/YouTube	Confuse with Spillrank

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
UV-DTF	uvdtf-printers.md
Vinyl4	vinyl-cutters.md
Heat press	heat-presses.md
Hobby laser	laser-hobby.md
EasyRoute CNC	cnc-easyroute.md
Wide-format eco	wide-format-eco.md
DTF consumables	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.
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.

Navigate

Scenario router: INDEX.md (AIs) · index.html (browsers)
Master path: roadmap.md · roadmap.html
KB entry: START_HERE.md