From 6b5b284df99b9101ddaa685d0d241554f5d3ed24 Mon Sep 17 00:00:00 2001 From: Claude Date: Tue, 19 May 2026 16:59:58 +0000 Subject: [PATCH] docs(distribution): add public roadmap for official marketplaces MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Serves both as a contributor checklist and as a signal to users searching for the plugin on first-party marketplaces. Listed channels (๐Ÿ“‹ planned / โณ in progress / โœ… live): - Anthropic claude-plugins-official ๐Ÿ“‹ - OpenAI Codex openai/plugins ๐Ÿ“‹ - Factory Droid ๐Ÿ“‹ - GitHub Copilot CLI ๐Ÿ“‹ - Anthropic Skill Marketplace โณ - Already-shipped channels โœ… (GitHub-backed marketplace, AGENTS.md / Cursor / Copilot / Windsurf / Mistral) Each planned entry includes the target user command and the concrete work to do (sync script, marketplace repo, PR target). README Discoverability section gets a one-liner pointing at the new doc. --- CHANGELOG.md | 2 + README.md | 9 ++++ docs/distribution.md | 110 +++++++++++++++++++++++++++++++++++++++++++ 3 files changed, 121 insertions(+) create mode 100644 docs/distribution.md diff --git a/CHANGELOG.md b/CHANGELOG.md index ffe846e..d84c0b4 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -13,6 +13,8 @@ All notable changes to this project are documented here. The format is based on - README *OpenCode* block in the per-harness Quickstart section pointing at `.opencode/INSTALL.md`. - `SessionStart` hook (`hooks/hooks.json`, `hooks/hooks-cursor.json`, `hooks/session-start`, `hooks/run-hook.cmd`, `hooks/intro.md`) auto-injects pointers to the `integrate` / `review` / `debug` skills and `/purchasely:question` command so the plugin is discoverable without the user typing a slash command first. Works on Claude Code, Cursor, and any host honoring the standard SDK `additionalContext` envelope. Zero-dependency POSIX shell + polyglot `.cmd` wrapper for Windows (Git Bash / WSL). - `.claude-plugin/plugin.json` now points at `./hooks/hooks.json`. +- `docs/distribution.md` โ€” public roadmap listing the official marketplaces we want to ship to (Anthropic `claude-plugins-official`, OpenAI Codex `openai/plugins`, Factory Droid, GitHub Copilot CLI, Anthropic Skill Marketplace) with status, target install command, and work-to-do for each. +- README *Discoverability* section now links to the distribution roadmap. ### Changed diff --git a/README.md b/README.md index ab2e318..9b1c726 100644 --- a/README.md +++ b/README.md @@ -263,6 +263,15 @@ Purchasely-AI-Plugin/ - An app configured in the Purchasely Console with at least one placement - Products/plans configured in your store (App Store Connect, Google Play Console, โ€ฆ) +## Discoverability + +This plugin is also published on: + +- ๐Ÿค– **[agentskill.sh](https://agentskill.sh)** โ€” community marketplace for AI agent skills (search `purchasely`) +- ๐Ÿ“ฆ **Claude Code marketplace** โ€” `/plugin marketplace add Purchasely/Purchasely-AI-Plugin` + +See [`docs/distribution.md`](docs/distribution.md) for the public roadmap of every official marketplace we're targeting (Anthropic, OpenAI Codex, Factory Droid, GitHub Copilot CLI, โ€ฆ) and how to help land each one. + ## Contributing Contributions welcome โ€” bug reports, new troubleshooting recipes, platform improvements, and translations to other AI tools. diff --git a/docs/distribution.md b/docs/distribution.md new file mode 100644 index 0000000..bf962ea --- /dev/null +++ b/docs/distribution.md @@ -0,0 +1,110 @@ +# Distribution roadmap โ€” official marketplaces + +Public roadmap for getting the Purchasely AI Plugin onto every relevant first-party marketplace. Each entry lists the **current status**, the **user-facing install command** we want to ship, and the **work to do** to get there. Contributions welcome โ€” open an issue or PR if you want to drive one of these forward. + +Legend: โœ… live ยท โณ in progress ยท ๐Ÿ“‹ planned + +## Anthropic Official Marketplace (`claude-plugins-official`) + +**Status:** ๐Ÿ“‹ planned + +**Target command:** + +```text +/plugin install purchasely@claude-plugins-official +``` + +**Work to do:** + +1. Open a PR on [`anthropics/claude-plugins`](https://github.com/anthropics/claude-plugins) listing Purchasely under the appropriate category (`sdk-integration` / `monetization`). +2. Pin to a tagged release (`v1.0.0`+) so the marketplace can refer to a stable artifact. +3. Coordinate with Anthropic on listing review and visibility. + +**Tracking issue:** _to be filed_ + +## OpenAI Codex plugin marketplace (`openai/plugins`) + +**Status:** ๐Ÿ“‹ planned + +**Target experience:** Codex CLI `/plugins` browser and Codex App Plugins sidebar surface a `purchasely` entry. + +**Work to do:** + +1. Add a `scripts/sync-to-codex-plugin.sh` adapted from [`obra/superpowers`](https://github.com/obra/superpowers) โ€” generates a `.codex-plugin/` directory derived from `AGENTS.md`, `skills/`, `commands/`, and `agents/`. +2. Wire the sync script into CI so the generated artifact stays in sync with `main`. +3. Open a PR on [`openai/plugins`](https://github.com/openai/plugins) referencing the synced repo (or a dedicated `Purchasely-AI-Plugin-codex` mirror). + +**Tracking issue:** _to be filed_ + +## Factory Droid marketplace + +**Status:** ๐Ÿ“‹ planned + +**Target command:** + +```bash +droid plugin marketplace add Purchasely/Purchasely-AI-Plugin-marketplace +droid plugin install purchasely +``` + +**Work to do:** + +1. Decide between a dedicated `Purchasely/Purchasely-AI-Plugin-marketplace` repo and reusing the marketplace already published on this repo (`/.claude-plugin/marketplace.json`). +2. Verify Factory Droid's plugin schema requirements (`droid.json` / equivalent manifest). +3. Submit the marketplace URL to Factory's plugin index. + +**Tracking issue:** _to be filed_ + +## GitHub Copilot CLI marketplace + +**Status:** ๐Ÿ“‹ planned + +**Target command:** + +```bash +copilot plugin marketplace add Purchasely/Purchasely-AI-Plugin-marketplace +copilot plugin install purchasely +``` + +**Work to do:** + +1. Create `Purchasely/Purchasely-AI-Plugin-marketplace` (mirroring this repo's `.claude-plugin/marketplace.json` structure) **or** confirm Copilot CLI accepts the existing marketplace manifest from `Purchasely/Purchasely-AI-Plugin`. +2. Validate end-to-end with `copilot plugin install` against a clean repo. +3. Submit to GitHub's plugin index when the marketplace API stabilizes. + +**Tracking issue:** _to be filed_ + +## Anthropic Skill Marketplace + +**Status:** โณ under investigation โ€” verify whether a Skill-only listing (separate from the Plugin marketplace above) is offered, and whether it makes sense to publish the three skills (`integrate`, `review`, `debug`) individually. + +**Target command:** TBD. + +**Work to do:** + +1. Confirm the existence and policy of an Anthropic Skill marketplace distinct from `claude-plugins-official`. +2. If it exists and accepts third-party skills, mirror the skills with appropriate `.skill/manifest.json` files. + +**Tracking issue:** _to be filed_ + +--- + +## Already shipped + +| Channel | Status | Install | +|---|---|---| +| GitHub-backed Claude Code marketplace | โœ… live | `/plugin marketplace add Purchasely/Purchasely-AI-Plugin` then `/plugin install purchasely@Purchasely-AI-Plugin` | +| Cross-vendor `AGENTS.md` (Codex, Cursor, Zed, Mistral `vibe`, โ€ฆ) | โœ… live | Copy `configs/codex/AGENTS.md` (or use the root `AGENTS.md` once #3 lands) | +| Cursor rules | โœ… live | Copy `configs/cursor/purchasely.mdc` to `.cursor/rules/` | +| GitHub Copilot instructions file | โœ… live | Copy `configs/copilot/copilot-instructions.md` to `.github/` | +| Windsurf | โœ… live | Copy `configs/windsurf/.windsurfrules` | +| Mistral `vibe` (`AGENTS.md`) | โœ… live | Copy `configs/mistral/AGENTS.md` | +| Gemini CLI extension | โณ pending #3 | `gemini extensions install https://github.com/Purchasely/Purchasely-AI-Plugin` | +| OpenCode | โณ pending #6 | See `.opencode/INSTALL.md` | + +## How to help + +1. Pick one of the ๐Ÿ“‹ / โณ entries above. +2. Open an issue on this repo titled `marketplace: ` describing what you intend to do. +3. Submit the PR (here for the sync script / manifest, on the marketplace repo for the listing). +4. Update this file moving the entry's status forward.