How the Kit Works
The Cache Upgrader Kit for WooCommerce makes the page cache you already have serve cached pages to shoppers with something in their basket and to logged-in customers. Most caches step aside for those visitors, so the people closest to buying get the slowest pages. The kit removes that rule safely: one cached copy of each page goes to everyone, with nothing personal in it, and each visitor’s own parts are filled in for them alone.
Every store prints personal content in its own way, through its theme and its plugins, so the compatibility work is different on every site. That work is done by your own AI agent, following the instructions and safety checks in the kit.
The three parts
- The kit you download. Two plugins, the instructions your AI agent reads, and the tools it uses to test your store.
- The Super Speedy licence server. It checks your licence and builds new copies of Cache Upgrader for your site when your agent asks for one.
- Your AI agent. Claude Code, Codex, Cursor or any agent that can run commands on your computer and connect to WordPress over MCP. It does the setup, the testing, the fixes and the go-live checks, and asks you for the few clicks only you can make.
What is in the kit
You download the kit from My Account on superspeedyplugins.com after buying it. Unzipped, the cache-upgrader-kit folder holds:
| Folder or file | What it is |
|---|---|
START-HERE.md | A one-page guide for you: what you need, and what to say to your agent. |
plugins/ | The two plugins: Super Speedy Ajax, and Cache Upgrader for WooCommerce. |
AGENTS.md, CLAUDE.md | The instructions your agent reads first. |
.claude/skills/, .agents/skills/ | Four procedures the agent follows: setup, the safety loop, going live, and re-checking after changes. |
tools/ | The safety-check runner, which uses Node.js and a headless browser. |
reports/ | Where the agent saves a report of every safety run. |
Your licence covers one live site, for life, and covers both plugins in the kit. Staging copies, .local and localhost sites never use up the licence, so all the testing happens for free on a copy of your store.
The two plugins
Super Speedy Ajax fills in everything that differs per visitor after the cached page loads: prices where they differ, stock, the basket and personalised regions such as an account menu. It sends one small request per page, and none when the page has nothing personal on it.
Cache Upgrader for WooCommerce is an add-on for Super Speedy Ajax. It:
- takes personal content out of the shared page;
- lets the cache serve shoppers with a basket and logged-in customers;
- carries a library of ready-made recipes for popular plugins. The build made for your site switches on the ones for the plugins and theme you run, and your agent can switch on others;
- runs the safety checks your agent uses to prove a page is safe to cache for everyone.
A recipe is a small piece of code that makes one plugin or theme cache-safe: for example, moving a payment button’s security token out of the shared page. Recipes your agent writes for your store live in a third plugin it creates on your site, “Cache Upgrader: Custom Cache Recipes”. Updates to Cache Upgrader never change that plugin, so your store’s fixes are always yours.
What your agent does
Open your agent in the kit folder and tell it your staging and live addresses; the Quick Start Guide has the exact words. It reads AGENTS.md and works through four skills in order.
1. Setup
- Checks the computer has Node.js 18 or newer, and installs the browser the safety checks use.
- Works on your staging site. It will not start on your live store unless you explicitly tell it to.
- Installs Super Speedy Ajax, then Cache Upgrader, or asks you to upload both in wp-admin.
- Asks you to paste your licence key into Super Speedy in wp-admin and switch on MCP. Super Speedy Ajax starts in TEST mode, so real shoppers see your store exactly as before.
- Asks you to create a connection on Super Speedy → MCP setup and paste it back. The agent writes it only into its own MCP configuration file and never repeats it.
- Gets the Cache Upgrader build made for your staging site from the Super Speedy licence server. Staging builds are free.
- Works out what differs between your shoppers:
- Prices: checks whether every kind of shopper sees the same price. If they do, prices stay in the cached page with nothing to load. If they differ, for example with tax by country or member prices, each shopper’s own price is fetched per visitor.
- Stock: asks whether items sell out or run low. If they do, stock and Add to Cart are refreshed per visitor.
- Basket and accounts: the basket count, totals and mini-basket are filled in per visitor.
- Markets and languages: for a store in several countries or languages, one page per market goes into the checks.
2. The safety loop
- Runs the safety checks on staging with caching fully on, page by page, as a guest, a shopper with a basket and a logged-in customer, without changing your saved settings.
- Anything personal left in the shared page fails the check. For each failure the agent either:
- switches on the library recipe for that plugin; or
- reads the plugin’s own code on your site and writes a recipe for it into your custom recipes plugin.
- Every recipe is syntax-checked, loaded in a separate request and health-checked. A recipe that breaks anything is rolled back on its own.
- Runs the checks again, and repeats until every check passes. The report is saved in
reports/. - With your agreement, shares the recipes it wrote with Super Speedy, with a summary of the session. Shared recipes are reviewed by hand, and generic versions join the library so every store gets them, kept up to date by us. Nothing is sent without your yes, and passwords, API keys and customers’ personal data are left out. You can also share from the Share with Super Speedy panel on the Cache Upgrader tab; Sharing Your Recipes shows how.
3. Going live
- Copies your custom recipes plugin to the live store, connects to live and gets the build made for your live site. Each build is locked to the site it was made for.
- Runs the safety checks again on live.
- You switch on caching for shoppers with a basket and for logged-in customers, then switch Super Speedy Ajax from TEST to LIVE. You decide when that happens.
One switch turns caching off again and returns the store to normal WordPress, without logging anybody out or emptying a basket. Your agent can use it, or you can, on the Cache Upgrader tab of Super Speedy → Ajax.
4. After changes
Run the loop again whenever something changes: a plugin, theme or WooCommerce update, a new plugin, or new prices, taxes or customer roles. Open your agent in the kit folder and say “I’ve updated plugins, check caching is still safe.”
Keep the kit folder. It holds the instructions your agent needs every time you re-check, and the reports from every safety run.
Updates
Super Speedy Ajax updates like any other plugin: WordPress offers each new version on the Plugins screen, using the licence key you entered in Super Speedy.
Cache Upgrader updates in one of two ways:
- Through your agent. It asks the Super Speedy licence server for a new build for your site. The server checks your licence and returns a signed copy built for your store. Your site checks the signature and that the build is the one made for it, keeps a backup of the copy it replaces, installs the new one and checks the site still works. If anything fails, the backup goes back.
- By hand. Download the kit again from My Account and upload the new Cache Upgrader zip in wp-admin, over the old one.
Either way, your custom recipes plugin is untouched. Run the safety loop again after an update.
What stays safe throughout
- Nothing changes for real shoppers until you switch to LIVE.
- The agent never edits your theme, your other plugins or Cache Upgrader itself. Every fix goes into your own custom recipes plugin.
- Shop managers and administrators always see live, uncached pages.
- Switching caching on or off never logs anyone out.
Written for Cache Upgrader for WooCommerce 1.7.0.
Comments