wingmanpm-product-designer 1.0.0

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 (105) hide show
  1. package/.agents/plugins/marketplace.json +20 -0
  2. package/.claude-plugin/marketplace.json +34 -0
  3. package/.claude-plugin/plugin.json +28 -0
  4. package/.codex-plugin/plugin.json +51 -0
  5. package/CHANGELOG.md +31 -0
  6. package/LICENSE +189 -0
  7. package/NOTICE +9 -0
  8. package/PRIVACY.md +40 -0
  9. package/README.md +161 -0
  10. package/SECURITY.md +39 -0
  11. package/SUPPORT.md +27 -0
  12. package/TERMS.md +46 -0
  13. package/assets/mark.svg +11 -0
  14. package/assets/plugin-icon.png +0 -0
  15. package/assets/plugin-logo-dark.png +0 -0
  16. package/assets/plugin-logo.png +0 -0
  17. package/assets/plugin-screenshot-ai.png +0 -0
  18. package/assets/plugin-screenshot-marketing.png +0 -0
  19. package/assets/plugin-screenshot-workspace.png +0 -0
  20. package/assets/social-preview.png +0 -0
  21. package/assets/wordmark.svg +15 -0
  22. package/bin/wingman-design.mjs +9 -0
  23. package/bin/wingmanpm-product-designer.mjs +56 -0
  24. package/docs/assets/readme/comparison-ai-review.webp +0 -0
  25. package/docs/assets/readme/comparison-marketing.webp +0 -0
  26. package/docs/assets/readme/comparison-workspace.webp +0 -0
  27. package/docs/assets/readme/hero-dark.webp +0 -0
  28. package/docs/assets/readme/hero-light.webp +0 -0
  29. package/docs/assets/readme/responsive-proof.webp +0 -0
  30. package/docs/compatibility.md +57 -0
  31. package/docs/publication-record.md +55 -0
  32. package/docs/release-roadmap.md +32 -0
  33. package/package.json +74 -0
  34. package/plugin.json +22 -0
  35. package/skills/wingmanpm-product-designer/LICENSE +189 -0
  36. package/skills/wingmanpm-product-designer/NOTICE +9 -0
  37. package/skills/wingmanpm-product-designer/SKILL.md +111 -0
  38. package/skills/wingmanpm-product-designer/agents/openai.yaml +7 -0
  39. package/skills/wingmanpm-product-designer/bin/wingman-design.mjs +9 -0
  40. package/skills/wingmanpm-product-designer/references/ai-ui.md +52 -0
  41. package/skills/wingmanpm-product-designer/references/data-tables.md +140 -0
  42. package/skills/wingmanpm-product-designer/references/forms.md +50 -0
  43. package/skills/wingmanpm-product-designer/references/marketing.md +38 -0
  44. package/skills/wingmanpm-product-designer/references/motion.md +60 -0
  45. package/skills/wingmanpm-product-designer/references/navigation.md +43 -0
  46. package/skills/wingmanpm-product-designer/references/product-craft.md +69 -0
  47. package/skills/wingmanpm-product-designer/references/product-ui.md +65 -0
  48. package/skills/wingmanpm-product-designer/references/qa.md +78 -0
  49. package/skills/wingmanpm-product-designer/references/registry.md +18 -0
  50. package/skills/wingmanpm-product-designer/references/system.md +83 -0
  51. package/skills/wingmanpm-product-designer/references/transforms.md +88 -0
  52. package/skills/wingmanpm-product-designer/registry/commands.json +254 -0
  53. package/skills/wingmanpm-product-designer/registry/rules.json +269 -0
  54. package/skills/wingmanpm-product-designer/schemas/browser-evidence.schema.json +63 -0
  55. package/skills/wingmanpm-product-designer/schemas/commands.schema.json +86 -0
  56. package/skills/wingmanpm-product-designer/schemas/config.schema.json +39 -0
  57. package/skills/wingmanpm-product-designer/schemas/exceptions.schema.json +25 -0
  58. package/skills/wingmanpm-product-designer/schemas/review.schema.json +62 -0
  59. package/skills/wingmanpm-product-designer/schemas/table-contract.schema.json +333 -0
  60. package/skills/wingmanpm-product-designer/src/browser-reporter.mjs +115 -0
  61. package/skills/wingmanpm-product-designer/src/checker.mjs +1096 -0
  62. package/skills/wingmanpm-product-designer/src/cli.mjs +1182 -0
  63. package/skills/wingmanpm-product-designer/src/intents.mjs +220 -0
  64. package/skills/wingmanpm-product-designer/src/review.mjs +112 -0
  65. package/skills/wingmanpm-product-designer/src/table-scaffold.mjs +1195 -0
  66. package/skills/wingmanpm-product-designer/src/tokens.mjs +124 -0
  67. package/skills/wingmanpm-product-designer/src/utils.mjs +167 -0
  68. package/skills/wingmanpm-product-designer/templates/data-table/neutral/data-table.html +125 -0
  69. package/skills/wingmanpm-product-designer/templates/data-table/neutral/static-table.html +49 -0
  70. package/skills/wingmanpm-product-designer/templates/data-table/optional/README.md +20 -0
  71. package/skills/wingmanpm-product-designer/templates/data-table/optional/VirtualizedBody.fixture.tsx +37 -0
  72. package/skills/wingmanpm-product-designer/templates/data-table/react/data-table/ColumnReorderAdapter.tsx +67 -0
  73. package/skills/wingmanpm-product-designer/templates/data-table/react/data-table/DataTable.css +662 -0
  74. package/skills/wingmanpm-product-designer/templates/data-table/react/data-table/DataTable.tsx +1140 -0
  75. package/skills/wingmanpm-product-designer/templates/data-table/react/data-table/DataTable.types.ts +236 -0
  76. package/skills/wingmanpm-product-designer/templates/data-table/react/data-table/DataTablePreferences.ts +83 -0
  77. package/skills/wingmanpm-product-designer/templates/data-table/react/data-table/TableTooltip.tsx +114 -0
  78. package/skills/wingmanpm-product-designer/templates/data-table/react/data-table/index.ts +3 -0
  79. package/skills/wingmanpm-product-designer/templates/data-table/react-static/StaticDataTable.css +168 -0
  80. package/skills/wingmanpm-product-designer/templates/data-table/react-static/StaticDataTable.tsx +180 -0
  81. package/skills/wingmanpm-product-designer/templates/data-table/react-static/index.ts +6 -0
  82. package/skills/wingmanpm-product-designer/templates/design-system/COMPONENTS.md +28 -0
  83. package/skills/wingmanpm-product-designer/templates/design-system/DESIGN.md +47 -0
  84. package/skills/wingmanpm-product-designer/templates/design-system/PRODUCT.md +35 -0
  85. package/skills/wingmanpm-product-designer/templates/design-system/surfaces/index.md +30 -0
  86. package/skills/wingmanpm-product-designer/templates/design-system/surfaces/marketing.md +25 -0
  87. package/skills/wingmanpm-product-designer/templates/design-system/tables/README.md +16 -0
  88. package/skills/wingmanpm-product-designer/templates/design-system/tokens/tokens.json +54 -0
  89. package/skills/wingmanpm-product-designer/templates/project/.storybook/main.ts +15 -0
  90. package/skills/wingmanpm-product-designer/templates/project/.storybook/preview.ts +27 -0
  91. package/skills/wingmanpm-product-designer/templates/project/.wingmanpm-design/config.json +12 -0
  92. package/skills/wingmanpm-product-designer/templates/project/.wingmanpm-design/exceptions.json +3 -0
  93. package/skills/wingmanpm-product-designer/templates/project/.wingmanpm-design/review.json +20 -0
  94. package/skills/wingmanpm-product-designer/templates/project/neutral/semantic-ui.html +25 -0
  95. package/skills/wingmanpm-product-designer/templates/project/root/playwright.wingman.config.ts +19 -0
  96. package/skills/wingmanpm-product-designer/templates/project/src/components/wingman-design/AccountPatterns.tsx +28 -0
  97. package/skills/wingmanpm-product-designer/templates/project/src/components/wingman-design/AppShell.tsx +62 -0
  98. package/skills/wingmanpm-product-designer/templates/project/src/components/wingman-design/OperationalPatterns.tsx +93 -0
  99. package/skills/wingmanpm-product-designer/templates/project/src/components/wingman-design/ProductWorkspace.tsx +86 -0
  100. package/skills/wingmanpm-product-designer/templates/project/src/components/wingman-design/StatePanel.tsx +36 -0
  101. package/skills/wingmanpm-product-designer/templates/project/src/components/wingman-design/TransparentAIReview.tsx +76 -0
  102. package/skills/wingmanpm-product-designer/templates/project/src/components/wingman-design/index.ts +6 -0
  103. package/skills/wingmanpm-product-designer/templates/project/src/components/wingman-design/system.css +155 -0
  104. package/skills/wingmanpm-product-designer/templates/project/src/stories/WingmanProduct.stories.tsx +65 -0
  105. package/skills/wingmanpm-product-designer/templates/project/tests/wingman-design/visual.spec.ts +365 -0
@@ -0,0 +1,20 @@
1
+ {
2
+ "name": "wingmanpm",
3
+ "interface": {
4
+ "displayName": "WingmanPM"
5
+ },
6
+ "plugins": [
7
+ {
8
+ "name": "wingmanpm-product-designer",
9
+ "source": {
10
+ "source": "local",
11
+ "path": "./"
12
+ },
13
+ "policy": {
14
+ "installation": "AVAILABLE",
15
+ "authentication": "ON_INSTALL"
16
+ },
17
+ "category": "Developer Tools"
18
+ }
19
+ ]
20
+ }
@@ -0,0 +1,34 @@
1
+ {
2
+ "name": "wingmanpm",
3
+ "owner": {
4
+ "name": "Julius / Qewler",
5
+ "url": "https://github.com/Qewler"
6
+ },
7
+ "description": "Product design skills for coding agents building polished, accessible digital products.",
8
+ "version": "1.0.0",
9
+ "plugins": [
10
+ {
11
+ "name": "wingmanpm-product-designer",
12
+ "displayName": "WingmanPM Product Designer",
13
+ "source": "./",
14
+ "description": "Product design judgment for coding agents building accessible, responsive digital products.",
15
+ "version": "1.0.0",
16
+ "author": {
17
+ "name": "Julius / Qewler",
18
+ "url": "https://github.com/Qewler"
19
+ },
20
+ "homepage": "https://github.com/Qewler/wingmanpm-product-designer#readme",
21
+ "repository": "https://github.com/Qewler/wingmanpm-product-designer",
22
+ "license": "Apache-2.0",
23
+ "category": "design",
24
+ "tags": [
25
+ "product-design",
26
+ "ui",
27
+ "ux",
28
+ "frontend",
29
+ "accessibility"
30
+ ],
31
+ "strict": true
32
+ }
33
+ ]
34
+ }
@@ -0,0 +1,28 @@
1
+ {
2
+ "$schema": "https://json.schemastore.org/claude-code-plugin-manifest.json",
3
+ "name": "wingmanpm-product-designer",
4
+ "displayName": "WingmanPM Product Designer",
5
+ "version": "1.0.0",
6
+ "description": "Product design judgment for coding agents building accessible, responsive digital products.",
7
+ "author": {
8
+ "name": "Julius / Qewler",
9
+ "url": "https://github.com/Qewler"
10
+ },
11
+ "homepage": "https://github.com/Qewler/wingmanpm-product-designer#readme",
12
+ "repository": "https://github.com/Qewler/wingmanpm-product-designer",
13
+ "license": "Apache-2.0",
14
+ "keywords": [
15
+ "product-design",
16
+ "ui",
17
+ "ux",
18
+ "frontend",
19
+ "accessibility",
20
+ "design-systems",
21
+ "agent-skill"
22
+ ],
23
+ "metadata": {
24
+ "privacyPolicy": "https://github.com/Qewler/wingmanpm-product-designer/blob/main/PRIVACY.md",
25
+ "termsOfService": "https://github.com/Qewler/wingmanpm-product-designer/blob/main/TERMS.md",
26
+ "support": "https://github.com/Qewler/wingmanpm-product-designer/issues"
27
+ }
28
+ }
@@ -0,0 +1,51 @@
1
+ {
2
+ "name": "wingmanpm-product-designer",
3
+ "version": "1.0.0",
4
+ "description": "Product design judgment for coding agents building accessible, responsive digital products.",
5
+ "author": {
6
+ "name": "Julius / Qewler",
7
+ "url": "https://github.com/Qewler"
8
+ },
9
+ "homepage": "https://github.com/Qewler/wingmanpm-product-designer#readme",
10
+ "repository": "https://github.com/Qewler/wingmanpm-product-designer",
11
+ "license": "Apache-2.0",
12
+ "keywords": [
13
+ "product-design",
14
+ "ui",
15
+ "ux",
16
+ "frontend",
17
+ "accessibility",
18
+ "design-systems",
19
+ "agent-skill"
20
+ ],
21
+ "skills": "./skills/",
22
+ "interface": {
23
+ "displayName": "WingmanPM Product Designer",
24
+ "shortDescription": "Design better products with coding agents.",
25
+ "longDescription": "Give Codex product design judgment for real shipping work. The skill inspects existing product truth, chooses the right level of change, and guides responsive interface design, design systems, data tables, AI flows, onboarding, navigation, marketing surfaces, accessibility, browser QA, and evidence-backed handoff. It preserves business logic and project ownership while requiring keyboard support, reduced motion, complete states, and human review for consequential AI actions. Support: https://github.com/Qewler/wingmanpm-product-designer/issues",
26
+ "developerName": "Julius / Qewler",
27
+ "category": "Developer Tools",
28
+ "capabilities": [
29
+ "Interactive",
30
+ "Read",
31
+ "Write"
32
+ ],
33
+ "websiteURL": "https://github.com/Qewler/wingmanpm-product-designer",
34
+ "privacyPolicyURL": "https://github.com/Qewler/wingmanpm-product-designer/blob/main/PRIVACY.md",
35
+ "termsOfServiceURL": "https://github.com/Qewler/wingmanpm-product-designer/blob/main/TERMS.md",
36
+ "defaultPrompt": [
37
+ "Design and build a responsive dashboard for this product",
38
+ "Review this interface and explain the highest-impact fixes",
39
+ "Polish this flow without changing its product behavior"
40
+ ],
41
+ "brandColor": "#1842B4",
42
+ "composerIcon": "./assets/plugin-icon.png",
43
+ "logo": "./assets/plugin-logo.png",
44
+ "logoDark": "./assets/plugin-logo-dark.png",
45
+ "screenshots": [
46
+ "./assets/plugin-screenshot-workspace.png",
47
+ "./assets/plugin-screenshot-ai.png",
48
+ "./assets/plugin-screenshot-marketing.png"
49
+ ]
50
+ }
51
+ }
package/CHANGELOG.md ADDED
@@ -0,0 +1,31 @@
1
+ # Changelog
2
+
3
+ All notable changes to WingmanPM Product Designer are documented here.
4
+
5
+ The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
6
+ and releases use [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
7
+
8
+ ## [Unreleased]
9
+
10
+ ## [1.0.0] - 2026-08-31
11
+
12
+ ### Added
13
+
14
+ - Public Agent Skill for designing, building, reviewing, polishing, and
15
+ verifying responsive digital product interfaces.
16
+ - Portable Agent Plugins 1.0 manifest and native Codex and Claude Code plugin
17
+ manifests.
18
+ - Codex and Claude Code marketplace metadata for the `wingmanpm` publisher.
19
+ - Safe command-line installation, upgrade, checks, and removal for supported
20
+ coding-agent hosts.
21
+ - Public before-and-after showcase and reproducible browser evidence.
22
+ - Privacy, terms, support, and security documentation.
23
+
24
+ ### Security
25
+
26
+ - Skills-only release with no MCP server, authentication, telemetry, remote
27
+ code loader, or install-time lifecycle script.
28
+ - Content-hash protection for user-modified installed files.
29
+
30
+ [Unreleased]: https://github.com/Qewler/wingmanpm-product-designer/compare/v1.0.0...HEAD
31
+ [1.0.0]: https://github.com/Qewler/wingmanpm-product-designer/releases/tag/v1.0.0
package/LICENSE ADDED
@@ -0,0 +1,189 @@
1
+ Apache License
2
+ Version 2.0, January 2004
3
+ http://www.apache.org/licenses/
4
+
5
+ TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
6
+
7
+ 1. Definitions.
8
+
9
+ "License" shall mean the terms and conditions for use, reproduction,
10
+ and distribution as defined by Sections 1 through 9 of this document.
11
+
12
+ "Licensor" shall mean the copyright owner or entity authorized by
13
+ the copyright owner that is granting the License.
14
+
15
+ "Legal Entity" shall mean the union of the acting entity and all
16
+ other entities that control, are controlled by, or are under common
17
+ control with that entity. For the purposes of this definition,
18
+ "control" means (i) the power, direct or indirect, to cause the
19
+ direction or management of such entity, whether by contract or
20
+ otherwise, or (ii) ownership of fifty percent (50%) or more of the
21
+ outstanding shares, or (iii) beneficial ownership of such entity.
22
+
23
+ "You" (or "Your") shall mean an individual or Legal Entity
24
+ exercising permissions granted by this License.
25
+
26
+ "Source" form shall mean the preferred form for making modifications,
27
+ including but not limited to software source code, documentation
28
+ source, and configuration files.
29
+
30
+ "Object" form shall mean any form resulting from mechanical
31
+ transformation or translation of a Source form, including but
32
+ not limited to compiled object code, generated documentation,
33
+ and conversions to other media types.
34
+
35
+ "Work" shall mean the work of authorship, whether in Source or
36
+ Object form, made available under the License, as indicated by a
37
+ copyright notice that is included in or attached to the work.
38
+
39
+ "Derivative Works" shall mean any work, whether in Source or Object
40
+ form, that is based on (or derived from) the Work and for which the
41
+ editorial revisions, annotations, elaborations, or other modifications
42
+ represent, as a whole, an original work of authorship. For the purposes
43
+ of this License, Derivative Works shall not include works that remain
44
+ separable from, or merely link (or bind by name) to the interfaces of,
45
+ the Work and Derivative Works thereof.
46
+
47
+ "Contribution" shall mean any work of authorship, including
48
+ the original version of the Work and any modifications or additions
49
+ to that Work or Derivative Works thereof, that is intentionally
50
+ submitted to Licensor for inclusion in the Work by the copyright owner
51
+ or by an individual or Legal Entity authorized to submit on behalf of
52
+ the copyright owner. For the purposes of this definition, "submitted"
53
+ means any form of electronic, verbal, or written communication sent
54
+ to the Licensor or its representatives, including but not limited to
55
+ communication on electronic mailing lists, source code control systems,
56
+ and issue tracking systems that are managed by, or on behalf of, the
57
+ Licensor for the purpose of discussing and improving the Work, but
58
+ excluding communication that is conspicuously marked or otherwise
59
+ designated in writing by the copyright owner as "Not a Contribution."
60
+
61
+ "Contributor" shall mean Licensor and any individual or Legal Entity
62
+ on behalf of whom a Contribution has been received by Licensor and
63
+ subsequently incorporated within the Work.
64
+
65
+ 2. Grant of Copyright License. Subject to the terms and conditions of
66
+ this License, each Contributor hereby grants to You a perpetual,
67
+ worldwide, non-exclusive, no-charge, royalty-free, irrevocable
68
+ copyright license to reproduce, prepare Derivative Works of,
69
+ publicly display, publicly perform, sublicense, and distribute the
70
+ Work and such Derivative Works in Source or Object form.
71
+
72
+ 3. Grant of Patent License. Subject to the terms and conditions of
73
+ this License, each Contributor hereby grants to You a perpetual,
74
+ worldwide, non-exclusive, no-charge, royalty-free, irrevocable
75
+ (except as stated in this section) patent license to make, have made,
76
+ use, offer to sell, sell, import, and otherwise transfer the Work,
77
+ where such license applies only to those patent claims licensable
78
+ by such Contributor that are necessarily infringed by their
79
+ Contribution(s) alone or by combination of their Contribution(s)
80
+ with the Work to which such Contribution(s) was submitted. If You
81
+ institute patent litigation against any entity (including a
82
+ cross-claim or counterclaim in a lawsuit) alleging that the Work
83
+ or a Contribution incorporated within the Work constitutes direct
84
+ or contributory patent infringement, then any patent licenses
85
+ granted to You under this License for that Work shall terminate
86
+ as of the date such litigation is filed.
87
+
88
+ 4. Redistribution. You may reproduce and distribute copies of the
89
+ Work or Derivative Works thereof in any medium, with or without
90
+ modifications, and in Source or Object form, provided that You
91
+ meet the following conditions:
92
+
93
+ (a) You must give any other recipients of the Work or
94
+ Derivative Works a copy of this License; and
95
+
96
+ (b) You must cause any modified files to carry prominent notices
97
+ stating that You changed the files; and
98
+
99
+ (c) You must retain, in the Source form of any Derivative Works
100
+ that You distribute, all copyright, patent, trademark, and
101
+ attribution notices from the Source form of the Work,
102
+ excluding those notices that do not pertain to any part of
103
+ the Derivative Works; and
104
+
105
+ (d) If the Work includes a "NOTICE" text file as part of its
106
+ distribution, then any Derivative Works that You distribute must
107
+ include a readable copy of the attribution notices contained
108
+ within such NOTICE file, excluding those notices that do not
109
+ pertain to any part of the Derivative Works, in at least one
110
+ of the following places: within a NOTICE text file distributed
111
+ as part of the Derivative Works; within the Source form or
112
+ documentation, if provided along with the Derivative Works; or,
113
+ within a display generated by the Derivative Works, if and
114
+ wherever such third-party notices normally appear. The contents
115
+ of the NOTICE file are for informational purposes only and
116
+ do not modify the License. You may add Your own attribution
117
+ notices within Derivative Works that You distribute, alongside
118
+ or as an addendum to the NOTICE text from the Work, provided
119
+ that such additional attribution notices cannot be construed
120
+ as modifying the License.
121
+
122
+ You may add Your own copyright statement to Your modifications and
123
+ may provide additional or different license terms and conditions
124
+ for use, reproduction, or distribution of Your modifications, or
125
+ for any such Derivative Works as a whole, provided Your use,
126
+ reproduction, and distribution of the Work otherwise complies with
127
+ the conditions stated in this License.
128
+
129
+ 5. Submission of Contributions. Unless You explicitly state otherwise,
130
+ any Contribution intentionally submitted for inclusion in the Work
131
+ by You to the Licensor shall be under the terms and conditions of
132
+ this License, without any additional terms or conditions.
133
+ Notwithstanding the above, nothing herein shall supersede or modify
134
+ the terms of any separate license agreement you may have executed
135
+ with Licensor regarding such Contributions.
136
+
137
+ 6. Trademarks. This License does not grant permission to use the trade
138
+ names, trademarks, service marks, or product names of the Licensor,
139
+ except as required for reasonable and customary use in describing the
140
+ origin of the Work and reproducing the content of the NOTICE file.
141
+
142
+ 7. Disclaimer of Warranty. Unless required by applicable law or
143
+ agreed to in writing, Licensor provides the Work (and each
144
+ Contributor provides its Contributions) on an "AS IS" BASIS,
145
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
146
+ implied, including, without limitation, any warranties or conditions
147
+ of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
148
+ PARTICULAR PURPOSE. You are solely responsible for determining the
149
+ appropriateness of using or redistributing the Work and assume any
150
+ risks associated with Your exercise of permissions under this License.
151
+
152
+ 8. Limitation of Liability. In no event and under no legal theory,
153
+ whether in tort (including negligence), contract, or otherwise,
154
+ unless required by applicable law (such as deliberate and grossly
155
+ negligent acts) or agreed to in writing, shall any Contributor be
156
+ liable to You for damages, including any direct, indirect, special,
157
+ incidental, or consequential damages of any character arising as a
158
+ result of this License or out of the use or inability to use the
159
+ Work (including but not limited to damages for loss of goodwill,
160
+ work stoppage, computer failure or malfunction, or any and all
161
+ other commercial damages or losses), even if such Contributor
162
+ has been advised of the possibility of such damages.
163
+
164
+ 9. Accepting Warranty or Additional Liability. While redistributing
165
+ the Work or Derivative Works thereof, You may choose to offer,
166
+ and charge a fee for, acceptance of support, warranty, indemnity,
167
+ or other liability obligations and/or rights consistent with this
168
+ License. However, in accepting such obligations, You may act only
169
+ on Your own behalf and on Your sole responsibility, not on behalf
170
+ of any other Contributor, and only if You agree to indemnify,
171
+ defend, and hold each Contributor harmless for any liability
172
+ incurred by, or claims asserted against, such Contributor by reason
173
+ of your accepting any such warranty or additional liability.
174
+
175
+ END OF TERMS AND CONDITIONS
176
+
177
+ Copyright 2026 Julius (@Qewler)
178
+
179
+ Licensed under the Apache License, Version 2.0 (the "License");
180
+ you may not use this file except in compliance with the License.
181
+ You may obtain a copy of the License at
182
+
183
+ http://www.apache.org/licenses/LICENSE-2.0
184
+
185
+ Unless required by applicable law or agreed to in writing, software
186
+ distributed under the License is distributed on an "AS IS" BASIS,
187
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
188
+ See the License for the specific language governing permissions and
189
+ limitations under the License.
package/NOTICE ADDED
@@ -0,0 +1,9 @@
1
+ WingmanPM Product Designer
2
+ Copyright 2026 Julius (@Qewler)
3
+ https://github.com/Qewler
4
+
5
+ This project is an original synthesis. Its product-context discipline,
6
+ motion restraint, anti-template practice, and searchable-rule structure were
7
+ informed by Impeccable, Emil Kowalski's published design-engineering ideas,
8
+ Design Taste Frontend, and UI/UX Pro Max. No source skill scripts, datasets,
9
+ or substantial text are redistributed.
package/PRIVACY.md ADDED
@@ -0,0 +1,40 @@
1
+ # Privacy
2
+
3
+ Effective date: August 31, 2026
4
+
5
+ WingmanPM Product Designer is a local, skills-only plugin. The plugin itself
6
+ does not create an account, authenticate with a service, run an MCP server,
7
+ collect telemetry, or send data to its publisher.
8
+
9
+ ## What the plugin stores
10
+
11
+ The installer can store a local manifest in the project or user-selected
12
+ installation directory. The manifest records installed files, content hashes,
13
+ and whether the one-time maker notice was shown. This state supports safe
14
+ updates and removals. The manifest remains local until CLI uninstall removes
15
+ it or the user removes it by manual deletion. It is never sent to the publisher.
16
+
17
+ ## What the plugin can access
18
+
19
+ The skill can ask the host agent to inspect or change files and to run project
20
+ checks. Access remains subject to the host's permissions, the user's request,
21
+ and any approval controls in that host. The plugin does not bypass those
22
+ controls.
23
+
24
+ The host agent or a user-selected tool can send data to its own provider or to
25
+ other services. Those transfers are controlled by that provider or tool, not
26
+ by this plugin. Review their privacy terms before using network tools with
27
+ sensitive material.
28
+
29
+ ## Third-party services
30
+
31
+ GitHub, npm, model providers, and any links opened by the user can receive the
32
+ usual service data, such as IP addresses and request logs. Their policies apply
33
+ to those interactions. The plugin does not add tracking parameters or collect
34
+ click data.
35
+
36
+ ## Questions
37
+
38
+ For a general privacy question, open an issue at
39
+ <https://github.com/Qewler/wingmanpm-product-designer/issues>. For a sensitive
40
+ security or privacy report, use the private process in [SECURITY.md](SECURITY.md).
package/README.md ADDED
@@ -0,0 +1,161 @@
1
+ <p align="center">
2
+ <img src="assets/wordmark.svg" width="360" alt="WingmanPM Product Designer" />
3
+ </p>
4
+
5
+ <h1 align="center">Product design judgment for coding agents.</h1>
6
+
7
+ <p align="center">
8
+ A portable design partner that reads the product, chooses the right level of change,
9
+ ships the interface, and proves it in the browser.
10
+ </p>
11
+
12
+ <p align="center">
13
+ <a href="https://www.npmjs.com/package/wingmanpm-product-designer"><img alt="npm version" src="https://img.shields.io/npm/v/wingmanpm-product-designer?style=flat-square&color=256f4d" /></a>
14
+ <a href="https://github.com/Qewler/wingmanpm-product-designer/actions/workflows/ci.yml"><img alt="CI status" src="https://img.shields.io/github/actions/workflow/status/Qewler/wingmanpm-product-designer/ci.yml?branch=main&style=flat-square&label=quality" /></a>
15
+ <a href="https://agentskills.io/specification"><img alt="Agent Skills compatible" src="https://img.shields.io/badge/Agent%20Skills-compatible-256f4d?style=flat-square" /></a>
16
+ <a href="LICENSE"><img alt="Apache 2.0 license" src="https://img.shields.io/badge/license-Apache--2.0-172019?style=flat-square" /></a>
17
+ <img alt="Node 20 or newer" src="https://img.shields.io/badge/node-%3E%3D20-172019?style=flat-square" />
18
+ </p>
19
+
20
+ <p align="center"><strong>Codex&nbsp;&nbsp; Claude Code&nbsp;&nbsp; Cursor&nbsp;&nbsp; Agent Skills</strong></p>
21
+
22
+ ```bash
23
+ npx plugins add Qewler/wingmanpm-product-designer
24
+ ```
25
+
26
+ <picture>
27
+ <source media="(prefers-color-scheme: dark)" srcset="docs/assets/readme/hero-dark.webp">
28
+ <source media="(prefers-color-scheme: light)" srcset="docs/assets/readme/hero-light.webp">
29
+ <img src="docs/assets/readme/hero-light.webp" alt="WingmanPM Product Designer beside a refined renewable-energy operations workspace" width="1600">
30
+ </picture>
31
+
32
+ ## Proof, not promises
33
+
34
+ The showcase uses runnable React stories, the same copy and sample data on both sides, and deterministic Playwright captures. Every Tamarack Renewables surface is clearly marked **Concept demo**.
35
+
36
+ ### Operational workspace
37
+
38
+ A usable first pass becomes a calm operating surface with clearer hierarchy, real status meaning, compact navigation, and less card noise.
39
+
40
+ <img src="docs/assets/readme/comparison-workspace.webp" alt="Before and after comparison of the Tamarack FieldOps operational workspace" width="1600">
41
+
42
+ ### Transparent AI review
43
+
44
+ The same generated draft becomes reviewable. Sources, uncertainty, and the human approval boundary stay visible at the moment of action.
45
+
46
+ <img src="docs/assets/readme/comparison-ai-review.webp" alt="Before and after comparison of a source-aware AI review flow" width="1600">
47
+
48
+ ### SaaS marketing first view
49
+
50
+ The same promise, actions, and photograph move from a familiar split layout to a product-specific, atmospheric first view.
51
+
52
+ <img src="docs/assets/readme/comparison-marketing.webp" alt="Before and after comparison of the Tamarack Renewables marketing first view" width="1600">
53
+
54
+ > **From the maker of WingmanPM**
55
+ >
56
+ > You fly the product. We cover your six. WingmanPM is an AI copilot for product managers that turns the chaos of customer feedback into organized, ranked, actionable decisions.
57
+ >
58
+ > [Explore WingmanPM](https://wingman.pm)
59
+
60
+ ## One skill, several harnesses
61
+
62
+ Install through the interface your agent already understands.
63
+
64
+ | Target | Command |
65
+ | --- | --- |
66
+ | Agent Plugins | `npx plugins add Qewler/wingmanpm-product-designer` |
67
+ | Agent Skills | `npx skills add Qewler/wingmanpm-product-designer --skill wingmanpm-product-designer` |
68
+ | OpenAI Codex | `codex plugin add wingmanpm-product-designer@wingmanpm` |
69
+ | Claude Code | `claude plugin install wingmanpm-product-designer@wingmanpm` |
70
+ | npm / npx | `npx wingmanpm-product-designer@latest install --agent all` |
71
+
72
+ Native marketplace installs need a one-time catalog setup:
73
+
74
+ ```bash
75
+ codex plugin marketplace add Qewler/wingmanpm-product-designer
76
+ claude plugin marketplace add Qewler/wingmanpm-product-designer
77
+ ```
78
+
79
+ Then ask for the outcome, not a pile of style tokens:
80
+
81
+ ```text
82
+ # Codex
83
+ $wingmanpm-product-designer stunning onboarding
84
+
85
+ # Claude Code or Cursor
86
+ /wingmanpm-product-designer review billing settings
87
+
88
+ # Direct scope
89
+ $wingmanpm-product-designer elevate the pricing page --level elevate
90
+ ```
91
+
92
+ Plain requests work too. “Make this beautiful” starts with product inspection and one bounded choice. It does not silently turn a focused repair into a redesign.
93
+
94
+ Claude marketplace installs namespace the explicit command as
95
+ `/wingmanpm-product-designer:wingmanpm-product-designer`. A standalone Agent
96
+ Skills install keeps the shorter `/wingmanpm-product-designer` form.
97
+
98
+ ## Judgment before decoration
99
+
100
+ Most design prompts fail before the first pixel. They skip context, choose a fashionable default, and stop at one successful desktop state. This skill follows a stricter loop:
101
+
102
+ 1. **Inspect:** understand the product, stack, design system, information structure, and constraints.
103
+ 2. **Choose:** use **Refine**, **Elevate**, or **Reimagine** to set an honest change boundary.
104
+ 3. **Build:** implement product-owned components, useful motion, complete states, and explicit responsive behavior.
105
+ 4. **Prove:** run deterministic checks, Storybook, keyboard review, accessibility checks, and browser evidence.
106
+
107
+ It covers product UI, marketing surfaces, design-system work, AI interactions, forms, navigation, account patterns, and operational tables. Existing capable components stay in place. Project truth wins over a generic aesthetic.
108
+
109
+ ## Built for real product work
110
+
111
+ - **Existing products stay recognizable.** The skill reads routes, permissions, copy, data meaning, tokens, and shared components before it changes the surface.
112
+ - **New work gets a clear contract.** Product facts, visual direction, components, responsive rules, states, and proof live together instead of drifting across prompts.
113
+ - **Dense tools stay fast.** Tables, filters, bulk actions, inline edits, preferences, and keyboard paths are treated as workflows, not decorative grids.
114
+ - **AI stays under human control.** Drafts show scope, sources, uncertainty, progress, recovery, and the exact approval boundary before a consequential action.
115
+ - **Reviews stay honest.** `review` and `audit` are read-only unless a fix is requested. Findings separate measured defects from taste and name the proof still needed.
116
+ - **Handoffs are reproducible.** Managed files have hashes, user-owned files stay protected, browser evidence expires when sources change, and install state can be removed safely.
117
+
118
+ ## The quality bar is executable
119
+
120
+ `npx wingmanpm-product-designer@latest check` blocks missing contracts and stale evidence. It checks token use, semantics, keyboard paths, loading and error states, responsive behavior, dark mode, reduced motion, AI approval boundaries, table behavior, and visual review freshness.
121
+
122
+ The checker does not pretend that a regular expression can measure beauty. Machine checks prove the contract. Browser evidence and human review prove the result.
123
+
124
+ ```bash
125
+ npx wingmanpm-product-designer@latest init --project /path/to/project
126
+ npx wingmanpm-product-designer@latest check --project /path/to/project
127
+ npx wingmanpm-product-designer@latest doctor --project /path/to/project
128
+ ```
129
+
130
+ Generated files are recorded in `.wingmanpm-design/manifest.json`. Upgrades refresh unchanged managed files and preserve project-owned work. Uninstall removes only unchanged managed files. `--dry-run` shows the plan before a write.
131
+
132
+ ## Responsive by construction
133
+
134
+ <img src="docs/assets/readme/responsive-proof.webp" alt="The same Tamarack FieldOps story shown at desktop, tablet, and mobile widths" width="1600">
135
+
136
+ The golden React path includes Storybook and Playwright proof. Other stacks receive the same design contract and portable references without pretending to be React.
137
+
138
+ ## Trust is part of the design
139
+
140
+ - Apache-2.0 licensed, with no MCP server, account, secret, or plugin telemetry.
141
+ - The portable skill and OpenAI review archive contain no maker promotion.
142
+ - Normal agent output stays focused on the user's product. It does not inject WingmanPM mentions.
143
+ - The public maker story uses only public copy and assets. It includes no production data, private route, pricing, checkout, or sign-in.
144
+ - The showcase is repository proof and is excluded from the runtime package.
145
+
146
+ ## Reproduce the visuals
147
+
148
+ Every image above comes from [`showcase/`](showcase/), not a painted screenshot.
149
+
150
+ ```bash
151
+ npm --prefix showcase ci
152
+ npm --prefix showcase run build
153
+ npm --prefix showcase run capture
154
+ npm --prefix showcase run check
155
+ ```
156
+
157
+ Read the [compatibility report](docs/compatibility.md), [publication record](docs/publication-record.md), [release notes](CHANGELOG.md), [security policy](SECURITY.md), or [support guide](SUPPORT.md). For all commands, run `npx wingmanpm-product-designer@latest --help`.
158
+
159
+ <p align="center">
160
+ Built by <a href="https://github.com/Qewler">Julius / Qewler</a>. Released under <a href="LICENSE">Apache-2.0</a>.
161
+ </p>
package/SECURITY.md ADDED
@@ -0,0 +1,39 @@
1
+ # Security Policy
2
+
3
+ ## Supported versions
4
+
5
+ Security fixes are provided for the latest `1.x` release.
6
+
7
+ | Version | Supported |
8
+ | --- | --- |
9
+ | Latest `1.x` | Yes |
10
+ | Older releases | No |
11
+
12
+ ## Report a vulnerability
13
+
14
+ Use GitHub's private vulnerability reporting form:
15
+
16
+ <https://github.com/Qewler/wingmanpm-product-designer/security/advisories/new>
17
+
18
+ Do not open a public issue for an undisclosed vulnerability. Include the
19
+ affected version, impact, reproduction steps, and any suggested fix. Remove
20
+ unrelated secrets and personal data. Reports are reviewed on a best-effort
21
+ basis; no response-time guarantee is made.
22
+
23
+ ## Security model
24
+
25
+ The public plugin is skills-only. It has no MCP server, account system,
26
+ authentication flow, telemetry, remote code loader, or install-time lifecycle
27
+ script. Host permissions and user approvals remain the security boundary for
28
+ file access, shell commands, browser use, and network tools.
29
+
30
+ The command-line installer records content hashes and avoids replacing or
31
+ removing locally changed files. Users should still review package contents,
32
+ agent actions, generated changes, and dependency updates before use in a
33
+ sensitive environment.
34
+
35
+ ## Disclosure
36
+
37
+ Please allow a reasonable period to investigate and prepare a fix before
38
+ public disclosure. Credit is welcome but optional; state your preference in
39
+ the report.
package/SUPPORT.md ADDED
@@ -0,0 +1,27 @@
1
+ # Support
2
+
3
+ WingmanPM Product Designer is community-supported open-source software.
4
+
5
+ ## Get help
6
+
7
+ - Read the [README](README.md) for installation and first use.
8
+ - Search existing [issues](https://github.com/Qewler/wingmanpm-product-designer/issues).
9
+ - Open a new issue for a reproducible bug, compatibility problem, or
10
+ documentation gap.
11
+ - Follow [SECURITY.md](SECURITY.md) for a vulnerability. Do not post sensitive
12
+ details in a public issue.
13
+
14
+ ## Include with a report
15
+
16
+ Provide the plugin version, host and host version, Node.js version, operating
17
+ system, exact command or prompt, expected result, actual result, and the
18
+ smallest safe reproduction. Remove secrets, customer data, and private source
19
+ before attaching logs or files.
20
+
21
+ ## Supported environments
22
+
23
+ Version 1.0.0 targets current Codex, Claude Code, and Cursor releases, plus
24
+ standards-compatible Agent Skills and Agent Plugins hosts. The command-line
25
+ installer supports Node.js 20, 22, and 24 on macOS, Linux, and Windows.
26
+
27
+ Support is best effort. A response time or fix date is not guaranteed.