{
 "schema": "aiblocks-page/1",
 "id": "agency-engineering-wordpress-shopping-cart",
 "type": "agent",
 "name": "WooCommerce checkout engineer",
 "summary": "Plan or fix a WooCommerce store on WordPress, covering checkout, payments, tax, coupons and orders, built update-safe with a test list.",
 "headline": "WooCommerce checkout engineer",
 "subhead": "Tell it what your WooCommerce store sells, which plugins and gateway you use and what breaks or what you want to add. It plans checkout changes, payment setup, tax, coupons and order steps the update-safe way. You get a plan and test list for your developer, not live changes.",
 "job": {
  "id": "set-up-store",
  "name": "Set up your online store"
 },
 "level": "intermediate",
 "thinking": "high",
 "tested": true,
 "updated": "2026-11-03",
 "first_published": "2026-10-26",
 "inputs": [
  {
   "type": "question",
   "required": true,
   "label": "Question",
   "what": "the problem, decision or piece of work you want help with, and what a good outcome looks like"
  },
  {
   "type": "source_text",
   "required": false,
   "label": "Source text",
   "what": "a long source in full: an article, a video or talk transcript, or notes from a book, with its title, author and link"
  }
 ],
 "outputs": [
  {
   "type": "plan",
   "required": true,
   "label": "Plan",
   "what": "a dated plan: what to do, in what order, with a decision rule for each step"
  }
 ],
 "you_give": [
  "What you sell, such as simple products, variable products or subscriptions.",
  "Your WordPress and WooCommerce versions, and whether you use the block checkout or the classic checkout (optional)",
  "Your payment gateway, and whether it is in test or live mode.",
  "Your plugins that touch the cart, checkout, payments or caching.",
  "The problem or goal, for example \"coupons stack when they should not\" or \"add a delivery date field\".",
  "How tax is set up, such as prices with or without tax (optional)"
 ],
 "you_get": [
  "A checkout plan that uses hooks or the block checkout tools, with each field's checks and where its data is saved.",
  "A payment plan covering the gateway, test and live mode, webhooks and matching orders to payouts.",
  "A tax and coupon plan with stacking rules and cases to test.",
  "An order status plan, with stock and refund rules.",
  "A test list for the full purchase path on a phone, plus cache rules and a rollback."
 ],
 "use_when": [
  "You want to add a field, fee or rule to WooCommerce checkout and avoid breaking it on the next update.",
  "Customers report a stale or empty cart, or a checkout that fails on phones.",
  "You are adding or changing a payment gateway such as WooPayments, Stripe or PayPal and want the setup and test steps.",
  "Two plugins seem to clash over cart, coupons or payment, and you need a way to find the cause."
 ],
 "skip_when": [
  "Your store runs on Drupal Commerce. Use the Drupal Commerce developer.",
  "You are starting a new WooCommerce store and want a non-technical plan. Use the WooCommerce store setup planner.",
  "Your store is on Shopify. Use the Shopify store setup planner.",
  "You want your store settings checked against your country's rules. Use the Payments and checkout settings checker.",
  "Customers are being charged wrongly right now. Call your payment provider and your developer first. This agent cannot see or fix a live store."
 ],
 "output_sample": {
  "input": [
   "What you sell and the checkout type you use",
   "Your WordPress and WooCommerce versions, and your payment gateway and mode",
   "Your plugins that touch the cart, checkout, payments or caching",
   "The problem or goal, and your tax setup (optional)"
  ],
  "prerequisites": [
   "A WordPress developer and a staging copy of the store to test on."
  ],
  "output": [
   {
    "name": "Scope",
    "contains": "Your goal, versions, checkout type, gateway, plugins on the cart path and assumptions."
   },
   {
    "name": "Checkout plan",
    "contains": "Each change, where it lives, the hook or block tool it uses and how its data is saved."
   },
   {
    "name": "Payment plan",
    "contains": "Gateway setup, where keys live, webhook checks and how orders match payouts."
   },
   {
    "name": "Tax and coupon plan",
    "contains": "Tax settings and coupon rules, with stacking cases to test."
   },
   {
    "name": "Order flow",
    "contains": "Statuses, moves, when stock drops and how refunds keep the record."
   },
   {
    "name": "Cache and performance",
    "contains": "Which pages must stay out of caching, and how to check it."
   },
   {
    "name": "Test list",
    "contains": "The full purchase path to test on a phone, each with a pass condition."
   },
   {
    "name": "Risks, gaps and checks",
    "contains": "Open questions and risks, with who should decide each."
   }
  ]
 },
 "output_shape": "SCOPE\n  Goal <change, fix or review> | Versions <WordPress, WooCommerce> | Checkout type <block or classic> | Gateway and mode <name, test or live> | Plugins on the cart path <list> | Assumptions <list>\n\nCHECKOUT PLAN\n  <change> | <where it lives: child theme or plugin> | <hook or block tool> | <checks> | <where data is saved>\n\nPAYMENT PLAN\n  <gateway> | <where keys live> | <webhook checks> | <how orders match payouts>\n\nTAX AND COUPON PLAN\n  <tax setup> | <coupon> | <restrictions> | <how it combines with others>\n\nORDER FLOW\n  <status> | <move> | <stock effect> | <what it triggers>\n\nCACHE AND PERFORMANCE\n  <page> | <excluded from cache?> | <how to check>\n\nTEST LIST\n  <check> | <pass if> | <owner>\n\nRISKS, GAPS AND CHECKS\n  <issue> | <why it matters> | <who decides>",
 "how_to_use": [
  "Download the pack and add it to your AI as a skill. If you cannot, paste SKILL.md into a new chat, then paste references/source-agent.md.",
  "Write what you sell, your versions, your gateway and mode, your plugin list and the goal or problem. Never paste API keys or secrets.",
  "Type \"Plan this WooCommerce change. Use the structure in the skill. Mark every assumption and list what you cannot check.\"",
  "Check that no change edits core files or the parent theme. Each change should live in a child theme or a small plugin.",
  "Run the test list on a staging copy with your developer. Cover add to cart, coupon, tax, payment, order email and a phone.",
  "Your developer applies the plan. The AI does not touch your site."
 ],
 "checks": [
  "The result addresses your actual task and cites the evidence used.",
  "Examples, role-play experience and targets are kept separate from verified results.",
  "Claims of tests, memory, tool access or completed actions match what actually happened."
 ],
 "next": [
  {
   "name": "Store tax setup planner",
   "url": "https://useaiblocks.com/skills/store-tax-setup-planner",
   "why": "Store tax setup planner"
  }
 ],
 "source": {
  "by": "Michael Sitarzewski and Agency Agents contributors",
  "repo": "msitarzewski/agency-agents",
  "url": "https://github.com/msitarzewski/agency-agents/blob/b37b5bb33b78f2c1d6567d98e25ca818e3259219/engineering/engineering-wordpress-shopping-cart.md",
  "licence": "MIT",
  "original_name": "WordPress Shopping Cart Engineer",
  "commit": "b37b5bb33b78f2c1d6567d98e25ca818e3259219"
 },
 "credits": [
  {
   "title": "WordPress Shopping Cart Engineer",
   "by": "Michael Sitarzewski and Agency Agents contributors",
   "url": "https://github.com/msitarzewski/agency-agents/blob/b37b5bb33b78f2c1d6567d98e25ca818e3259219/engineering/engineering-wordpress-shopping-cart.md",
   "used": "Original agent profile, preserved in references/source-agent.md; AI Blocks adds setup and review instructions."
  }
 ],
 "files": [
  "LICENSE",
  "references/source-agent.md",
  "SETUP.md",
  "source.json"
 ],
 "links": {
  "page": "https://useaiblocks.com/agents/agency-engineering-wordpress-shopping-cart",
  "markdown": "https://useaiblocks.com/agents/agency-engineering-wordpress-shopping-cart.md",
  "json": "https://useaiblocks.com/agents/agency-engineering-wordpress-shopping-cart.json",
  "instructions": "https://useaiblocks.com/skills/agency-engineering-wordpress-shopping-cart/SKILL.md",
  "download": "https://useaiblocks.com/skills/agency-engineering-wordpress-shopping-cart.zip",
  "api_item": "https://useaiblocks.com/api/v1/items/agency-engineering-wordpress-shopping-cart",
  "api_document": "https://useaiblocks.com/api/v1/documents/agent/agency-engineering-wordpress-shopping-cart",
  "mcp": "https://useaiblocks.com/mcp"
 }
}
