Supplier Intelligence Files (SIFs)

A SIF is a per-supplier document combining structured config (lead time, order day, MOQs) with freeform knowledge (who to call, what their delivery quirks are, when they raise prices). It's read both by Stokk's calculation engine and by Claude during Overnight Intelligence.

Why it exists

A lot of replenishment knowledge lives in buyers' heads — "this supplier ships from Italy and shuts in August," or "always order these two SKUs together because they share a pallet." A SIF makes that explicit so the system can use it and so it doesn't leave when a buyer does.

Structured fields

• Lead time (days from order to delivery)
• Order frequency or fixed order days
• Minimum order quantity / value
• Order multiple / pack size
• Payment terms
• Currency

Edit these on the supplier page: the Order Schedule section holds cadence, lead time, and blackouts, and the Structured Config card's Edit button lets you set MOQ, freight threshold, order method, currency, payment terms, and reliability score. (You can also just tell STOKK— see below.) Every edit is versioned in the supplier's history.

Freeform knowledge

A markdown text area for anything else. Examples that work well:

• "They batch orders weekly — anything after Tuesday slips a week."
• "Discount kicks in at 50 units; aim above that when possible."
• "July–August: closed for two weeks, plan around it."
• "If sales of SKU 12345 spike, also order 12346 — same recipe."

How Claude uses it

During the per-SKU deep dive, Claude reads the SIF as authoritative human knowledge and lets it override the numbers. Write “we had quality issues with SKU 12345, now resolved” and it resumes normal ordering; write “discontinuing this line” and it stops reordering it. It cites the SIF fact in the line's rationale, so you can see when a decision leaned on what you wrote.

Suggestions from the brief

When the deep dive notices a durable pattern — say a SKU that's been overstocked chain-wide for months — it proposes adding it to the SIF. These appear on the Morning Brief card with an Add to SIF button. Accepting one appends it as a dated note and bumps the version, so next time it's part of the supplier's knowledge.

The main way to update a SIF: just tell STOKK

Open a supplier from Purchasing → Suppliers. At the top of the SIF area is a “Tell STOKK about this supplier” box. Type a plain thought — a lead-time change, a closure, “stop ordering X” — and STOKK files it in the right place:

• A number it uses (lead time, MOQ, free-freight) → the supplier's structured config.
• A shut period → a blackout the planner works around.
• An instruction about one product → a SKU note.
• Anything else → a dated line in the freeform SIF.

If something's ambiguous it asks a quick question first. Either way it shows you the exact change and you confirm before anything is saved — nothing is written silently. Every applied change bumps the version and is recorded in the history below.