diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json index a0645286..75009f60 100644 --- a/.claude-plugin/marketplace.json +++ b/.claude-plugin/marketplace.json @@ -20,7 +20,7 @@ { "name": "agentic-engineering", "description": "The autonomous engineering system for repository portfolios and everything its agents need — engineer, read-only surveyor, meta-engineer and Flux troubleshooter agents; portfolio, product, spend and improvement workflows; GitHub, CodeRabbit review, security, library documentation, Go, Kubernetes, Flux, Talos, SvelteKit frontend, Stripe payments, engineering-practice, design, product-management, marketing, finance and productivity skills; and the MCP servers they use; configured by the consumer AGENTS.md", - "version": "7.8.6", + "version": "7.8.7", "source": "./plugins/agentic-engineering" }, { diff --git a/plugins/agentic-engineering/.claude-plugin/plugin.json b/plugins/agentic-engineering/.claude-plugin/plugin.json index 2c5bd602..4ecc8e68 100644 --- a/plugins/agentic-engineering/.claude-plugin/plugin.json +++ b/plugins/agentic-engineering/.claude-plugin/plugin.json @@ -1,7 +1,7 @@ { "name": "agentic-engineering", "description": "The autonomous engineering system for repository portfolios and everything its agents need — engineer, read-only surveyor, meta-engineer and Flux troubleshooter agents; portfolio, product, spend and improvement workflows; GitHub, CodeRabbit review, security, library documentation, Go, Kubernetes, Flux, Talos, SvelteKit frontend, Stripe payments, engineering-practice, design, product-management, marketing, finance and productivity skills; and the MCP servers they use; configured by the consumer AGENTS.md", - "version": "7.8.6", + "version": "7.8.7", "author": { "name": "devantler-tech", "url": "https://github.com/devantler-tech" diff --git a/plugins/agentic-engineering/.codex-plugin/plugin.json b/plugins/agentic-engineering/.codex-plugin/plugin.json index 537df68a..cc0db01d 100644 --- a/plugins/agentic-engineering/.codex-plugin/plugin.json +++ b/plugins/agentic-engineering/.codex-plugin/plugin.json @@ -1,7 +1,7 @@ { "name": "agentic-engineering", "description": "The autonomous engineering system for repository portfolios and everything its agents need — engineer, read-only surveyor, meta-engineer and Flux troubleshooter agents; portfolio, product, spend and improvement workflows; GitHub, CodeRabbit review, security, library documentation, Go, Kubernetes, Flux, Talos, SvelteKit frontend, Stripe payments, engineering-practice, design, product-management, marketing, finance and productivity skills; and the MCP servers they use; configured by the consumer AGENTS.md", - "version": "7.8.6", + "version": "7.8.7", "author": { "name": "devantler-tech", "url": "https://github.com/devantler-tech" diff --git a/plugins/agentic-engineering/CHANGELOG.md b/plugins/agentic-engineering/CHANGELOG.md index f88a3812..1e910b3e 100644 --- a/plugins/agentic-engineering/CHANGELOG.md +++ b/plugins/agentic-engineering/CHANGELOG.md @@ -1,5 +1,9 @@ # Changelog — `agentic-engineering` +## 7.8.7 — 2026-11-20 + +**Changed** — sync `stripe-best-practices` from `https://github.com/stripe/ai` at `refs/heads/main`. + ## 7.8.6 — 2026-11-16 **Changed** — sync `upgrade-stripe` from `https://github.com/stripe/ai` at `refs/heads/main`. diff --git a/plugins/agentic-engineering/skills/stripe-best-practices/SKILL.md b/plugins/agentic-engineering/skills/stripe-best-practices/SKILL.md index beef6e98..4220574b 100644 --- a/plugins/agentic-engineering/skills/stripe-best-practices/SKILL.md +++ b/plugins/agentic-engineering/skills/stripe-best-practices/SKILL.md @@ -4,10 +4,10 @@ metadata: github-path: skills/stripe-best-practices github-ref: refs/heads/main github-repo: https://github.com/stripe/ai - github-tree-sha: a78c5020f98df8948ebdc94f747313bdd3a1cb2c + github-tree-sha: 6d41f05b1d6809bf6e9361318194bbddead81e5b name: stripe-best-practices --- -Latest Stripe API version: **2026-10-28.endive**. Always use the latest API version and SDK unless the user specifies otherwise. +Latest Stripe API version: **2026-11-18.endive**. Always use the latest API version and SDK unless the user specifies otherwise. Development and testing environment default: For new integration development, use separate [sandboxes](https://docs.stripe.com/sandboxes.md) instead of the account’s shared test mode sandbox. Sandboxes isolate settings and test data from live mode. Use separate sandboxes for local development and CI. When stronger isolation is useful, dedicate sandboxes to development teams or testing scenarios. Use the shared test mode sandbox only for an existing integration that depends on it or when a required feature doesn’t support general sandboxes. @@ -45,7 +45,7 @@ API key default: Always recommend a [restricted API key (RAK)](https://docs.stri | Embedded financial accounts / banking | v2 Financial Accounts | | | Security (key management, RAKs, webhooks, OAuth, 2FA, Connect liability) | See security reference | | -Read the relevant reference file before answering any integration question or writing code. +Read the relevant reference file before answering any integration question or writing code. Reference paths are relative to this skill’s directory, not to the docs.stripe.com root. If you don’t have the skill files locally, append the path to **https://docs.stripe.com/.well-known/skills/stripe-best-practices/**. For example, fetch **https://docs.stripe.com/.well-known/skills/stripe-best-practices/references/connect.md**. ## Critical rules diff --git a/plugins/agentic-engineering/skills/stripe-best-practices/references/connect.md b/plugins/agentic-engineering/skills/stripe-best-practices/references/connect.md index 44f39b1e..b38f6d7e 100644 --- a/plugins/agentic-engineering/skills/stripe-best-practices/references/connect.md +++ b/plugins/agentic-engineering/skills/stripe-best-practices/references/connect.md @@ -52,6 +52,8 @@ If dashboard is `express`, provide access through [login links](https://docs.str - Charge pattern: Direct charges (connected account is merchant of record) - Code sample: [/connect/saas/tasks/create#code-sample](https://docs.stripe.com/connect/saas/tasks/create.md#code-sample) +**Customer-only accounts**: Setting `dashboard` or `defaults.responsibilities` on an account with only the Customer configuration fails with `unsupported_field_for_configs`. If a later update request adds `configuration.merchant` or requests `stripe_balance.stripe_transfers` for `configuration.recipient`, that request must include `dashboard` and `defaults.responsibilities`. You can’t change them after you set them. + **Marketplace (destination charges):** - `dashboard: "express"` diff --git a/plugins/agentic-engineering/skills/stripe-best-practices/references/payments.md b/plugins/agentic-engineering/skills/stripe-best-practices/references/payments.md index 140d7345..5c11e0ce 100644 --- a/plugins/agentic-engineering/skills/stripe-best-practices/references/payments.md +++ b/plugins/agentic-engineering/skills/stripe-best-practices/references/payments.md @@ -94,6 +94,7 @@ Don’t call other deprecated or outdated API endpoints unless there is a specif | Sources API | Deprecated | Setup Intents | [Setup Intents docs](https://docs.stripe.com/api/setup_intents.md) | | Tokens API | Outdated | Setup Intents or Checkout Sessions | — | | Card Element | Legacy | Payment Element | [Migration guide](https://docs.stripe.com/payments/payment-element/migration.md) | +| `payment_method_types` | Not recommended | Dynamic payment methods | [Migration guide](https://docs.stripe.com/payments/payment-methods/dynamic-payment-methods.md#migrate-to-dynamic-payment-methods) | ## PCI compliance