create-yss-spec 1.1.1 → 1.1.3
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.
- package/package.json +1 -1
- package/template/.agents/skills/high-fidelity-html-prototype/SKILL.md +102 -0
- package/template/.codex/skills/data-analytics/.app.json +84 -0
- package/template/.codex/skills/data-analytics/.codex-plugin/plugin.json +66 -0
- package/template/.codex/skills/data-analytics/.mcp.json +30 -0
- package/template/.codex/skills/data-analytics/AGENTS.md +20 -0
- package/template/.codex/skills/data-analytics/DEPENDENCIES.MD +27 -0
- package/template/.codex/skills/data-analytics/README.md +60 -0
- package/template/.codex/skills/data-analytics/assets/datascience-artifact-widget.html +16 -0
- package/template/.codex/skills/data-analytics/assets/datascience-artifact-widget.html.gz.b64.part001 +1 -0
- package/template/.codex/skills/data-analytics/assets/datascience-artifact-widget.html.gz.b64.part002 +1 -0
- package/template/.codex/skills/data-analytics/assets/datascience-artifact-widget.html.gz.b64.part003 +1 -0
- package/template/.codex/skills/data-analytics/assets/datascience-artifact-widget.html.gz.b64.part004 +1 -0
- package/template/.codex/skills/data-analytics/assets/datascience-artifact-widget.html.gz.b64.part005 +1 -0
- package/template/.codex/skills/data-analytics/assets/datascience-artifact-widget.html.gz.b64.part006 +1 -0
- package/template/.codex/skills/data-analytics/assets/datascience-chart-widget.html +16 -0
- package/template/.codex/skills/data-analytics/assets/datascience-chart-widget.html.gz.b64.part001 +1 -0
- package/template/.codex/skills/data-analytics/assets/datascience-chart-widget.html.gz.b64.part002 +1 -0
- package/template/.codex/skills/data-analytics/assets/datascience-chart-widget.html.gz.b64.part003 +1 -0
- package/template/.codex/skills/data-analytics/assets/datascience-chart-widget.html.gz.b64.part004 +1 -0
- package/template/.codex/skills/data-analytics/assets/datascience-chart-widget.html.gz.b64.part005 +1 -0
- package/template/.codex/skills/data-analytics/assets/datascience-chart-widget.html.gz.b64.part006 +1 -0
- package/template/.codex/skills/data-analytics/assets/datascience-chart-widget.html.gz.b64.part007 +1 -0
- package/template/.codex/skills/data-analytics/assets/datascience-small.svg +5 -0
- package/template/.codex/skills/data-analytics/assets/datascience-table-widget.html +16 -0
- package/template/.codex/skills/data-analytics/assets/datascience-table-widget.html.gz.b64.part001 +1 -0
- package/template/.codex/skills/data-analytics/assets/datascience-table-widget.html.gz.b64.part002 +1 -0
- package/template/.codex/skills/data-analytics/assets/datascience-table-widget.html.gz.b64.part003 +1 -0
- package/template/.codex/skills/data-analytics/assets/datascience-table-widget.html.gz.b64.part004 +1 -0
- package/template/.codex/skills/data-analytics/assets/datascience.png +0 -0
- package/template/.codex/skills/data-analytics/assets/datascience.svg +10 -0
- package/template/.codex/skills/data-analytics/mcp/server.cjs +2963 -0
- package/template/.codex/skills/data-analytics/package-lock.json +3048 -0
- package/template/.codex/skills/data-analytics/package.json +43 -0
- package/template/.codex/skills/data-analytics/scripts/normalize-widget-assets.mjs +75 -0
- package/template/.codex/skills/data-analytics/skills/analyze-data-quality/SKILL.md +160 -0
- package/template/.codex/skills/data-analytics/skills/analyze-data-quality/agents/openai.yaml +6 -0
- package/template/.codex/skills/data-analytics/skills/build-dashboard/SKILL.md +148 -0
- package/template/.codex/skills/data-analytics/skills/build-dashboard/agents/openai.yaml +6 -0
- package/template/.codex/skills/data-analytics/skills/build-dashboard/specifications/bi-platform-dashboard.md +18 -0
- package/template/.codex/skills/data-analytics/skills/build-dashboard/specifications/html-dashboard.md +24 -0
- package/template/.codex/skills/data-analytics/skills/build-dashboard/specifications/mcp-artifact-dashboard.md +71 -0
- package/template/.codex/skills/data-analytics/skills/build-dashboard/specifications/streamlit-dashboard.md +85 -0
- package/template/.codex/skills/data-analytics/skills/build-report/SKILL.md +207 -0
- package/template/.codex/skills/data-analytics/skills/build-report/agents/openai.yaml +6 -0
- package/template/.codex/skills/data-analytics/skills/build-report/assets/executive-report-shell.html +70 -0
- package/template/.codex/skills/data-analytics/skills/build-report/assets/technical-report-shell.html +66 -0
- package/template/.codex/skills/data-analytics/skills/build-report/report-to-google-doc/SKILL.md +118 -0
- package/template/.codex/skills/data-analytics/skills/build-report/report-to-google-doc/agents/openai.yaml +6 -0
- package/template/.codex/skills/data-analytics/skills/build-report/report-to-google-doc/scripts/report_to_google_doc/__init__.py +1 -0
- package/template/.codex/skills/data-analytics/skills/build-report/report-to-google-doc/scripts/report_to_google_doc/cli.py +57 -0
- package/template/.codex/skills/data-analytics/skills/build-report/report-to-google-doc/scripts/report_to_google_doc/constants.py +61 -0
- package/template/.codex/skills/data-analytics/skills/build-report/report-to-google-doc/scripts/report_to_google_doc/docx_writer.py +362 -0
- package/template/.codex/skills/data-analytics/skills/build-report/report-to-google-doc/scripts/report_to_google_doc/html_parser.py +829 -0
- package/template/.codex/skills/data-analytics/skills/build-report/report-to-google-doc/scripts/report_to_google_doc/model.py +30 -0
- package/template/.codex/skills/data-analytics/skills/build-report/report-to-google-doc/scripts/report_to_google_doc/plan.py +129 -0
- package/template/.codex/skills/data-analytics/skills/build-report/report-to-google-doc/scripts/report_to_google_doc/quality.py +374 -0
- package/template/.codex/skills/data-analytics/skills/build-report/report-to-google-doc/scripts/report_to_google_doc/rendering.py +613 -0
- package/template/.codex/skills/data-analytics/skills/build-report/report-to-google-doc/scripts/report_to_google_doc/table_utils.py +54 -0
- package/template/.codex/skills/data-analytics/skills/build-report/report-to-google-doc/scripts/report_to_google_doc/utils.py +16 -0
- package/template/.codex/skills/data-analytics/skills/build-report/report-to-google-doc/scripts/report_to_google_doc_plan.py +9 -0
- package/template/.codex/skills/data-analytics/skills/build-report/report-to-google-slides/SKILL.md +78 -0
- package/template/.codex/skills/data-analytics/skills/build-report/report-to-google-slides/agents/openai.yaml +6 -0
- package/template/.codex/skills/data-analytics/skills/build-report/report-to-google-slides/scripts/report_to_google_slides.py +2379 -0
- package/template/.codex/skills/data-analytics/skills/build-report/report-to-pdf/SKILL.md +88 -0
- package/template/.codex/skills/data-analytics/skills/build-report/report-to-pdf/agents/openai.yaml +6 -0
- package/template/.codex/skills/data-analytics/skills/build-report/specifications/executive-report.md +97 -0
- package/template/.codex/skills/data-analytics/skills/build-report/specifications/mcp-app-report.md +59 -0
- package/template/.codex/skills/data-analytics/skills/build-report/specifications/technical-report.md +75 -0
- package/template/.codex/skills/data-analytics/skills/design-kpis/SKILL.md +103 -0
- package/template/.codex/skills/data-analytics/skills/design-kpis/agents/openai.yaml +6 -0
- package/template/.codex/skills/data-analytics/skills/gather-business-context/SKILL.md +68 -0
- package/template/.codex/skills/data-analytics/skills/gather-business-context/agents/openai.yaml +6 -0
- package/template/.codex/skills/data-analytics/skills/index/SKILL.md +251 -0
- package/template/.codex/skills/data-analytics/skills/index/agents/openai.yaml +6 -0
- package/template/.codex/skills/data-analytics/skills/jupyter-notebooks/SKILL.md +131 -0
- package/template/.codex/skills/data-analytics/skills/jupyter-notebooks/agents/openai.yaml +6 -0
- package/template/.codex/skills/data-analytics/skills/kpi-reporting/SKILL.md +141 -0
- package/template/.codex/skills/data-analytics/skills/kpi-reporting/agents/openai.yaml +6 -0
- package/template/.codex/skills/data-analytics/skills/kpi-reporting/references/report-templates.md +32 -0
- package/template/.codex/skills/data-analytics/skills/market-sizing/SKILL.md +106 -0
- package/template/.codex/skills/data-analytics/skills/market-sizing/agents/openai.yaml +6 -0
- package/template/.codex/skills/data-analytics/skills/metric-diagnostics/SKILL.md +130 -0
- package/template/.codex/skills/data-analytics/skills/metric-diagnostics/agents/openai.yaml +6 -0
- package/template/.codex/skills/data-analytics/skills/product-business-analysis/SKILL.md +141 -0
- package/template/.codex/skills/data-analytics/skills/product-business-analysis/agents/openai.yaml +6 -0
- package/template/.codex/skills/data-analytics/skills/spreadsheets/SKILL.md +178 -0
- package/template/.codex/skills/data-analytics/skills/spreadsheets/agents/openai.yaml +9 -0
- package/template/.codex/skills/data-analytics/skills/spreadsheets/assets/file-spreadsheet.png +0 -0
- package/template/.codex/skills/data-analytics/skills/spreadsheets/charts.md +31 -0
- package/template/.codex/skills/data-analytics/skills/spreadsheets/references/artifact_tool_api.md +466 -0
- package/template/.codex/skills/data-analytics/skills/spreadsheets/style_guidelines.md +99 -0
- package/template/.codex/skills/data-analytics/skills/user-context/SKILL.md +195 -0
- package/template/.codex/skills/data-analytics/skills/user-context/agents/openai.yaml +6 -0
- package/template/.codex/skills/data-analytics/skills/user-context/plugin-author-config/automation-config.md +26 -0
- package/template/.codex/skills/data-analytics/skills/user-context/plugin-author-config/source-category-config.json +51 -0
- package/template/.codex/skills/data-analytics/skills/user-context/plugin-author-config/user-context-config.md +66 -0
- package/template/.codex/skills/data-analytics/skills/user-context/references/automation.md +69 -0
- package/template/.codex/skills/data-analytics/skills/user-context/references/onboarding-examples.md +204 -0
- package/template/.codex/skills/data-analytics/skills/user-context/references/onboarding-state-template.json +87 -0
- package/template/.codex/skills/data-analytics/skills/user-context/references/onboarding.md +497 -0
- package/template/.codex/skills/data-analytics/skills/user-context/references/semantic-layer/connector-playbook.md +74 -0
- package/template/.codex/skills/data-analytics/skills/user-context/references/semantic-layer/setup.md +65 -0
- package/template/.codex/skills/data-analytics/skills/user-context/references/semantic-layer/skill-template.md +160 -0
- package/template/.codex/skills/data-analytics/skills/user-context/references/semantic-layer/source-intake.md +75 -0
- package/template/.codex/skills/data-analytics/skills/user-context/references/semantic-layer/weekly-polling-automation.md +96 -0
- package/template/.codex/skills/data-analytics/skills/user-context/references/source-category-runtime.md +263 -0
- package/template/.codex/skills/data-analytics/skills/user-context/scripts/data_analytics_preflight.py +1460 -0
- package/template/.codex/skills/data-analytics/skills/user-context/scripts/init_user_context_state.py +128 -0
- package/template/.codex/skills/data-analytics/skills/user-context/scripts/reset_user_context_state.py +101 -0
- package/template/.codex/skills/data-analytics/skills/user-context/scripts/validate_user_context_preflight.py +499 -0
- package/template/.codex/skills/data-analytics/skills/user-context/tests/test_state_helpers.py +978 -0
- package/template/.codex/skills/data-analytics/skills/validate-data/SKILL.md +190 -0
- package/template/.codex/skills/data-analytics/skills/validate-data/agents/openai.yaml +6 -0
- package/template/.codex/skills/data-analytics/skills/visualize-data/SKILL.md +157 -0
- package/template/.codex/skills/data-analytics/skills/visualize-data/agents/openai.yaml +6 -0
- package/template/.codex/skills/data-analytics/skills/visualize-data/references/seaborn-templates.md +774 -0
- package/template/.codex/skills/data-analytics/src/DESIGN.md +222 -0
- package/template/.codex/skills/data-analytics/src/analytics-app/App.tsx +3666 -0
- package/template/.codex/skills/data-analytics/src/analytics-app/analytics-layout.test.mjs +136 -0
- package/template/.codex/skills/data-analytics/src/analytics-app/charting/ChartFrame.tsx +54 -0
- package/template/.codex/skills/data-analytics/src/analytics-app/charting/ChartLegend.tsx +96 -0
- package/template/.codex/skills/data-analytics/src/analytics-app/charting/ChartRenderer.tsx +1647 -0
- package/template/.codex/skills/data-analytics/src/analytics-app/charting/ChartTooltip.tsx +245 -0
- package/template/.codex/skills/data-analytics/src/analytics-app/charting/chart-app-helpers.tsx +462 -0
- package/template/.codex/skills/data-analytics/src/analytics-app/charting/chart-capabilities.ts +107 -0
- package/template/.codex/skills/data-analytics/src/analytics-app/charting/chart-compatibility.ts +164 -0
- package/template/.codex/skills/data-analytics/src/analytics-app/charting/chart-contract.ts +192 -0
- package/template/.codex/skills/data-analytics/src/analytics-app/charting/chart-theme.ts +203 -0
- package/template/.codex/skills/data-analytics/src/analytics-app/charting/chart-tokens.css +619 -0
- package/template/.codex/skills/data-analytics/src/analytics-app/charting/chart-transforms.ts +402 -0
- package/template/.codex/skills/data-analytics/src/analytics-app/fonts/SystemSansVariableVF.woff2 +0 -0
- package/template/.codex/skills/data-analytics/src/analytics-app/imageExport.ts +370 -0
- package/template/.codex/skills/data-analytics/src/analytics-app/layout/AnalyticsLayoutCanvas.tsx +536 -0
- package/template/.codex/skills/data-analytics/src/analytics-app/layout/RichMarkdown.tsx +681 -0
- package/template/.codex/skills/data-analytics/src/analytics-app/layout/analyticsLayoutCore.ts +164 -0
- package/template/.codex/skills/data-analytics/src/analytics-app/main.tsx +21 -0
- package/template/.codex/skills/data-analytics/src/analytics-app/scripts/chart_contract.py +472 -0
- package/template/.codex/skills/data-analytics/src/analytics-app/scripts/check_analytics_app_runtime_links.py +75 -0
- package/template/.codex/skills/data-analytics/src/analytics-app/scripts/design_contract.py +142 -0
- package/template/.codex/skills/data-analytics/src/analytics-app/scripts/package_utils.py +142 -0
- package/template/.codex/skills/data-analytics/src/analytics-app/scripts/tests/test_package_utils.py +377 -0
- package/template/.codex/skills/data-analytics/src/analytics-app/styles.css +3468 -0
- package/template/.codex/skills/data-analytics/src/analytics-app/tables/DataTable.d.ts +44 -0
- package/template/.codex/skills/data-analytics/src/analytics-app/tables/DataTable.jsx +639 -0
- package/template/.codex/skills/data-analytics/src/analytics-app/tables/data-table.css +327 -0
- package/template/.codex/skills/data-analytics/src/analytics-app/tokens.css +225 -0
- package/template/.codex/skills/data-analytics/src/analytics-app/types.ts +204 -0
- package/template/.codex/skills/data-analytics/src/analytics-app-core.md +85 -0
- package/template/.codex/skills/data-analytics/src/codex-style-contract.md +30 -0
- package/template/.codex/skills/data-analytics/src/datascience-artifact-widget.html +12 -0
- package/template/.codex/skills/data-analytics/src/datascience-artifact-widget.jsx +1008 -0
- package/template/.codex/skills/data-analytics/src/datascience-chart-widget.css +2117 -0
- package/template/.codex/skills/data-analytics/src/datascience-chart-widget.html +122 -0
- package/template/.codex/skills/data-analytics/src/datascience-chart-widget.js +3588 -0
- package/template/.codex/skills/data-analytics/src/datascience-table-widget.css +483 -0
- package/template/.codex/skills/data-analytics/src/datascience-table-widget.html +32 -0
- package/template/.codex/skills/data-analytics/src/datascience-table-widget.js +333 -0
- package/template/.codex/skills/data-analytics/src/mcp-host.js +153 -0
- package/template/.codex/skills/data-analytics/src/recharts-config.js +315 -0
- package/template/.codex/skills/data-analytics/src/recharts-renderer.jsx +294 -0
- package/template/.codex/skills/data-analytics/src/sql-source-view.css +33 -0
- package/template/.codex/skills/data-analytics/src/sql-source-view.js +157 -0
- package/template/.codex/skills/data-analytics/src/styles/codex-theme.css +121 -0
- package/template/.codex/skills/data-analytics/src/table-renderer.jsx +28 -0
- package/template/.codex/skills/data-analytics/tests/chart-transforms.test.mjs +87 -0
- package/template/.codex/skills/data-analytics/tests/funnel-smoke.html +105 -0
- package/template/.codex/skills/data-analytics/tests/inline-widget-compare.html +233 -0
- package/template/.codex/skills/data-analytics/tests/mcp-server.test.mjs +1500 -0
- package/template/.codex/skills/data-analytics/tests/native-style-contract.test.mjs +219 -0
- package/template/.codex/skills/data-analytics/tests/recharts-config.test.mjs +144 -0
- package/template/.codex/skills/data-analytics/tests/recharts-renderer.test.mjs +11 -0
- package/template/.codex/skills/data-analytics/tests/rich-markdown.test.mjs +54 -0
- package/template/.codex/skills/data-analytics/tests/widget-render-harness.html +321 -0
- package/template/.codex/skills/data-analytics/tsconfig.json +19 -0
- package/template/.codex/skills/data-analytics/vite.config.ts +46 -0
- package/template/.codex/skills/high-fidelity-html-prototype/SKILL.md +102 -0
- package/template/.codex/skills/high-fidelity-html-prototype/agents/openai.yaml +5 -0
- package/template/.codex/skills/product-design/.app.json +7 -0
- package/template/.codex/skills/product-design/.codex-plugin/plugin.json +50 -0
- package/template/.codex/skills/product-design/README.md +50 -0
- package/template/.codex/skills/product-design/agents/openai.yaml +4 -0
- package/template/.codex/skills/product-design/assets/composerIcon.svg +9 -0
- package/template/.codex/skills/product-design/assets/logo.png +0 -0
- package/template/.codex/skills/product-design/package.json +11 -0
- package/template/.codex/skills/product-design/references/browser-order.md +9 -0
- package/template/.codex/skills/product-design/references/communication-protocol.md +45 -0
- package/template/.codex/skills/product-design/references/critical-overrides.md +58 -0
- package/template/.codex/skills/product-design/references/local-prototype-preflight.md +16 -0
- package/template/.codex/skills/product-design/scripts/bootstrap-prototype.mjs +147 -0
- package/template/.codex/skills/product-design/skills/audit/SKILL.md +159 -0
- package/template/.codex/skills/product-design/skills/audit/agents/openai.yaml +6 -0
- package/template/.codex/skills/product-design/skills/audit/references/design-audit-framework.md +73 -0
- package/template/.codex/skills/product-design/skills/design-qa/SKILL.md +133 -0
- package/template/.codex/skills/product-design/skills/design-qa/agents/openai.yaml +6 -0
- package/template/.codex/skills/product-design/skills/design-qa/references/qa-rubric.md +61 -0
- package/template/.codex/skills/product-design/skills/get-context/SKILL.md +81 -0
- package/template/.codex/skills/product-design/skills/get-context/agents/openai.yaml +6 -0
- package/template/.codex/skills/product-design/skills/ideate/SKILL.md +179 -0
- package/template/.codex/skills/product-design/skills/ideate/agents/openai.yaml +6 -0
- package/template/.codex/skills/product-design/skills/image-to-code/SKILL.md +105 -0
- package/template/.codex/skills/product-design/skills/image-to-code/agents/openai.yaml +6 -0
- package/template/.codex/skills/product-design/skills/index/SKILL.md +126 -0
- package/template/.codex/skills/product-design/skills/index/agents/openai.yaml +6 -0
- package/template/.codex/skills/product-design/skills/prototype/SKILL.md +128 -0
- package/template/.codex/skills/product-design/skills/prototype/agents/openai.yaml +6 -0
- package/template/.codex/skills/product-design/skills/prototype/references/existing-codebase-edits.md +18 -0
- package/template/.codex/skills/product-design/skills/research/SKILL.md +92 -0
- package/template/.codex/skills/product-design/skills/research/agents/openai.yaml +6 -0
- package/template/.codex/skills/product-design/skills/share/SKILL.md +41 -0
- package/template/.codex/skills/product-design/skills/share/agents/openai.yaml +6 -0
- package/template/.codex/skills/product-design/skills/url-to-code/SKILL.md +124 -0
- package/template/.codex/skills/product-design/skills/url-to-code/agents/openai.yaml +6 -0
- package/template/.codex/skills/product-design/skills/user-context/SKILL.md +147 -0
- package/template/.codex/skills/product-design/skills/user-context/agents/openai.yaml +6 -0
- package/template/.codex/skills/product-design/skills/user-context/plugin-author-config/user-context-template.md +63 -0
- package/template/.codex/skills/product-design/skills/user-context/references/onboarding.md +66 -0
- package/template/.codex/skills/product-design/skills/user-context/scripts/init_user_context.py +86 -0
- package/template/.codex/skills/product-design/skills/user-context/scripts/user_context_preflight.py +204 -0
- package/template/.codex/skills/product-design/templates/prototype/AGENTS.md +7 -0
- package/template/.codex/skills/product-design/templates/prototype/index.html +12 -0
- package/template/.codex/skills/product-design/templates/prototype/package.json +18 -0
- package/template/.codex/skills/product-design/templates/prototype/src/App.jsx +5 -0
- package/template/.codex/skills/product-design/templates/prototype/src/main.jsx +10 -0
- package/template/.codex/skills/product-design/templates/prototype/src/styles.css +13 -0
- package/template/.codex/skills/product-design/templates/prototype/vite.config.mjs +14 -0
- package/template/.codex/skills/product-design-prototype/SKILL.md +2 -4
- package/template/.codex/skills/prototype-review/SKILL.md +7 -7
- package/template/.codex/skills/yss-design-system/SKILL.md +4 -2
- package/template/.codex/skills/yss-product-lifecycle/SKILL.md +10 -7
- package/template/.codex/skills/yss-product-lifecycle/references/artifact-checklist.md +1 -0
- package/template/.codex/skills/yss-product-lifecycle/references/stage-routing.md +1 -1
- package/template/.codex/skills/yss-ui/SKILL.md +4 -10
- package/template/.codex/skills/yss-ui/references/quick-recipes.md +1 -1
- package/template/AGENTS.md +9 -3
- package/template/CONTEXT.md +1 -0
- package/template/docs/adr/adr-product-design-prototype-entrypoint.md +54 -0
- package/template/docs/api/templates/openapi-draft-review-checklist.md +5 -1
- package/template/docs/design/README.md +13 -6
- package/template/docs/design/prototypes/.gitkeep +1 -0
- package/template/docs/design/templates/interaction-spec-template.md +8 -3
- package/template/docs/design/templates/product-overview-design-template.md +34 -5
- package/template/docs/design/templates/prototype-confirmation-template.md +57 -0
- package/template/docs/design/templates/prototype-review-checklist.md +7 -3
- package/template/docs/design/templates/state-matrix-template.md +1 -1
- package/template/docs/process/harness-executive-blueprint.md +6 -1
- package/template/docs/process/harness-process-tailoring.md +3 -3
- package/template/docs/process/harness-work-unit-map.md +1 -1
- package/template/docs/process/lifecycle-artifact-map.md +7 -5
- package/template/docs/process/product-prototype-workflow.md +82 -0
- package/template/docs/templates/requirement-freeze-template.md +4 -3
- package/template/docs/user-guide/product-lifecycle-workflow.md +2 -2
- package/template/docs/user-guide/product-rd-lifecycle-best-practices.md +54 -24
- package/template/.codex/skills/component-story-prototype/SKILL.md +0 -55
- package/template/.codex/skills/component-story-prototype/agents/openai.yaml +0 -4
- package/template/.codex/skills/mock-api-prototype/SKILL.md +0 -48
- package/template/.codex/skills/mock-api-prototype/agents/openai.yaml +0 -4
|
@@ -0,0 +1,128 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: prototype
|
|
3
|
+
description: "Route coded prototype requests after Product Design get-context has confirmed the design brief. Use for building prototypes from URLs, images, mockups, Figma, existing code, or ideas that need visual exploration before build."
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Design Prototypes
|
|
7
|
+
|
|
8
|
+
You're tasked with creating a frontend-only, interactive website or app, that the user can click through and use.
|
|
9
|
+
|
|
10
|
+
Select the best workflow from the following options to solve the user's request
|
|
11
|
+
|
|
12
|
+
## Golden Rule of Prototyping
|
|
13
|
+
|
|
14
|
+
- Do not build until you have a visual target and the chosen workflow reaches `$image-to-code` or `$url-to-code`.
|
|
15
|
+
- A visual target is an app or website design to build from: a user-provided image, a source URL, or an ImageGen design selected by the user.
|
|
16
|
+
- A `$get-context` brief is not a visual target.
|
|
17
|
+
- After `$get-context`, route to `$ideate` unless the user already provided a concrete visual source.
|
|
18
|
+
- If `$ideate` creates options, stop and wait for the user to choose one.
|
|
19
|
+
- The chosen option becomes the required visual target for `$image-to-code`.
|
|
20
|
+
|
|
21
|
+
## Critical Overrides
|
|
22
|
+
|
|
23
|
+
- Refer to the Plugin router [$index](../index/SKILL.md) before proceeding.
|
|
24
|
+
- Follow [$critical-overrides](../../references/critical-overrides.md).
|
|
25
|
+
- Refer to [references/existing-codebase-edits.md](references/existing-codebase-edits.md) for best practices on making edits to existing codebases.
|
|
26
|
+
|
|
27
|
+
## User Context
|
|
28
|
+
|
|
29
|
+
Before starting, load [$user-context](../user-context/SKILL.md) and run its preflight script when local shell access is available.
|
|
30
|
+
|
|
31
|
+
Use saved product URLs, Figma files, screenshots, reference images, codebase paths, Storybook, tokens, design systems, brand assets, component refs, browser preferences, and share targets as grounding material when relevant.
|
|
32
|
+
|
|
33
|
+
Do not inspect every saved reference. Inspect only what the current task needs.
|
|
34
|
+
|
|
35
|
+
## Setup Is Not Prototype Work
|
|
36
|
+
|
|
37
|
+
If the user only asks to set up Product Design, do not continue in this skill. Use [$user-context](../user-context/SKILL.md).
|
|
38
|
+
|
|
39
|
+
## Workflows
|
|
40
|
+
|
|
41
|
+
The following workflows support cloning, redesigning, extending, and building products from scratch. Choose the workflow that best matches the user's request, or use the skills as helpers if the request does not match one workflow cleanly.
|
|
42
|
+
|
|
43
|
+
Always start with `$get-context` to confirm the design brief before proceeding to the next workflow step. If required details are missing, `$get-context` asks for them. If the user already supplied the product, visual, and interactivity details, `$get-context` plays back the brief in your own words. Do not proceed to `$ideate`, `$url-to-code`, or `$image-to-code` until the brief has been played back and either confirmed by the user or already confirmed earlier in the thread.
|
|
44
|
+
|
|
45
|
+
### Clone product
|
|
46
|
+
|
|
47
|
+
"Recreate {URL}"
|
|
48
|
+
|
|
49
|
+
Required next steps:
|
|
50
|
+
|
|
51
|
+
- `$get-context` - confirm the design brief, including the target URL, purpose, source constraints, and interactivity level.
|
|
52
|
+
- `$url-to-code` - recreate the app or website shown at the URL.
|
|
53
|
+
|
|
54
|
+
"Recreate {image}"
|
|
55
|
+
|
|
56
|
+
Required next steps:
|
|
57
|
+
|
|
58
|
+
- `$get-context` - confirm the design brief, including what the image represents, source constraints, and interactivity level.
|
|
59
|
+
- `$image-to-code` - recreate the app or website design shown in the image.
|
|
60
|
+
|
|
61
|
+
### New product
|
|
62
|
+
|
|
63
|
+
"Build me {idea}"
|
|
64
|
+
|
|
65
|
+
Required next steps:
|
|
66
|
+
|
|
67
|
+
- `$get-context` - confirm the design brief, including the product idea, user goal, visual direction, source constraints, and interactivity level.
|
|
68
|
+
- `$ideate` - generate exactly three app or website design options; show them and wait for selection.
|
|
69
|
+
- `$image-to-code` - only after the user selects an option.
|
|
70
|
+
|
|
71
|
+
### Redesign product
|
|
72
|
+
|
|
73
|
+
"Redesign this {image}"
|
|
74
|
+
|
|
75
|
+
Required next steps:
|
|
76
|
+
|
|
77
|
+
- `$get-context` - confirm the design brief, including the redesign goal, visual direction, source constraints, and interactivity level.
|
|
78
|
+
- `$ideate` - attach the provided app or website design to ImageGen; generate exactly three redesign options; show them and wait for selection.
|
|
79
|
+
- `$image-to-code` - only after the user selects an option.
|
|
80
|
+
|
|
81
|
+
"Redesign this {URL}"
|
|
82
|
+
|
|
83
|
+
Required next steps:
|
|
84
|
+
|
|
85
|
+
- `$get-context` - confirm the design brief, including the target URL, redesign goal, source constraints, and interactivity level.
|
|
86
|
+
- `$ideate` - attach provided app or website screenshot at the URL to ImageGen; generate exactly three redesign options; show them and wait for selection.
|
|
87
|
+
- `$image-to-code` - only after the user selects an option; use the URL as reference for existing content, structure, and interactions.
|
|
88
|
+
|
|
89
|
+
"Redesign my app"
|
|
90
|
+
|
|
91
|
+
Required next steps:
|
|
92
|
+
|
|
93
|
+
- `$get-context` - confirm the design brief, including the app surface, redesign goal, source constraints, and interactivity level.
|
|
94
|
+
- Find the app or website in the codebase.
|
|
95
|
+
- If there is more than one possible target, ask the user which one to redesign and whether they want to edit it directly or create a fresh prototype.
|
|
96
|
+
- `$ideate` - use the existing app or website as the source; generate exactly three redesign options; show them and wait for selection.
|
|
97
|
+
- `$image-to-code` - only after the user selects an option; refer to [references/existing-codebase-edits.md](references/existing-codebase-edits.md)
|
|
98
|
+
|
|
99
|
+
### Extend product
|
|
100
|
+
|
|
101
|
+
"Add {feature} to this {URL}"
|
|
102
|
+
|
|
103
|
+
Required next steps:
|
|
104
|
+
|
|
105
|
+
- `$get-context` - confirm the design brief, including the target URL, feature behavior, source constraints, and interactivity level.
|
|
106
|
+
- `$url-to-code` - recreate the app or website and add the requested feature.
|
|
107
|
+
|
|
108
|
+
"Add {feature} to my app"
|
|
109
|
+
|
|
110
|
+
Required next steps:
|
|
111
|
+
|
|
112
|
+
- `$get-context` - confirm the design brief, including the app surface, feature behavior, source constraints, and interactivity level.
|
|
113
|
+
- Find the app or website in the codebase.
|
|
114
|
+
- If there is more than one possible target, ask the user which one to extend.
|
|
115
|
+
- Implement the requested feature in the existing app or website; refer to [references/existing-codebase-edits.md](references/existing-codebase-edits.md)
|
|
116
|
+
|
|
117
|
+
When the user references a product name without a source URL or image, use the browser skill of choice to get actual screenshots of the product. Only fallback to web search images if the product isn't accessible.
|
|
118
|
+
|
|
119
|
+
## Hard Rules
|
|
120
|
+
|
|
121
|
+
- Written design direction is not a visual target. Use it as input to `$ideate` and ImageGen.
|
|
122
|
+
- Do not build from a brief alone.
|
|
123
|
+
- For redesigns, use `$ideate` to generate exactly three design options, show them, and wait for the user to choose one.
|
|
124
|
+
- Do not build a redesign until the user has chosen a design option.
|
|
125
|
+
- When a new product has no visual target after `$get-context`, use `$ideate` to generate exactly three design options, show them, and wait for the user to choose one.
|
|
126
|
+
- If the user gives feedback, or says they like more than one design, use `$ideate` to create a new ImageGen mock with the feedback or combined direction before build.
|
|
127
|
+
- Pass the user's written direction and attached design references into `$ideate` and ImageGen.
|
|
128
|
+
- If the current folder looks like an existing prototype and it is unclear whether to edit it or create a new one, ask the user.
|
|
@@ -0,0 +1,6 @@
|
|
|
1
|
+
interface:
|
|
2
|
+
display_name: "Prototype"
|
|
3
|
+
short_description: "Route prototype, redesign, clone, and UI build requests after brief confirmation"
|
|
4
|
+
default_prompt: "Confirm the design brief, then build a Product Design prototype."
|
|
5
|
+
policy:
|
|
6
|
+
allow_implicit_invocation: false
|
package/template/.codex/skills/product-design/skills/prototype/references/existing-codebase-edits.md
ADDED
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
# Existing App or Website Edits
|
|
2
|
+
|
|
3
|
+
Use this only when editing an existing local apps or websites directly.
|
|
4
|
+
|
|
5
|
+
1. Inspect the running app and source code before changing it.
|
|
6
|
+
2. Follow local `AGENTS.md` and any equivalent local design notes when they exist.
|
|
7
|
+
3. Prefer the existing codebase's design system (tokens, style variables, components, layout patterns, and interaction patterns).
|
|
8
|
+
4. Use existing layouts and components as much as you can.
|
|
9
|
+
5. Use realistic mock data that a user would expect to see in practice.
|
|
10
|
+
6. Record durable design decisions in `AGENTS.md` or local design notes when they should guide future edits.
|
|
11
|
+
|
|
12
|
+
Do not:
|
|
13
|
+
|
|
14
|
+
- Invent a new design system when the existing prototype has one
|
|
15
|
+
- Replace the app structure unless the user asks for a redesign
|
|
16
|
+
- Add made-up features just to fill the UI
|
|
17
|
+
- Use text, punctuation, emoji, CSS shapes, placeholder boxes, or handcrafted SVGs as asset or icon stand-ins
|
|
18
|
+
- Add long explanations inside the prototype UI.
|
|
@@ -0,0 +1,92 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: research
|
|
3
|
+
description: "Run fast, source-grounded UX research on the highest-signal problems users are experiencing with a user-specified digital product. Use when the user asks to research user pain, UX friction, onboarding issues, docs/help problems, developer experience friction, support pain, product workflow issues, or current user complaints for a named product."
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Research
|
|
7
|
+
|
|
8
|
+
Run a fresh UX research scan for the product the user specifies.
|
|
9
|
+
|
|
10
|
+
Focus on current, evidence-backed user problems. Prioritize logged-in product experience, self-serve flows, onboarding, docs/help, developer experience, support friction, and product workflows.
|
|
11
|
+
|
|
12
|
+
## Critical Overrides
|
|
13
|
+
|
|
14
|
+
- Refer to the Plugin router [$index](../index/SKILL.md) before proceeding.
|
|
15
|
+
- Follow [$critical-overrides](../../references/critical-overrides.md).
|
|
16
|
+
|
|
17
|
+
## User Context
|
|
18
|
+
|
|
19
|
+
Before starting, load [$user-context](../user-context/SKILL.md) and run its preflight script when local shell access is available.
|
|
20
|
+
|
|
21
|
+
Use saved product URLs, Figma files, screenshots, reference images, codebase paths, Storybook, tokens, design systems, brand assets, component refs, browser preferences, and share targets as grounding material when relevant.
|
|
22
|
+
|
|
23
|
+
Do not inspect every saved reference. Inspect only what the current task needs.
|
|
24
|
+
|
|
25
|
+
## Contract
|
|
26
|
+
|
|
27
|
+
- Restate the product, audience, time horizon, and research scope before scanning.
|
|
28
|
+
- Use public sources by default. Use internal sources when the connectors are available and the user request allows it.
|
|
29
|
+
- Cite sources wherever available.
|
|
30
|
+
- Separate observed evidence from inference.
|
|
31
|
+
- Do not overclaim from anecdotes.
|
|
32
|
+
- Do not return a dump of complaints. Tell a clear product story.
|
|
33
|
+
- Say clearly when source access is missing or weak.
|
|
34
|
+
|
|
35
|
+
## Workflow
|
|
36
|
+
|
|
37
|
+
1. Restate the research scope.
|
|
38
|
+
|
|
39
|
+
2. Search public sources:
|
|
40
|
+
|
|
41
|
+
- Reddit
|
|
42
|
+
- X/Twitter
|
|
43
|
+
- Hacker News
|
|
44
|
+
- Stack Overflow
|
|
45
|
+
- GitHub issues/discussions
|
|
46
|
+
- forums, blogs, reviews, YouTube comments, and developer communities where relevant
|
|
47
|
+
|
|
48
|
+
3. Search internal sources when available:
|
|
49
|
+
|
|
50
|
+
- Slack
|
|
51
|
+
- Gong
|
|
52
|
+
- Notion
|
|
53
|
+
- Google Drive/docs
|
|
54
|
+
- Linear/Jira/GitHub
|
|
55
|
+
- support or CRM notes if available
|
|
56
|
+
|
|
57
|
+
4. Cluster evidence into the highest-signal UX problems.
|
|
58
|
+
|
|
59
|
+
5. Separate:
|
|
60
|
+
|
|
61
|
+
- product UI/workflow friction
|
|
62
|
+
- docs/help friction
|
|
63
|
+
- onboarding friction
|
|
64
|
+
- account, billing, permissions, or setup friction
|
|
65
|
+
- developer/API/SDK friction
|
|
66
|
+
- reliability/performance issues
|
|
67
|
+
- feature requests
|
|
68
|
+
|
|
69
|
+
6. Rank problems by severity, frequency, confidence, and product leverage.
|
|
70
|
+
|
|
71
|
+
7. Tell a clear product story.
|
|
72
|
+
|
|
73
|
+
## Output
|
|
74
|
+
|
|
75
|
+
Default to an in-chat research brief unless the user asks for another format.
|
|
76
|
+
|
|
77
|
+
Include:
|
|
78
|
+
|
|
79
|
+
- Executive read: the core story in 5-7 sentences.
|
|
80
|
+
- Ranked UX problems: for each problem, include the problem, user goal, surface, what breaks, evidence, severity, frequency signal, confidence, and recommended product move.
|
|
81
|
+
- Source map: what was searched, what each source contributed, and where signal was weak.
|
|
82
|
+
- Opportunity map: group recommendations into fix this week, fix this quarter, and needs deeper research.
|
|
83
|
+
|
|
84
|
+
## Rules
|
|
85
|
+
|
|
86
|
+
- Use citations wherever available.
|
|
87
|
+
- Do not overclaim from anecdotes.
|
|
88
|
+
- Separate loud complaints from frequent problems.
|
|
89
|
+
- Separate UX friction from missing features.
|
|
90
|
+
- Separate reliability/performance issues from UX workflow issues.
|
|
91
|
+
- Mark internal-only evidence separately from public evidence.
|
|
92
|
+
- Keep the brief sharp, specific, and easy to consume.
|
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: share
|
|
3
|
+
description: "Share a runnable prototype using the user's preferred deployment tool."
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Share
|
|
7
|
+
|
|
8
|
+
Deploy the user's runnable prototype so they can share it with others.
|
|
9
|
+
|
|
10
|
+
## Critical Overrides
|
|
11
|
+
|
|
12
|
+
- Refer to the Plugin router [$index](../index/SKILL.md) before proceeding.
|
|
13
|
+
- Follow [$critical-overrides](../../references/critical-overrides.md).
|
|
14
|
+
|
|
15
|
+
## User Context
|
|
16
|
+
|
|
17
|
+
Before starting, load [$user-context](../user-context/SKILL.md) and run its preflight script when local shell access is available.
|
|
18
|
+
|
|
19
|
+
Use saved product URLs, Figma files, screenshots, reference images, codebase paths, Storybook, tokens, design systems, brand assets, component refs, browser preferences, and share targets as grounding material when relevant.
|
|
20
|
+
|
|
21
|
+
Do not inspect every saved reference. Inspect only what the current task needs.
|
|
22
|
+
|
|
23
|
+
## Workflow
|
|
24
|
+
|
|
25
|
+
1. Confirm the prototype directory and the user's preferred deployment target.
|
|
26
|
+
2. If the user invokes Product Design with @Sites, @Vercel, or another deployment tool, treat that as the selected hosting target.
|
|
27
|
+
3. If the user did not choose a target, ask one question:
|
|
28
|
+
|
|
29
|
+
> Where should I deploy this: @Sites, @Vercel, or another target?
|
|
30
|
+
|
|
31
|
+
4. Use the selected deployment tool when it is available.
|
|
32
|
+
5. If the selected tool is not available, say that clearly and ask whether to use another target.
|
|
33
|
+
6. Run the deployment when possible. Do not give setup instructions if you can complete the deployment directly.
|
|
34
|
+
7. Return the shareable URL.
|
|
35
|
+
8. State any misses or manual follow-up the user still needs to do.
|
|
36
|
+
|
|
37
|
+
## Rules
|
|
38
|
+
|
|
39
|
+
- Do not deploy before the user chooses or confirms the target.
|
|
40
|
+
- Do not claim the prototype is shared until you have a working URL.
|
|
41
|
+
- If the selected tool is not available, say that clearly and ask whether to use another target.
|
|
@@ -0,0 +1,124 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: url-to-code
|
|
3
|
+
description: "Clone a live URL as a runnable frontend-only local app using Browser/Chrome source evidence after Product Design get-context has confirmed the design brief."
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# URL To Code
|
|
7
|
+
|
|
8
|
+
Clone `<target-url>` as a real interactive, frontend-only local app or website. The clone should look and interact like the source.
|
|
9
|
+
|
|
10
|
+
## Critical Overrides
|
|
11
|
+
|
|
12
|
+
- Refer to the Plugin router [$index](../index/SKILL.md) before proceeding.
|
|
13
|
+
- Follow [$critical-overrides](../../references/critical-overrides.md).
|
|
14
|
+
|
|
15
|
+
## User Context
|
|
16
|
+
|
|
17
|
+
Before starting, load [$user-context](../user-context/SKILL.md) and run its preflight script when local shell access is available.
|
|
18
|
+
|
|
19
|
+
Use saved product URLs, Figma files, screenshots, reference images, codebase paths, Storybook, tokens, design systems, brand assets, component refs, browser preferences, and share targets as grounding material when relevant.
|
|
20
|
+
|
|
21
|
+
Do not inspect every saved reference. Inspect only what the current task needs.
|
|
22
|
+
|
|
23
|
+
## Workflow
|
|
24
|
+
|
|
25
|
+
0. Do not start unless `$get-context` has played back and confirmed the design brief for this exact request. If this skill was invoked directly and the current thread does not already contain that confirmed brief, route to [$get-context](../get-context/SKILL.md) first.
|
|
26
|
+
|
|
27
|
+
1. CRITICAL STEP: Warn the user that they must follow the target website's terms before proceeding. This workflow is only for apps and websites the user owns, or has permission to recreate.
|
|
28
|
+
|
|
29
|
+
2. Open the source URL using [browser-order](../../references/browser-order.md).
|
|
30
|
+
|
|
31
|
+
3. Check that the page is correct.
|
|
32
|
+
|
|
33
|
+
- Do not continue if it shows the wrong page, a blocked page, a login page, a promo page, a loading screen, an error page, an app-install page, or an unrelated redirect.
|
|
34
|
+
- If the page is wrong, try again with another available browser.
|
|
35
|
+
- If every browser shows the wrong page, stop and tell the user what you can see.
|
|
36
|
+
|
|
37
|
+
4. Capture the source page carefully.
|
|
38
|
+
|
|
39
|
+
- Start at the top of the page.
|
|
40
|
+
- Scroll down in small steps.
|
|
41
|
+
- At each step, capture what is visible.
|
|
42
|
+
- Note any new sections, controls, sticky elements, animations, or lazy-loaded assets.
|
|
43
|
+
- Continue until the full page has been seen.
|
|
44
|
+
- Scroll back to the top and check whether anything changed.
|
|
45
|
+
- Repeat on mobile at `390 x 844`.
|
|
46
|
+
|
|
47
|
+
5. Use the browser DOM tools to gather everything needed to recreate the source.
|
|
48
|
+
|
|
49
|
+
- Elements
|
|
50
|
+
- Components
|
|
51
|
+
- Text
|
|
52
|
+
- Links
|
|
53
|
+
- Buttons and controls
|
|
54
|
+
- States
|
|
55
|
+
- Images
|
|
56
|
+
- Icons
|
|
57
|
+
- Fonts
|
|
58
|
+
- Videos
|
|
59
|
+
- SVGs
|
|
60
|
+
- Style sheets
|
|
61
|
+
- Colors
|
|
62
|
+
- Spacing
|
|
63
|
+
- Layout sizes
|
|
64
|
+
- Responsive behavior
|
|
65
|
+
|
|
66
|
+
6. Find and test the page interactions.
|
|
67
|
+
|
|
68
|
+
- Use the screenshots and browser DOM tools to find visible controls.
|
|
69
|
+
- Include navigation, buttons, links, inputs, menus, drawers, modals, tabs, carousels, hover states, sticky elements, and anything else the user can interact with.
|
|
70
|
+
- Test one control at a time.
|
|
71
|
+
- Return to the starting state before testing the next control.
|
|
72
|
+
- Save the result when the page visibly changes or the browser tools show a state change.
|
|
73
|
+
|
|
74
|
+
7. Copy the real assets from the source page.
|
|
75
|
+
|
|
76
|
+
- If the page loads the asset, treat it as available unless the browser cannot access or save it.
|
|
77
|
+
- If an image, logo, icon, font, video, SVG, sprite, mask, cursor, or background image is used by the page, copy it locally.
|
|
78
|
+
- If an image asset cannot be copied, generate a replacement with ImageGen using a screenshot of the original.
|
|
79
|
+
- If a font file cannot be copied, use the closest open source font match.
|
|
80
|
+
- If an icon or glyph cannot be copied, use the closest matching open source icon set. Do not default to Lucide unless it is the closest match.
|
|
81
|
+
- Briefly note any asset, font, or icon you replaced and why.
|
|
82
|
+
|
|
83
|
+
8. Create the local app with [local-prototype-preflight](../../references/local-prototype-preflight.md).
|
|
84
|
+
|
|
85
|
+
9. Build only from what you captured, copied, or gathered from the source.
|
|
86
|
+
|
|
87
|
+
- Do not add new visual ideas.
|
|
88
|
+
- Do not use hotlinked source assets.
|
|
89
|
+
- Do not guess when source proof is available.
|
|
90
|
+
|
|
91
|
+
10. Run the local app.
|
|
92
|
+
|
|
93
|
+
11. Compare the local app against the original.
|
|
94
|
+
|
|
95
|
+
- Check desktop.
|
|
96
|
+
- Check mobile.
|
|
97
|
+
- Check every interaction you captured.
|
|
98
|
+
- Fix any obvious mismatch before running final QA.
|
|
99
|
+
|
|
100
|
+
12. Run [design-qa](../design-qa/SKILL.md) as the blocking build gate.
|
|
101
|
+
|
|
102
|
+
- Save the QA report as `design-qa.md` in the project root.
|
|
103
|
+
- Fix P0/P1/P2 issues, capture the app again, and repeat until the QA report says `final result: passed`.
|
|
104
|
+
- Do not keep looping on P3 polish. Include any remaining P3s as follow-up iteration notes.
|
|
105
|
+
- If source capture, prototype capture, or visual comparison is blocked, stop. `design-qa.md` must say `final result: blocked`.
|
|
106
|
+
- Do not hand off unless `design-qa.md` exists and says `final result: passed`.
|
|
107
|
+
|
|
108
|
+
13. Handoff the app or website
|
|
109
|
+
|
|
110
|
+
- Only hand off after [design-qa](../design-qa/SKILL.md) passes.
|
|
111
|
+
- Keep the prototype running locally.
|
|
112
|
+
- Provide the clickable local URL.
|
|
113
|
+
- Briefly describe the work as a designer would.
|
|
114
|
+
- Include the post-build iteration and share nudge from [critical-overrides](../../references/critical-overrides.md#build-handoff).
|
|
115
|
+
|
|
116
|
+
## Hard Rules
|
|
117
|
+
|
|
118
|
+
- Capture source evidence first. Do not scaffold, write app code, start a server, or create the local prototype until desktop capture, mobile capture, key states, and every required asset, icon, control mark, and font is captured or replaced.
|
|
119
|
+
- Do not hand off until every single interaction and state is captured from the target.
|
|
120
|
+
- Do not build from memory, screenshots alone, guessed CSS, generic assets, or prior chats.
|
|
121
|
+
- Do not implement a saved state without source screenshot plus the available DOM/style/layout evidence for that state.
|
|
122
|
+
- Do not use hotlinked source assets in the final app.
|
|
123
|
+
- Do not create temporary CSS icons, text glyphs, emoji marks, placeholder blocks, or handmade SVGs while "waiting" to resolve assets. Resolve assets first, then build.
|
|
124
|
+
- If Browser and Chrome fail, ask before using Playwright. If no approved tool can capture valid source and prototype evidence, stop and report the design-qa blocker.
|
|
@@ -0,0 +1,6 @@
|
|
|
1
|
+
interface:
|
|
2
|
+
display_name: "URL To Code"
|
|
3
|
+
short_description: "Clone a live URL into a runnable frontend prototype after brief confirmation"
|
|
4
|
+
default_prompt: "Confirm the design brief, then clone this URL as a runnable frontend prototype."
|
|
5
|
+
policy:
|
|
6
|
+
allow_implicit_invocation: false
|
|
@@ -0,0 +1,147 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: user-context
|
|
3
|
+
description: Load or manage Product Design's saved user context. Use when the user asks to set up Product Design, get started, onboard, save product or design sources, see what Product Design remembers, update saved context, or remember Product Design preferences. Examples include product URLs, Figma files, screenshots, reference images, codebase paths, Storybook, tokens, design systems, brand assets, and general product/design notes.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# User Context
|
|
7
|
+
|
|
8
|
+
User Context stores the product and design references a designer uses often, so future Product Design work starts from the right sources.
|
|
9
|
+
|
|
10
|
+
Use this skill when the user asks to:
|
|
11
|
+
|
|
12
|
+
- set up Product Design
|
|
13
|
+
- get started with Product Design
|
|
14
|
+
- onboard with Product Design
|
|
15
|
+
- save product or design sources
|
|
16
|
+
- see what Product Design remembers
|
|
17
|
+
- update saved product or design context
|
|
18
|
+
- remember a Product Design preference
|
|
19
|
+
- setup my plugin
|
|
20
|
+
|
|
21
|
+
## Critical Overrides
|
|
22
|
+
|
|
23
|
+
- Refer to the Plugin router [$index](../index/SKILL.md) before proceeding.
|
|
24
|
+
- Follow [$critical-overrides](../../references/critical-overrides.md).
|
|
25
|
+
|
|
26
|
+
## Saved User Context
|
|
27
|
+
|
|
28
|
+
If `user-context.md` exists, use it by default.
|
|
29
|
+
|
|
30
|
+
Use saved product URLs, Figma files, screenshots, reference images, codebase paths, Storybook, tokens, design systems, brand assets, component refs, browser preferences, and share targets to ground Product Design work.
|
|
31
|
+
|
|
32
|
+
Ideation, prototypes, audits, clones, and critiques should match the saved product context unless the user asks for something different.
|
|
33
|
+
|
|
34
|
+
When a workflow needs visual grounding, attach or include relevant saved screenshots, reference images, tokens, design language, and component references in ImageGen, ideation, prototype, audit, and critique work.
|
|
35
|
+
|
|
36
|
+
## State File
|
|
37
|
+
|
|
38
|
+
Saved context lives here:
|
|
39
|
+
|
|
40
|
+
```text
|
|
41
|
+
$CODEX_HOME/state/plugins/product-design/user-context.md
|
|
42
|
+
```
|
|
43
|
+
|
|
44
|
+
Saved screenshots and reference images live next to it:
|
|
45
|
+
|
|
46
|
+
```text
|
|
47
|
+
$CODEX_HOME/state/plugins/product-design/assets/
|
|
48
|
+
```
|
|
49
|
+
|
|
50
|
+
If the file does not exist, continue normally unless the user asks to set up Product Design, save context, or the current task is blocked by missing product/design context.
|
|
51
|
+
|
|
52
|
+
## Preflight
|
|
53
|
+
|
|
54
|
+
When any Product Design workflow needs saved context, run:
|
|
55
|
+
|
|
56
|
+
```bash
|
|
57
|
+
python3 scripts/user_context_preflight.py
|
|
58
|
+
```
|
|
59
|
+
|
|
60
|
+
Use the returned saved entries as the starting context for the task.
|
|
61
|
+
|
|
62
|
+
If the script reports that no saved context exists, continue from the current user prompt unless setup context is required.
|
|
63
|
+
|
|
64
|
+
Do not browse, open, or inspect every saved reference during preflight. Inspect only the saved references needed for the current task.
|
|
65
|
+
|
|
66
|
+
## Setup
|
|
67
|
+
|
|
68
|
+
Use [references/onboarding.md](references/onboarding.md) when the user asks to set up Product Design, asks what Product Design can remember, asks what Product Design knows about their product, or provides product/design references to save.
|
|
69
|
+
|
|
70
|
+
For setup-only requests, explain what Product Design can remember and ask for useful sources.
|
|
71
|
+
|
|
72
|
+
Adjust the context-gathering request to match the user's request. First-time setup differs from updating existing context.
|
|
73
|
+
|
|
74
|
+
Do not inspect the workspace, install dependencies, scaffold a prototype, generate images, run audits, or start implementation during setup.
|
|
75
|
+
|
|
76
|
+
After the user provides references to save, run:
|
|
77
|
+
|
|
78
|
+
```bash
|
|
79
|
+
python3 scripts/init_user_context.py
|
|
80
|
+
```
|
|
81
|
+
|
|
82
|
+
Then add the references to the created `user-context.md`.
|
|
83
|
+
|
|
84
|
+
## Save
|
|
85
|
+
|
|
86
|
+
Save useful, durable Product Design context:
|
|
87
|
+
|
|
88
|
+
- Product URLs
|
|
89
|
+
- Figma files
|
|
90
|
+
- Screenshots and reference images
|
|
91
|
+
- Codebase paths
|
|
92
|
+
- Storybook and component docs
|
|
93
|
+
- Design tokens and theme sources
|
|
94
|
+
- Brand, logo, icon, illustration, image, and asset sources
|
|
95
|
+
- Preferred browser, capture tools, and share targets
|
|
96
|
+
- Team conventions that make future Product Design work more accurate
|
|
97
|
+
|
|
98
|
+
When the user provides screenshots or reference images to save, copy them into `assets/` next to `user-context.md` and link them from the saved entry.
|
|
99
|
+
|
|
100
|
+
Give each saved image a clear, descriptive filename that says what the image shows. Use names future Product Design runs can understand without opening the file.
|
|
101
|
+
|
|
102
|
+
Good image names:
|
|
103
|
+
|
|
104
|
+
```text
|
|
105
|
+
assets/chatgpt-settings-modal-dark-mode.png
|
|
106
|
+
assets/payment-sheet-mobile-error-state.png
|
|
107
|
+
assets/product-dashboard-sidebar-navigation.png
|
|
108
|
+
assets/storybook-primary-button-states.png
|
|
109
|
+
assets/brand-logo-lockup-purple-gradient.png
|
|
110
|
+
assets/onboarding-flow-welcome-step.png
|
|
111
|
+
assets/checkout-confirmation-screen.png
|
|
112
|
+
assets/account-menu-open-state.png
|
|
113
|
+
```
|
|
114
|
+
|
|
115
|
+
Do not save secrets, credentials, API keys, private tokens, copied customer data, or anything that should not persist.
|
|
116
|
+
|
|
117
|
+
Use this structure:
|
|
118
|
+
|
|
119
|
+
```md
|
|
120
|
+
# {Category}
|
|
121
|
+
|
|
122
|
+
- Description: {what this category is and when future Product Design runs should use it}
|
|
123
|
+
|
|
124
|
+
## Saved Links And Context
|
|
125
|
+
|
|
126
|
+
{Saved reference or fact}
|
|
127
|
+
- Date Added: YYYY-MM-DD.
|
|
128
|
+
- File: assets/{clear-descriptive-name}.png
|
|
129
|
+
- Useful Context: {what this reference represents}
|
|
130
|
+
- Future Use: {how future Product Design work should use it}
|
|
131
|
+
```
|
|
132
|
+
|
|
133
|
+
Include `File:` only when the saved entry has a local image file.
|
|
134
|
+
|
|
135
|
+
When a category has no saved references yet, use exactly:
|
|
136
|
+
|
|
137
|
+
```md
|
|
138
|
+
status: not provided
|
|
139
|
+
```
|
|
140
|
+
|
|
141
|
+
Keep saved context curated. Prefer a few high-value references over a dump of every possible URL or file.
|
|
142
|
+
|
|
143
|
+
## Read
|
|
144
|
+
|
|
145
|
+
- Do not treat `status: not provided` as a fact.
|
|
146
|
+
- Read through `scripts/user_context_preflight.py` when local shell access is available.
|
|
147
|
+
- Use saved context as default grounding, then inspect only what the current task needs.
|
|
@@ -0,0 +1,6 @@
|
|
|
1
|
+
interface:
|
|
2
|
+
display_name: "User Context"
|
|
3
|
+
short_description: "Save and read Product Design user context"
|
|
4
|
+
default_prompt: "Set up Product Design with my product URLs, Figma files, screenshots, codebase paths, Storybook, tokens, and brand assets."
|
|
5
|
+
policy:
|
|
6
|
+
allow_implicit_invocation: false
|
|
@@ -0,0 +1,63 @@
|
|
|
1
|
+
# Product URLs
|
|
2
|
+
|
|
3
|
+
- Description: Production, staging, local app, docs, admin, or key flow URLs Product Design can use as likely source surfaces.
|
|
4
|
+
|
|
5
|
+
## Saved Links And Context
|
|
6
|
+
|
|
7
|
+
status: not provided
|
|
8
|
+
|
|
9
|
+
# Figma Sources
|
|
10
|
+
|
|
11
|
+
- Description: Product files, design-system files, component libraries, prototypes, FigJam boards, or other Figma sources.
|
|
12
|
+
|
|
13
|
+
## Saved Links And Context
|
|
14
|
+
|
|
15
|
+
status: not provided
|
|
16
|
+
|
|
17
|
+
# Screenshots And Reference Images
|
|
18
|
+
|
|
19
|
+
- Description: Local screenshots and reference images saved under `assets/` next to `user-context.md`.
|
|
20
|
+
|
|
21
|
+
## Saved Links And Context
|
|
22
|
+
|
|
23
|
+
status: not provided
|
|
24
|
+
|
|
25
|
+
# Codebase References
|
|
26
|
+
|
|
27
|
+
- Description: Repo roots, app packages, component folders, token files, theme files, CSS entrypoints, or implementation notes.
|
|
28
|
+
|
|
29
|
+
## Saved Links And Context
|
|
30
|
+
|
|
31
|
+
status: not provided
|
|
32
|
+
|
|
33
|
+
# Storybook And Component Docs
|
|
34
|
+
|
|
35
|
+
- Description: Storybook URLs, component docs, design-system docs, UI kit docs, or local component preview commands.
|
|
36
|
+
|
|
37
|
+
## Saved Links And Context
|
|
38
|
+
|
|
39
|
+
status: not provided
|
|
40
|
+
|
|
41
|
+
# Design Tokens And Theme Sources
|
|
42
|
+
|
|
43
|
+
- Description: Tokens, typography, spacing, color, radius, icon, motion, CSS variable, Tailwind, or theme sources.
|
|
44
|
+
|
|
45
|
+
## Saved Links And Context
|
|
46
|
+
|
|
47
|
+
status: not provided
|
|
48
|
+
|
|
49
|
+
# Brand And Asset Sources
|
|
50
|
+
|
|
51
|
+
- Description: Logos, app icons, illustration libraries, product imagery, icon sets, image libraries, and brand guidelines.
|
|
52
|
+
|
|
53
|
+
## Saved Links And Context
|
|
54
|
+
|
|
55
|
+
status: not provided
|
|
56
|
+
|
|
57
|
+
# Tool And Sharing Preferences
|
|
58
|
+
|
|
59
|
+
- Description: Preferred browser, capture tool, Figma usage, share target, deployment target, and team workflow preferences.
|
|
60
|
+
|
|
61
|
+
## Saved Links And Context
|
|
62
|
+
|
|
63
|
+
status: not provided
|