← BrainerceCONTENT HISTORY

Update to Brainerce

Snapshot Sep 30, 2026 · 23:07 UTC · version 1.0.0

Collection source: not recorded for this historical snapshot.

WHAT CHANGED · RULE-BASED ANALYSIS

First saved snapshot

No earlier snapshot is available to establish a change.

Compare saved observations

Download comparison JSON
Full technical diff · 0 changed fields
Full snapshot data
{
  "name": "brainerce-integration-verify",
  "description": "Audit a Brainerce storefront against the mandatory-feature checklist and the critical rules, and report what is missing, present but unreachable, or wrong. Use when a developer says is my integration complete, check my Brainerce build, did I miss anything, review this before launch, why is this feature not working, or before shipping a storefront to a real store owner. Walks the actual code rather than trusting that a file exists, with particular attention to the features that are almost always skipped. For developers. Do not choose this to build something new, use brainerce-storefront-build. Do not choose this for one method's signature, use brainerce-sdk. Do not choose this for the correct order of a checkout or login sequence while writing it, use brainerce-checkout-flows. Do not choose this for a merchant auditing their shop's products and promotions, that is brainerce-store-health. Keywords: verify, audit, checklist, did I miss anything, pre-launch, mandatory features, critical rules, ready to ship.",
  "included_files": [
    {
      "relative_path": "agents/openai.yaml",
      "size_in_bytes": 753
    },
    {
      "relative_path": "assets/icon.png",
      "size_in_bytes": 3208
    },
    {
      "relative_path": "references/business-flows.md",
      "size_in_bytes": 21739
    },
    {
      "relative_path": "references/critical-rules.md",
      "size_in_bytes": 7087
    },
    {
      "relative_path": "references/required-features.md",
      "size_in_bytes": 20554
    }
  ],
  "skill_md_contents": "---\nname: brainerce-integration-verify\ndescription: \"Audit a Brainerce storefront against the mandatory-feature checklist and the critical rules, and report what is missing, present but unreachable, or wrong. Use when a developer says is my integration complete, check my Brainerce build, did I miss anything, review this before launch, why is this feature not working, or before shipping a storefront to a real store owner. Walks the actual code rather than trusting that a file exists, with particular attention to the features that are almost always skipped. For developers. Do not choose this to build something new, use brainerce-storefront-build. Do not choose this for one method's signature, use brainerce-sdk. Do not choose this for the correct order of a checkout or login sequence while writing it, use brainerce-checkout-flows. Do not choose this for a merchant auditing their shop's products and promotions, that is brainerce-store-health. Keywords: verify, audit, checklist, did I miss anything, pre-launch, mandatory features, critical rules, ready to ship.\"\ncompatibility: ChatGPT, Claude Code, Claude Desktop, Cursor\nmaintainer: Brainerce\nmetadata:\n  author: Brainerce\n  version: \"1.0.0\"\n---\n\nCheck a Brainerce integration honestly, feature by feature, against what is actually required.\n\n## Core principle\n\nReachable in the running UI, or it does not count. A component that exists in the repo but no route renders is not an implemented feature, and reporting it as one is how storefronts ship with no password reset. Walk the code and trace each feature to something a customer can actually get to.\n\n## When to use this skill first\n\n- \"Is my integration complete\", \"did I miss anything\", \"check this before launch\".\n- Handing a build to a real store owner.\n- \"This feature is not working and I do not know why\".\n- After following `brainerce-storefront-build`, as the closing step.\n\n## When NOT to use this skill first\n\n- Building something new: use `brainerce-storefront-build`.\n- One method's signature: use `brainerce-sdk`.\n- Getting a sequence right while writing it: use `brainerce-checkout-flows`.\n- A shop owner auditing products and promotions in their store: that is `brainerce-store-health`, a merchant skill on a different tool surface.\n\n---\n\n## How to run the audit\n\n### 1. Establish what is required\n\n`references/required-features.md` is the checklist. `references/business-flows.md` carries the sequences each feature has to follow, and `references/critical-rules.md` the rules that cause incidents.\n\nWhen the Brainerce MCP server is connected (Claude Code, Cursor, or the CLI), `get-required-features` with the connection id returns the list tailored to that store's live configuration. Prefer that. In ChatGPT there is no connection, so use the reference file and say that the audit is against the general checklist rather than that specific store.\n\n⛔ **Mandatory features must exist even when the store has them switched off today.** They auto-hide, and the owner turns them on months later without touching the code. A build that omits them is not complete, it is a delayed outage. Do not mark a feature as not applicable because the store currently has it disabled.\n\n### 2. Walk the code, feature by feature\n\nFor each item, find the code, then find the route or component that makes it reachable. Both, not either.\n\nPay closest attention to the ones that are almost always skipped:\n\n- Email verification with a six-digit code\n- Forgot password and reset password\n- The OAuth button area and callback handling, including when no provider is currently enabled\n- Coupon input in the cart\n- The inventory reservation countdown, visible to the customer\n- `handlePaymentSuccess` followed by `waitForOrder` on the confirmation page\n- Sitemap built with the dedicated SDK helpers rather than a plain product list\n- Slug-redirect handling on product and blog not-found paths\n\n### 3. Check the critical rules against the code\n\n- Prices parsed before arithmetic, everywhere, including totals\n- Nested and flat line-item shapes handled as they actually arrive\n- No auth token in browser storage without a backend-for-frontend\n- No hardcoded currency, locale or store id\n- No invented SDK methods\n\n### 4. Report, then fix only what is approved\n\n## Report shape\n\nThree states, and use all three. A report that is all ticks was not an audit.\n\n> ✓ Audit of your Brainerce integration. 14 of 19 mandatory features are reachable.\n>\n> **Implemented and reachable**\n> - Product listing, product detail with variants, cart with persistence\n> - Checkout through payment, with the reservation countdown visible\n> - Registration and login\n> - Order confirmation\n>\n> **Present but broken or unreachable**\n> - `ResetPasswordForm.tsx` exists and no route renders it. A customer who forgets their password has no way in. `src/components/auth/ResetPasswordForm.tsx`\n> - Coupon input is in the cart component but is behind a flag that is never set. `src/components/cart/CartSummary.tsx:82`\n>\n> **Missing**\n> - Email verification. Registration completes and the account cannot be used. This is mandatory.\n> - OAuth button area. The store has no providers today, so it looks unnecessary, but the owner enabling Google later would need a code change.\n> - Sitemap uses `getProducts({ limit: 1000 })`, which the API caps at 100. Your sitemap silently lists 100 products.\n>\n> **Critical rule violations**\n> - `src/lib/totals.ts:14` adds `item.price` without parsing. Prices are strings, so this concatenates.\n>\n> Want me to start with email verification? It is the one that blocks real customers today.\n\n## Rules\n\n- Trace every feature to something reachable. A file is not a feature.\n- Cite file paths and line numbers. An audit without references cannot be acted on.\n- Use all three states. \"Present but unreachable\" is the most useful finding and the one a shallow check misses.\n- Never mark a mandatory feature not applicable because the store has it disabled.\n- Report before fixing, and fix only what the developer approves.\n- Say what you could not check, and why. An audit that quietly skipped the payment path is worse than one that says it did.\n- Order findings by what blocks a real customer today, not by checklist order.\n\n## Cross-skill connections\n\n- Building what the audit found missing: `brainerce-storefront-build`.\n- Getting a sequence right while fixing it: `brainerce-checkout-flows`.\n- A method signature you need mid-fix: `brainerce-sdk`.\n\nRoute once, and do not bounce back and forth.\n"
}

SHA-256: ddbae972c70d9c1ac39133c14dda9218c184b24b6bfe8742499c4d55b4b89063