fluentcart-developer 1.1.0 → 1.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (65) hide show
  1. package/CLAUDE.md +22 -22
  2. package/LICENSE +21 -21
  3. package/README.md +169 -127
  4. package/SKILL.md +127 -127
  5. package/bin/index.js +281 -281
  6. package/package.json +48 -37
  7. package/skills/fluentcart-developer/SKILL.md +172 -172
  8. package/skills/fluentcart-developer/examples/README.md +25 -25
  9. package/skills/fluentcart-developer/examples/fluentcart-starter-child-theme/fluent-cart/checkout.php +32 -32
  10. package/skills/fluentcart-developer/examples/fluentcart-starter-child-theme/functions.php +40 -40
  11. package/skills/fluentcart-developer/examples/sample-custom-addon/fluentcart-custom-addon.php +114 -114
  12. package/skills/fluentcart-developer/examples/sample-custom-payment-gateway/fluentcart-custom-gateway-example.php +149 -149
  13. package/skills/fluentcart-developer/examples/sample-fee-surcharge-plugin/fluentcart-fee-surcharge.php +38 -38
  14. package/skills/fluentcart-developer/examples/sample-shipping-carrier/fluentcart-custom-shipping-carrier.php +62 -62
  15. package/skills/fluentcart-developer/references/action-hooks-admin-templates.md +787 -787
  16. package/skills/fluentcart-developer/references/action-hooks-cart-checkout.md +1355 -1355
  17. package/skills/fluentcart-developer/references/action-hooks-customers-users.md +266 -266
  18. package/skills/fluentcart-developer/references/action-hooks-licenses.md +855 -855
  19. package/skills/fluentcart-developer/references/action-hooks-orders.md +631 -631
  20. package/skills/fluentcart-developer/references/action-hooks-payments-integrations.md +963 -963
  21. package/skills/fluentcart-developer/references/action-hooks-products-coupons.md +585 -585
  22. package/skills/fluentcart-developer/references/action-hooks-subscriptions.md +661 -661
  23. package/skills/fluentcart-developer/references/database-models-query-builder.md +194 -194
  24. package/skills/fluentcart-developer/references/database-models-reference.md +604 -604
  25. package/skills/fluentcart-developer/references/database-schema-reference.md +940 -940
  26. package/skills/fluentcart-developer/references/engineering-notes.md +154 -154
  27. package/skills/fluentcart-developer/references/fee-system-guide.md +449 -449
  28. package/skills/fluentcart-developer/references/filter-hooks-cart-checkout.md +1202 -1202
  29. package/skills/fluentcart-developer/references/filter-hooks-customers-subscriptions.md +902 -902
  30. package/skills/fluentcart-developer/references/filter-hooks-integrations-advanced.md +1598 -1598
  31. package/skills/fluentcart-developer/references/filter-hooks-orders-payments.md +1319 -1319
  32. package/skills/fluentcart-developer/references/filter-hooks-products-pricing.md +628 -628
  33. package/skills/fluentcart-developer/references/filter-hooks-settings-configuration.md +1177 -1177
  34. package/skills/fluentcart-developer/references/fluentcart-developer-guide.md +154 -154
  35. package/skills/fluentcart-developer/references/ghost-product-selling.md +458 -458
  36. package/skills/fluentcart-developer/references/modules-and-extensions-reference.md +224 -224
  37. package/skills/fluentcart-developer/references/payment-gateway-integration.md +761 -761
  38. package/skills/fluentcart-developer/references/rest-api-checkout.md +286 -286
  39. package/skills/fluentcart-developer/references/rest-api-coupons.md +794 -794
  40. package/skills/fluentcart-developer/references/rest-api-customer-profile.md +190 -190
  41. package/skills/fluentcart-developer/references/rest-api-customers.md +1121 -1121
  42. package/skills/fluentcart-developer/references/rest-api-dashboard-utilities.md +219 -219
  43. package/skills/fluentcart-developer/references/rest-api-email-notifications.md +619 -619
  44. package/skills/fluentcart-developer/references/rest-api-files.md +290 -290
  45. package/skills/fluentcart-developer/references/rest-api-integrations.md +324 -324
  46. package/skills/fluentcart-developer/references/rest-api-labels-attributes.md +321 -321
  47. package/skills/fluentcart-developer/references/rest-api-licensing.md +171 -171
  48. package/skills/fluentcart-developer/references/rest-api-order-bumps.md +200 -200
  49. package/skills/fluentcart-developer/references/rest-api-orders.md +1241 -1241
  50. package/skills/fluentcart-developer/references/rest-api-overview.md +131 -131
  51. package/skills/fluentcart-developer/references/rest-api-products.md +2563 -2563
  52. package/skills/fluentcart-developer/references/rest-api-public-shop.md +172 -172
  53. package/skills/fluentcart-developer/references/rest-api-reference.md +552 -552
  54. package/skills/fluentcart-developer/references/rest-api-reports.md +377 -377
  55. package/skills/fluentcart-developer/references/rest-api-roles-permissions.md +147 -147
  56. package/skills/fluentcart-developer/references/rest-api-settings.md +528 -528
  57. package/skills/fluentcart-developer/references/rest-api-shipping.md +799 -799
  58. package/skills/fluentcart-developer/references/rest-api-subscriptions.md +606 -606
  59. package/skills/fluentcart-developer/references/rest-api-tax.md +356 -356
  60. package/skills/fluentcart-developer/references/subscription-customization.md +197 -197
  61. package/skills/fluentcart-developer/scripts/cli.js +1 -1
  62. package/.gitattributes +0 -2
  63. package/CONTRIBUTING.md +0 -73
  64. package/copy-skills.js +0 -43
  65. package/skills.sh.json +0 -13
package/CLAUDE.md CHANGED
@@ -1,22 +1,22 @@
1
- Skills are organized into bucket folders under `skills/`:
2
-
3
- - `engineering/` — daily code work
4
- - `productivity/` — daily non-code workflow tools
5
- - `misc/` — kept around but rarely used, not promoted
6
- - `personal/` — tied to my own setup, not promoted
7
- - `in-progress/` — drafts not yet ready to ship
8
- - `deprecated/` — no longer used
9
-
10
- Every skill in `engineering/` or `productivity/` (the **promoted** buckets) must have a reference in the top-level `README.md` and an entry in `.claude-plugin/plugin.json`. Skills in `misc/`, `personal/`, `in-progress/`, and `deprecated/` must not appear in either.
11
-
12
- Each skill entry in the top-level `README.md` must link the skill name to its `SKILL.md`.
13
-
14
- Each bucket folder has a `README.md` that lists every skill in the bucket with a one-line description, with the skill name linked to its `SKILL.md`. The promoted buckets' `README.md`s and the top-level `README.md` group entries into **User-invoked** and **Model-invoked**; non-promoted bucket `README.md`s (`misc/`, `personal/`) use a flat list.
15
-
16
- Skills in `engineering/` and `productivity/` also have a human-facing docs page at `docs/<bucket>/<skill-name>.md` (the docs tree mirrors those two bucket folders under `skills/`). The published URL is `https://aihero.dev/skills-<skill-name>` regardless of bucket — the docs path is repo organisation only. When you add, rename, or change the behaviour of a skill in `engineering/` or `productivity/`, create or re-sync its docs page following [.agents/writing-docs.md](./.agents/writing-docs.md). Skills in the non-promoted buckets (`misc/`, `personal/`, `in-progress/`, `deprecated/`) get **no** docs page.
17
-
18
- Every `SKILL.md` is either user-invoked (`disable-model-invocation: true`, reachable only by the human) or model-invoked (model- or user-reachable). See [.agents/invocation.md](./.agents/invocation.md).
19
-
20
- [`ask-matt`](./skills/engineering/ask-matt/SKILL.md) is the router that maps every user-reachable skill and how they relate. The same trigger that re-syncs a docs page applies to it: whenever you add, rename, remove, or change how a user-reachable skill fits the flows, re-read `ask-matt`'s `SKILL.md` and update it so the map stays accurate — a new skill it never mentions, or a stale one it still routes to, is a router that lies.
21
-
22
- To (re)link every skill into the local harness skill directories (`~/.claude/skills`, `~/.agents/skills`), run `scripts/link-skills.sh`. Each entry is a symlink into this repo, so a `git pull` keeps installed skills current; re-run the script after adding, removing, or renaming a skill.
1
+ Skills are organized into bucket folders under `skills/`:
2
+
3
+ - `engineering/` — daily code work
4
+ - `productivity/` — daily non-code workflow tools
5
+ - `misc/` — kept around but rarely used, not promoted
6
+ - `personal/` — tied to my own setup, not promoted
7
+ - `in-progress/` — drafts not yet ready to ship
8
+ - `deprecated/` — no longer used
9
+
10
+ Every skill in `engineering/` or `productivity/` (the **promoted** buckets) must have a reference in the top-level `README.md` and an entry in `.claude-plugin/plugin.json`. Skills in `misc/`, `personal/`, `in-progress/`, and `deprecated/` must not appear in either.
11
+
12
+ Each skill entry in the top-level `README.md` must link the skill name to its `SKILL.md`.
13
+
14
+ Each bucket folder has a `README.md` that lists every skill in the bucket with a one-line description, with the skill name linked to its `SKILL.md`. The promoted buckets' `README.md`s and the top-level `README.md` group entries into **User-invoked** and **Model-invoked**; non-promoted bucket `README.md`s (`misc/`, `personal/`) use a flat list.
15
+
16
+ Skills in `engineering/` and `productivity/` also have a human-facing docs page at `docs/<bucket>/<skill-name>.md` (the docs tree mirrors those two bucket folders under `skills/`). The published URL is `https://aihero.dev/skills-<skill-name>` regardless of bucket — the docs path is repo organisation only. When you add, rename, or change the behaviour of a skill in `engineering/` or `productivity/`, create or re-sync its docs page following [.agents/writing-docs.md](./.agents/writing-docs.md). Skills in the non-promoted buckets (`misc/`, `personal/`, `in-progress/`, `deprecated/`) get **no** docs page.
17
+
18
+ Every `SKILL.md` is either user-invoked (`disable-model-invocation: true`, reachable only by the human) or model-invoked (model- or user-reachable). See [.agents/invocation.md](./.agents/invocation.md).
19
+
20
+ [`ask-matt`](./skills/engineering/ask-matt/SKILL.md) is the router that maps every user-reachable skill and how they relate. The same trigger that re-syncs a docs page applies to it: whenever you add, rename, remove, or change how a user-reachable skill fits the flows, re-read `ask-matt`'s `SKILL.md` and update it so the map stays accurate — a new skill it never mentions, or a stale one it still routes to, is a router that lies.
21
+
22
+ To (re)link every skill into the local harness skill directories (`~/.claude/skills`, `~/.agents/skills`), run `scripts/link-skills.sh`. Each entry is a symlink into this repo, so a `git pull` keeps installed skills current; re-run the script after adding, removing, or renaming a skill.
package/LICENSE CHANGED
@@ -1,21 +1,21 @@
1
- MIT License
2
-
3
- Copyright (c) 2026 Matt Pocock
4
-
5
- Permission is hereby granted, free of charge, to any person obtaining a copy
6
- of this software and associated documentation files (the "Software"), to deal
7
- in the Software without restriction, including without limitation the rights
8
- to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
- copies of the Software, and to permit persons to whom the Software is
10
- furnished to do so, subject to the following conditions:
11
-
12
- The above copyright notice and this permission notice shall be included in all
13
- copies or substantial portions of the Software.
14
-
15
- THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
- IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
- FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
- AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
- LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
- OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
- SOFTWARE.
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Matt Pocock
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md CHANGED
@@ -1,127 +1,169 @@
1
- # Atif Jubaer's Agent Skills Repository
2
-
3
- [![npm version](https://img.shields.io/npm/v/fluentcart-developer.svg)](https://www.npmjs.com/package/fluentcart-developer)
4
- [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
5
-
6
- A comprehensive, platform-agnostic knowledge base, instruction set, and CLI toolkit for FluentCart theme, plugin, shipping, and payment gateway development.
7
-
8
- This repository provides ready-to-use configurations, reference manuals, and code boilerplates for all major AI coding assistants (Antigravity, Cursor, Claude Code, Windsurf, Cline, Zed, GitHub Copilot), enabling them to write correct, compatible code for FluentCart out-of-the-box.
9
-
10
- ---
11
-
12
- ## Included Skills
13
-
14
- - **`FluentCart Developer`** (`fluentcart-developer`):
15
- - **Complete Database Manual:** 34 DB migrations, all `wp_fct_*` schema tables, Eloquent ORM models, relationships, and Query Builder.
16
- - **315+ Action & Filter Hooks:** 14 dedicated hook reference files covering order lifecycles, payment webhooks, cart fees, and admin UI.
17
- - **15 REST API Modules (Core & Pro):** Orders, Products, Customers, Coupons, Subscriptions, Tax, Shipping, Settings, Email Notifications, Reports, Integrations, Files, Labels & Attributes, Dashboard & Utilities, Public Shop, Checkout, Customer Profile, Software Licensing (Pro), Roles & Permissions (Pro), Order Bumps (Pro).
18
- - **5 Runnable Example Projects:** Custom Addon plugin, Fee Surcharge plugin, Payment Gateway plugin, Shipping Carrier, and Starter Child Theme.
19
-
20
- ---
21
-
22
- ## Installation & Setup
23
-
24
- Choose the installation method that fits your environment and AI coding assistant:
25
-
26
- ### Method 1: The `skills.sh` Method (Recommended for Cursor, Claude Code, Windsurf, Antigravity)
27
-
28
- Install this skill directly into your project's local workspace using the official `skills.sh` manager:
29
-
30
- ```bash
31
- # Install specific skill into current project
32
- npx skills add atifjubaer/skills --skill "fluentcart-developer"
33
-
34
- # Or run interactively without flags to pick from list
35
- npx skills add atifjubaer/skills
36
- ```
37
-
38
- ---
39
-
40
- ### Method 2: Updating Installed Skills
41
-
42
- To fetch and update your installed skills to the latest version on GitHub:
43
-
44
- ```bash
45
- # Update all installed skills in current workspace via skills.sh
46
- npx skills update
47
-
48
- # Or force reinstall the latest version from GitHub
49
- npx skills add atifjubaer/skills --skill "fluentcart-developer" --force
50
- ```
51
-
52
- If you cloned this repository locally:
53
- ```bash
54
- git pull origin main
55
- ```
56
-
57
- ---
58
-
59
- ### Method 3: Direct CLI Initializer & Interactive Wizard
60
-
61
- Run the CLI command without arguments for an interactive selection prompt:
62
-
63
- ```bash
64
- npx fluentcart-developer
65
- ```
66
-
67
- Or pass direct command flags:
68
-
69
- ```bash
70
- # Initialize both global skills and current project rules for all IDEs
71
- npx fluentcart-developer init
72
-
73
- # Setup ONLY global skills (~/.gemini/, ~/.claude/)
74
- npx fluentcart-developer global
75
-
76
- # Setup ONLY local project rules
77
- npx fluentcart-developer project
78
-
79
- # Safely remove rule markers from project and global files
80
- npx fluentcart-developer remove
81
- ```
82
-
83
- ---
84
-
85
- ### Method 4: Manual Installation
86
-
87
- If you prefer manual setup:
88
- 1. **For Antigravity / Gemini**: Copy `SKILL.md`, `references/`, and `examples/` from `skills/fluentcart-developer/` into your global Gemini config path:
89
- `~/.gemini/config/skills/fluentcart-developer/`
90
- 2. **For Cursor / Windsurf / Cline / Zed**: Copy `.cursorrules` to your project root.
91
- 3. **For Claude Code**: Copy `CLAUDE.md` to your project root.
92
- 4. **For Web-based AIs**: Copy the content of `fluentcart-rules.md` and paste it into your chat session.
93
-
94
- ---
95
-
96
- ## Repository Folder Structure
97
-
98
- ```
99
- skills/
100
- ├── README.md # Installation guide and repository overview
101
- ├── package.json # Package configuration
102
- ├── copy-skills.js # Automated skill sync builder
103
- ├── skills.sh.json # skills.sh catalog layout configuration
104
- ├── CLAUDE.md # Claude Code instructions
105
- ├── CONTRIBUTING.md # Guidelines for repository contributors
106
- ├── LICENSE # MIT License
107
- ├── bin/
108
- │ └── index.js # Interactive CLI runner
109
- ├── .github/
110
- │ └── workflows/
111
- │ └── sync-docs.yml # GitHub Actions automated doc sync workflow
112
- ├── references/ # Root reference manuals catalog
113
- ├── examples/ # Standalone boilerplate code examples
114
- │ ├── sample-custom-payment-gateway/
115
- │ ├── sample-shipping-carrier/
116
- │ └── fluentcart-starter-child-theme/
117
- └── skills/
118
- └── fluentcart-developer/ # 👈 Clean skill directory for skills.sh
119
- ├── SKILL.md # Main index prompt file
120
- ├── references/ # Complete developer manuals & schemas
121
- └── examples/ # Standalone plugin & theme boilerplates
122
- ```
123
-
124
- ---
125
-
126
- ## Created by
127
- Developed and maintained by **Fastrsoft** (Atif Jubaer).
1
+ # Atif Jubaer's Agent Skills Repository
2
+
3
+ [![npm version](https://img.shields.io/npm/v/fluentcart-developer.svg)](https://www.npmjs.com/package/fluentcart-developer)
4
+ [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
5
+
6
+ A comprehensive, platform-agnostic knowledge base, instruction set, and CLI toolkit for FluentCart theme, plugin, shipping, and payment gateway development.
7
+
8
+ This repository provides ready-to-use configurations, reference manuals, and code boilerplates for all major AI coding assistants (Antigravity, Cursor, Claude Code, Windsurf, Cline, Zed, GitHub Copilot), enabling them to write correct, compatible code for FluentCart out-of-the-box.
9
+
10
+ ---
11
+
12
+ ## Included Skills
13
+
14
+ - **`FluentCart Developer`** (`fluentcart-developer`):
15
+ - **Complete Database Manual:** 34 DB migrations, all `wp_fct_*` schema tables, Eloquent ORM models, relationships, and Query Builder.
16
+ - **315+ Action & Filter Hooks:** 14 dedicated hook reference files covering order lifecycles, payment webhooks, cart fees, and admin UI.
17
+ - **15 REST API Modules (Core & Pro):** Orders, Products, Customers, Coupons, Subscriptions, Tax, Shipping, Settings, Email Notifications, Reports, Integrations, Files, Labels & Attributes, Dashboard & Utilities, Public Shop, Checkout, Customer Profile, Software Licensing (Pro), Roles & Permissions (Pro), Order Bumps (Pro).
18
+ - **5 Runnable Example Projects:** Custom Addon plugin, Fee Surcharge plugin, Payment Gateway plugin, Shipping Carrier, and Starter Child Theme.
19
+
20
+ - **`Lemon Squeezy Developer`** (`lemonsqueezy-developer`):
21
+ - **Complete JSON:API Manual:** Stores, Products, Variants, Prices, Files, Orders, and Subscriptions specifications.
22
+ - **HMAC-SHA256 Webhook Security:** Timing-safe raw request signature verifiers for Node.js, Next.js App Router, and PHP.
23
+ - **Subscriptions Lifecycle:** State transitions, pausing, cancellations, dunning retries, and hosted customer portal URLs.
24
+ - **Software Licensing:** Public `/activate`, `/validate`, and `/deactivate` endpoints for desktop software and plugins.
25
+ - **Dynamic Checkouts & Lemon.js:** API checkout generation, in-app modal overlays, and custom metadata tracking.
26
+
27
+ ---
28
+
29
+ ## Playing Cards (MCP Server)
30
+
31
+ Skills tell the model what to do. The MCP server in [`server/`](./server/README.md) gives it the tools to do it — without loading a single large markdown file into context.
32
+
33
+ | Card | Core (free) | Pro |
34
+ | --- | --- | --- |
35
+ | **Card 1 — FluentCart Pro Agent** | `fc_search_hooks`, `fc_get_db_schema` | `fc_generate_payment_gateway_boilerplate` |
36
+ | **Card 2 — Lemon Squeezy Developer Agent** | `ls_search_docs`, `ls_get_schema` | `ls_verify_webhook`, `ls_validate_license` |
37
+
38
+ Every session also exposes the skills catalog itself (`skills/list`, `resources/read`), so the agent reads one reference file on demand instead of the whole knowledge base.
39
+
40
+ ```bash
41
+ cd server && npm install && npm run build
42
+ node dist/index.js # stdio: Claude Code, Cursor, Windsurf, Smithery CLI
43
+ node dist/http.js # Streamable HTTP on :8080: MCPize, Railway, Render, Fly.io
44
+ ```
45
+
46
+ Pro tools are not registered on a free session — the schemas never reach the client. Unlock with a Lemon Squeezy license key (`Authorization: Bearer <key>` over HTTP, `PRO_LICENSE_KEY` for local stdio). Tier resolution, marketplace gateway secrets and deployment are documented in [`server/README.md`](./server/README.md).
47
+
48
+ **Licensing:** skill content (`skills/`) is MIT and stays public for discovery and `skills.sh` indexing. The server implementation (`server/`) is BSL-1.1 — see [`server/LICENSE.md`](./server/LICENSE.md).
49
+
50
+ ---
51
+
52
+ ## Installation & Setup
53
+
54
+ Choose the installation method that fits your environment and AI coding assistant:
55
+
56
+ ### Method 1: The `skills.sh` Method (Recommended for Cursor, Claude Code, Windsurf, Antigravity)
57
+
58
+ Install this skill directly into your project's local workspace using the official `skills.sh` manager:
59
+
60
+ ```bash
61
+ # Install specific skill into current project
62
+ npx skills add atifjubaer/skills --skill "fluentcart-developer"
63
+
64
+ # Or run interactively without flags to pick from list
65
+ npx skills add atifjubaer/skills
66
+ ```
67
+
68
+ ---
69
+
70
+ ### Method 2: Updating Installed Skills
71
+
72
+ To fetch and update your installed skills to the latest version on GitHub:
73
+
74
+ ```bash
75
+ # Update all installed skills in current workspace via skills.sh
76
+ npx skills update
77
+
78
+ # Or force reinstall the latest version from GitHub
79
+ npx skills add atifjubaer/skills --skill "fluentcart-developer" --force
80
+ ```
81
+
82
+ If you cloned this repository locally:
83
+ ```bash
84
+ git pull origin main
85
+ ```
86
+
87
+ ---
88
+
89
+ ### Method 3: Direct CLI Initializer & Interactive Wizard
90
+
91
+ Run the CLI command without arguments for an interactive selection prompt:
92
+
93
+ ```bash
94
+ npx fluentcart-developer
95
+ ```
96
+
97
+ Or pass direct command flags:
98
+
99
+ ```bash
100
+ # Initialize both global skills and current project rules for all IDEs
101
+ npx fluentcart-developer init
102
+
103
+ # Setup ONLY global skills (~/.gemini/, ~/.claude/)
104
+ npx fluentcart-developer global
105
+
106
+ # Setup ONLY local project rules
107
+ npx fluentcart-developer project
108
+
109
+ # Safely remove rule markers from project and global files
110
+ npx fluentcart-developer remove
111
+ ```
112
+
113
+ ---
114
+
115
+ ### Method 4: Manual Installation
116
+
117
+ If you prefer manual setup:
118
+ 1. **For Antigravity / Gemini**: Copy `SKILL.md`, `references/`, and `examples/` from `skills/fluentcart-developer/` into your global Gemini config path:
119
+ `~/.gemini/config/skills/fluentcart-developer/`
120
+ 2. **For Cursor / Windsurf / Cline / Zed**: Copy `.cursorrules` to your project root.
121
+ 3. **For Claude Code**: Copy `CLAUDE.md` to your project root.
122
+ 4. **For Web-based AIs**: Copy the content of `fluentcart-rules.md` and paste it into your chat session.
123
+
124
+ ---
125
+
126
+ ## Repository Folder Structure
127
+
128
+ ```
129
+ skills/
130
+ ├── README.md # Installation guide and repository overview
131
+ ├── package.json # Package configuration
132
+ ├── copy-skills.js # Automated skill sync builder
133
+ ├── skills.sh.json # skills.sh catalog layout configuration
134
+ ├── CLAUDE.md # Claude Code instructions
135
+ ├── CONTRIBUTING.md # Guidelines for repository contributors
136
+ ├── LICENSE # MIT License
137
+ ├── bin/
138
+ │ └── index.js # Interactive CLI runner
139
+ ├── .github/
140
+ │ └── workflows/
141
+ │ └── sync-docs.yml # GitHub Actions automated doc sync workflow
142
+ ├── references/ # Root reference manuals catalog
143
+ ├── examples/ # Standalone boilerplate code examples
144
+ │ ├── sample-custom-payment-gateway/
145
+ │ ├── sample-shipping-carrier/
146
+ │ └── fluentcart-starter-child-theme/
147
+ ├── server/ # 👈 MCP server (BSL-1.1, commercial)
148
+ │ ├── src/
149
+ │ │ ├── auth.ts # Core / Pro tier resolution
150
+ │ │ ├── server.ts # Server factory + skills catalog
151
+ │ │ ├── index.ts # stdio entry
152
+ │ │ ├── http.ts # Streamable HTTP entry
153
+ │ │ └── cards/ # One folder per Playing Card
154
+ │ ├── scripts/ # Build bundler + protocol probe
155
+ │ └── Dockerfile # Build from repo root
156
+ └── skills/ # 👈 Skill content (MIT, public)
157
+ ├── fluentcart-developer/ # Card 1
158
+ │ ├── SKILL.md
159
+ │ ├── references/
160
+ │ └── examples/
161
+ └── lemonsqueezy-developer/ # Card 2
162
+ ├── SKILL.md
163
+ └── references/
164
+ ```
165
+
166
+ ---
167
+
168
+ ## Created by
169
+ Developed and maintained by **Fastrsoft** (Atif Jubaer).