Restock

# Restock

Chain two skills so reordering ends in the books rather than in a forgotten email: `inventory-planner` decides what to buy, `ap-processor` stages what it will cost.

The gap this closes is small and expensive. The reorder gets figured out, the PO gets drafted, the email gets sent — and then nothing is recorded anywhere, so when the bill lands six weeks later nobody can tell whether the price or the quantity was right.

## Step 1 — Work out what to buy (inventory-planner)

Invoke `inventory-planner`.

- **Goes in:** sales history and stock on hand from Shopify, Square, or NetSuite, or an uploaded CSV of both. - **Comes out:** 7-day and 28-day velocity per item, conservative stockout dates, a sized 60-day reorder with dollar costs, and a separate slow-mover list.

`inventory-planner` owns all of the math — the two velocity windows, the distortion handling, the lead-time comparison, the seasonality rule. Do not redo any of it here.

Two of its rules matter enough to name in the chain:

- **Zero-velocity items are never reorder candidates.** They come through as slow movers with the cash tied up in them. No sales means stop buying, not buy more. - **An out-of-stock period is not zero demand.** It is suppressed demand, and treating it as zero under-orders the item forever.

**Gate — the buy list.** Show the total dollars and the count of items about to stock out before anything is drafted. The owner approves the list, trims it, or changes quantities. Every line carries its velocity, days of cover, lead time, quantity, and cost, so the decision takes a minute instead of a rebuild.

## Step 2 — Draft the PO and the vendor email (inventory-planner)

For the approved lines, `inventory-planner` drafts a purchase order per vendor and the email to go with it, written in the owner's voice.

**Gate — both wait for an explicit yes, separately from Step 1.** Approving the buy list is agreeing on what to order. Sending the PO is committing the money and spending the vendor relationship. State the vendor, the line items, and the total before asking.

Without a mail connector (Gmail or Microsoft 365) connected, the PO and the email are files the owner sends by hand. That is a complete outcome.

## Step 3 — Leave a record the future bill can match against

Two different things happen here, and it matters which skill owns which.

**`inventory-planner` keeps the purchase order itself.** The approved PO is its document — vendor, line items, quantities, prices, expected date. It is saved and handed to the owner in Step 2, and that is the record of what was ordered.

**`ap-processor` takes the coded memo, not the PO.** Hand it the vendor, the PO number, the total, the expected date, and the account, class, and job the spend belongs to. `ap-processor` does not create purchase orders in the ledger — it reads them when a bill arrives, to run the three-way match of bill against PO against receiving ticket. What it needs from this step is a coded record sitting where that match will look for it.

- **Goes in:** vendor, PO number, total, expected date, and the coding. - **Comes out:** a coded memo filed against the vendor, so when the bill lands in six weeks the price and the quantity can be checked against what was actually approved.

**Gate — the coding approval.** This is `ap-processor`'s own gate and it holds here. Nothing is written to the ledger until the owner says yes, and nothing lands as a bill and never as a payment. **No money moves in this command at all** — paying for what arrives is `/pay-the-bills`.

If a code is uncertain on a new vendor, `ap-processor` asks rather than guessing. One question now beats a miscoded year.

Without a ledger connector, the coded memo comes out as an import file and a summary alongside the PO. The three-way match still happens later, by hand, against a record that exists.

## Step 4 — Make it a rhythm

Ray Okonkwo runs Okonkwo Mechanical off a parts shelf he checks when something is missing, which is always too late. With Google Calendar connected, offer once — after a restock the owner found useful — to put a recurring block on the calendar for the reorder decision.

This works far better as a rhythm than as a fire drill. Offer it once. On a no or on silence, drop it.

## Fallback path

A sales CSV plus a stock count is a fully supported input. Many businesses count on a clipboard, and that is legitimate data. Velocity, stockout dates, reorder sizing, the PO, and the vendor email all come out the same. The books entry becomes an import file.

## What not to do

- **Do not send a PO or a vendor email without approval.** One spends money, the other spends goodwill. - **Do not treat the buy-list approval as approval to send.** Two gates, two decisions. - **Do not reorder a zero-velocity item.** - **Do not size a reorder without subtracting what is already inbound.** Double-ordering a slow item buries cash for years. - **Do not invent a velocity, a lead time, or a stockout date.** Too