blendops 0.0.0-stage → 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.
- package/CHANGELOG.md +62 -0
- package/LICENSE +21 -0
- package/README.md +189 -2
- package/bin/blendops.mjs +4 -0
- package/bundles/claude-desktop-manual/BLENDOPS_SINGLE_FILE.md +78 -0
- package/bundles/claude-desktop-manual/IMPORT_STEPS.md +43 -0
- package/bundles/claude-desktop-manual/INSTALL_REPORT_TEMPLATE.md +13 -0
- package/bundles/claude-desktop-manual/README.md +70 -0
- package/bundles/claude-desktop-manual/SKILL.md +62 -0
- package/bundles/claude-desktop-manual/manifest.json +278 -0
- package/bundles/claude-desktop-manual/references/evidence-rules.md +13 -0
- package/bundles/claude-desktop-manual/references/install-boundary.md +13 -0
- package/bundles/claude-desktop-manual/references/laws/evidence-before-done.md +14 -0
- package/bundles/claude-desktop-manual/references/laws/no-arbitrary-python-interface.md +12 -0
- package/bundles/claude-desktop-manual/references/laws/non-blender-user-language.md +13 -0
- package/bundles/claude-desktop-manual/references/laws/official-runtime-only.md +20 -0
- package/bundles/claude-desktop-manual/references/packs/product-hero-v0.md +30 -0
- package/bundles/claude-desktop-manual/references/runtime-stacks.md +13 -0
- package/bundles/claude-desktop-manual/references/skill-map.md +36 -0
- package/bundles/claude-desktop-manual/references/skills/acceptance-criteria-builder.md +69 -0
- package/bundles/claude-desktop-manual/references/skills/asset-discovery.md +73 -0
- package/bundles/claude-desktop-manual/references/skills/asset-fallback-strategy.md +66 -0
- package/bundles/claude-desktop-manual/references/skills/asset-library-plan.md +69 -0
- package/bundles/claude-desktop-manual/references/skills/asset-license-checker.md +69 -0
- package/bundles/claude-desktop-manual/references/skills/asset-style-check.md +69 -0
- package/bundles/claude-desktop-manual/references/skills/blender-brainstorming.md +62 -0
- package/bundles/claude-desktop-manual/references/skills/blender-recipe-decomposer.md +66 -0
- package/bundles/claude-desktop-manual/references/skills/blender-troubleshooting.md +78 -0
- package/bundles/claude-desktop-manual/references/skills/blendops-help.md +82 -0
- package/bundles/claude-desktop-manual/references/skills/bridge-conflicts.md +68 -0
- package/bundles/claude-desktop-manual/references/skills/camera-composition.md +65 -0
- package/bundles/claude-desktop-manual/references/skills/character-portrait.md +68 -0
- package/bundles/claude-desktop-manual/references/skills/cli-appendix-job-outline.md +62 -0
- package/bundles/claude-desktop-manual/references/skills/color-management-decision.md +68 -0
- package/bundles/claude-desktop-manual/references/skills/composition-quality-checker.md +71 -0
- package/bundles/claude-desktop-manual/references/skills/cycles-vs-eevee-decision.md +65 -0
- package/bundles/claude-desktop-manual/references/skills/done-criteria.md +70 -0
- package/bundles/claude-desktop-manual/references/skills/environment-shot.md +65 -0
- package/bundles/claude-desktop-manual/references/skills/glb-animation-handoff.md +69 -0
- package/bundles/claude-desktop-manual/references/skills/glb-web-handoff.md +68 -0
- package/bundles/claude-desktop-manual/references/skills/intent-to-3d-brief-writer.md +68 -0
- package/bundles/claude-desktop-manual/references/skills/interior-scene.md +73 -0
- package/bundles/claude-desktop-manual/references/skills/lighting-material-plan.md +65 -0
- package/bundles/claude-desktop-manual/references/skills/lighting-quality-checker.md +70 -0
- package/bundles/claude-desktop-manual/references/skills/material-quality-checker.md +71 -0
- package/bundles/claude-desktop-manual/references/skills/mobile-glb-budget.md +73 -0
- package/bundles/claude-desktop-manual/references/skills/output-format-decision.md +63 -0
- package/bundles/claude-desktop-manual/references/skills/pack-prerequisite-checker.md +74 -0
- package/bundles/claude-desktop-manual/references/skills/path-one-host-outline.md +66 -0
- package/bundles/claude-desktop-manual/references/skills/plain-language-response.md +70 -0
- package/bundles/claude-desktop-manual/references/skills/polycount-budget-checker.md +71 -0
- package/bundles/claude-desktop-manual/references/skills/pre-handoff-verification.md +76 -0
- package/bundles/claude-desktop-manual/references/skills/preview-report.md +62 -0
- package/bundles/claude-desktop-manual/references/skills/product-grid-scene-planner.md +72 -0
- package/bundles/claude-desktop-manual/references/skills/product-hero-scene-planner.md +68 -0
- package/bundles/claude-desktop-manual/references/skills/r3f-component-plan.md +66 -0
- package/bundles/claude-desktop-manual/references/skills/recipe-fit-assessor.md +75 -0
- package/bundles/claude-desktop-manual/references/skills/render-export-evidence.md +70 -0
- package/bundles/claude-desktop-manual/references/skills/resolution-aspect-decision.md +65 -0
- package/bundles/claude-desktop-manual/references/skills/runtime-attempt-report.md +67 -0
- package/bundles/claude-desktop-manual/references/skills/runtime-path-picker.md +67 -0
- package/bundles/claude-desktop-manual/references/skills/runtime-readiness.md +63 -0
- package/bundles/claude-desktop-manual/references/skills/runtime-setup.md +63 -0
- package/bundles/claude-desktop-manual/references/skills/scene-readiness.md +65 -0
- package/bundles/claude-desktop-manual/references/skills/scope-guard.md +62 -0
- package/bundles/claude-desktop-manual/references/skills/stage-gates.md +91 -0
- package/bundles/claude-desktop-manual/references/skills/workflow-stage-router.md +67 -0
- package/bundles/generic-project-local/BLENDOPS.md +71 -0
- package/bundles/generic-project-local/INSTALL_REPORT_TEMPLATE.md +52 -0
- package/bundles/generic-project-local/README.md +72 -0
- package/bundles/generic-project-local/ROLLBACK.md +66 -0
- package/bundles/generic-project-local/manifest.json +66 -0
- package/bundles/skill-package/README.md +54 -0
- package/bundles/skill-package/blendops/LICENSE.txt +21 -0
- package/bundles/skill-package/blendops/SKILL.md +50 -0
- package/bundles/skill-package/blendops/agents/README.md +61 -0
- package/bundles/skill-package/blendops/agents/openai.yaml +4 -0
- package/bundles/skill-package/blendops/references/evidence-rules.md +17 -0
- package/bundles/skill-package/blendops/references/install-boundary.md +13 -0
- package/bundles/skill-package/blendops/references/law-evidence-before-done.md +12 -0
- package/bundles/skill-package/blendops/references/law-no-arbitrary-python-interface.md +7 -0
- package/bundles/skill-package/blendops/references/law-non-blender-user-language.md +8 -0
- package/bundles/skill-package/blendops/references/law-official-runtime-only.md +9 -0
- package/bundles/skill-package/blendops/references/pack-product-hero-v0.md +21 -0
- package/bundles/skill-package/blendops/references/runtime-stacks.md +13 -0
- package/bundles/skill-package/blendops/references/skill-acceptance-criteria-builder.md +51 -0
- package/bundles/skill-package/blendops/references/skill-asset-discovery.md +54 -0
- package/bundles/skill-package/blendops/references/skill-asset-fallback-strategy.md +48 -0
- package/bundles/skill-package/blendops/references/skill-asset-library-plan.md +51 -0
- package/bundles/skill-package/blendops/references/skill-asset-license-checker.md +51 -0
- package/bundles/skill-package/blendops/references/skill-asset-style-check.md +52 -0
- package/bundles/skill-package/blendops/references/skill-blender-brainstorming.md +43 -0
- package/bundles/skill-package/blendops/references/skill-blender-recipe-decomposer.md +48 -0
- package/bundles/skill-package/blendops/references/skill-blender-troubleshooting.md +59 -0
- package/bundles/skill-package/blendops/references/skill-blendops-help.md +62 -0
- package/bundles/skill-package/blendops/references/skill-bridge-conflicts.md +48 -0
- package/bundles/skill-package/blendops/references/skill-camera-composition.md +48 -0
- package/bundles/skill-package/blendops/references/skill-character-portrait.md +50 -0
- package/bundles/skill-package/blendops/references/skill-cli-appendix-job-outline.md +44 -0
- package/bundles/skill-package/blendops/references/skill-color-management-decision.md +50 -0
- package/bundles/skill-package/blendops/references/skill-composition-quality-checker.md +53 -0
- package/bundles/skill-package/blendops/references/skill-cycles-vs-eevee-decision.md +47 -0
- package/bundles/skill-package/blendops/references/skill-done-criteria.md +53 -0
- package/bundles/skill-package/blendops/references/skill-environment-shot.md +47 -0
- package/bundles/skill-package/blendops/references/skill-glb-animation-handoff.md +51 -0
- package/bundles/skill-package/blendops/references/skill-glb-web-handoff.md +51 -0
- package/bundles/skill-package/blendops/references/skill-intent-to-3d-brief-writer.md +50 -0
- package/bundles/skill-package/blendops/references/skill-interior-scene.md +54 -0
- package/bundles/skill-package/blendops/references/skill-lighting-material-plan.md +48 -0
- package/bundles/skill-package/blendops/references/skill-lighting-quality-checker.md +52 -0
- package/bundles/skill-package/blendops/references/skill-map.md +32 -0
- package/bundles/skill-package/blendops/references/skill-material-quality-checker.md +53 -0
- package/bundles/skill-package/blendops/references/skill-mobile-glb-budget.md +55 -0
- package/bundles/skill-package/blendops/references/skill-output-format-decision.md +46 -0
- package/bundles/skill-package/blendops/references/skill-pack-prerequisite-checker.md +56 -0
- package/bundles/skill-package/blendops/references/skill-path-one-host-outline.md +48 -0
- package/bundles/skill-package/blendops/references/skill-plain-language-response.md +53 -0
- package/bundles/skill-package/blendops/references/skill-polycount-budget-checker.md +53 -0
- package/bundles/skill-package/blendops/references/skill-pre-handoff-verification.md +57 -0
- package/bundles/skill-package/blendops/references/skill-preview-report.md +45 -0
- package/bundles/skill-package/blendops/references/skill-product-grid-scene-planner.md +54 -0
- package/bundles/skill-package/blendops/references/skill-product-hero-scene-planner.md +51 -0
- package/bundles/skill-package/blendops/references/skill-r3f-component-plan.md +48 -0
- package/bundles/skill-package/blendops/references/skill-recipe-fit-assessor.md +57 -0
- package/bundles/skill-package/blendops/references/skill-render-export-evidence.md +51 -0
- package/bundles/skill-package/blendops/references/skill-resolution-aspect-decision.md +48 -0
- package/bundles/skill-package/blendops/references/skill-runtime-attempt-report.md +49 -0
- package/bundles/skill-package/blendops/references/skill-runtime-path-picker.md +49 -0
- package/bundles/skill-package/blendops/references/skill-runtime-readiness.md +45 -0
- package/bundles/skill-package/blendops/references/skill-runtime-setup.md +45 -0
- package/bundles/skill-package/blendops/references/skill-scene-readiness.md +48 -0
- package/bundles/skill-package/blendops/references/skill-scope-guard.md +44 -0
- package/bundles/skill-package/blendops/references/skill-stage-gates.md +73 -0
- package/bundles/skill-package/blendops/references/skill-workflow-stage-router.md +49 -0
- package/docs/examples/glb-web-handoff/README.md +174 -0
- package/docs/examples/glb-web-handoff/r3f-glb-viewer.tsx +320 -0
- package/docs/examples/glb-web-handoff/threejs-glb-viewer.mjs +709 -0
- package/docs/knowledge-and-recipe-catalog.md +236 -0
- package/docs/recipes/README.md +27 -0
- package/docs/recipes/cyberpunk-shoe-hero.md +97 -0
- package/docs/workflows/README.md +14 -0
- package/docs/workflows/full-non-blender-user-workflow.md +210 -0
- package/docs/workflows/product-hero-workflow.md +92 -0
- package/laws/README.md +32 -0
- package/laws/evidence-before-done.md +37 -0
- package/laws/no-arbitrary-python-interface.md +32 -0
- package/laws/non-blender-user-language.md +32 -0
- package/laws/official-runtime-only.md +78 -0
- package/package.json +99 -4
- package/packs/README.md +11 -0
- package/packs/product-hero-v0/PACK.md +114 -0
- package/registry/catalog-index.json +21344 -0
- package/registry/compatibility-matrix.json +533 -0
- package/registry/contract-context-fields.json +391 -0
- package/registry/knowledge-catalog.json +4648 -0
- package/registry/knowledge-sources.json +438 -0
- package/registry/recipe-catalog.json +2565 -0
- package/registry/runtime-capability-policy.json +525 -0
- package/registry/runtime-operations.json +4468 -0
- package/registry/skills.json +10231 -0
- package/registry/workflow-graph.json +7390 -0
- package/schemas/adapter-compatibility-matrix.schema.json +166 -0
- package/schemas/contract-context-fields.schema.json +147 -0
- package/schemas/execution-plan.schema.json +325 -0
- package/schemas/glb-web-handoff-manifest.schema.json +744 -0
- package/schemas/knowledge-record.schema.json +460 -0
- package/schemas/knowledge-source-registry.schema.json +268 -0
- package/schemas/operation-execution-ledger.schema.json +348 -0
- package/schemas/recipe-record.schema.json +469 -0
- package/schemas/runtime-capability-policy.schema.json +184 -0
- package/schemas/runtime-evidence-packet.schema.json +211 -0
- package/schemas/runtime-operations.schema.json +535 -0
- package/schemas/runtime-qualification-report.schema.json +540 -0
- package/schemas/runtime-session.schema.json +350 -0
- package/schemas/scene-spec.schema.json +624 -0
- package/schemas/skill-contract.schema.json +402 -0
- package/schemas/skill-eval.schema.json +509 -0
- package/scripts/build-knowledge-catalog.mjs +2376 -0
- package/scripts/compile-scene-plan.mjs +1945 -0
- package/scripts/export-claude-skills.mjs +634 -0
- package/scripts/generate-glb-handoff-report.mjs +2376 -0
- package/scripts/inspect-glb.mjs +1627 -0
- package/scripts/install-skills.mjs +5369 -0
- package/scripts/runtime-orchestrator.mjs +7652 -0
- package/scripts/validate-capability-policy.mjs +531 -0
- package/scripts/validate-evidence-packet.mjs +256 -0
- package/skills/README.md +315 -0
- package/skills/_template/SKILL.md +296 -0
- package/skills/acceptance-criteria-builder/EVAL.md +25 -0
- package/skills/acceptance-criteria-builder/SKILL.md +257 -0
- package/skills/acceptance-criteria-builder/contract.json +205 -0
- package/skills/acceptance-criteria-builder/references/brief-to-criteria-mapper.md +22 -0
- package/skills/acceptance-criteria-builder/references/checklist-patterns.md +22 -0
- package/skills/acceptance-criteria-builder/references/evidence-hook-rules.md +19 -0
- package/skills/asset-discovery/EVAL.md +81 -0
- package/skills/asset-discovery/SKILL.md +252 -0
- package/skills/asset-discovery/contract.json +291 -0
- package/skills/asset-discovery/references/asset-strategy-decision-tree.md +40 -0
- package/skills/asset-discovery/references/budget-reconciliation-patterns.md +54 -0
- package/skills/asset-discovery/references/license-confidence-table.md +41 -0
- package/skills/asset-fallback-strategy/EVAL.md +34 -0
- package/skills/asset-fallback-strategy/SKILL.md +248 -0
- package/skills/asset-fallback-strategy/contract.json +190 -0
- package/skills/asset-fallback-strategy/references/drop-with-caveat-rules.md +36 -0
- package/skills/asset-fallback-strategy/references/fallback-option-types.md +55 -0
- package/skills/asset-fallback-strategy/references/scoring-rubric.md +61 -0
- package/skills/asset-library-plan/EVAL.md +28 -0
- package/skills/asset-library-plan/SKILL.md +263 -0
- package/skills/asset-library-plan/contract.json +177 -0
- package/skills/asset-library-plan/references/folder-structure-rules.md +63 -0
- package/skills/asset-library-plan/references/metadata-schema.md +62 -0
- package/skills/asset-library-plan/references/naming-rules.md +51 -0
- package/skills/asset-license-checker/EVAL.md +33 -0
- package/skills/asset-license-checker/SKILL.md +245 -0
- package/skills/asset-license-checker/contract.json +172 -0
- package/skills/asset-license-checker/references/attribution-rendering-patterns.md +48 -0
- package/skills/asset-license-checker/references/common-license-mapping.md +39 -0
- package/skills/asset-license-checker/references/license-source-rules.md +38 -0
- package/skills/asset-style-check/EVAL.md +26 -0
- package/skills/asset-style-check/SKILL.md +238 -0
- package/skills/asset-style-check/contract.json +251 -0
- package/skills/asset-style-check/references/drift-classification.md +40 -0
- package/skills/asset-style-check/references/intentional-mixed-style.md +39 -0
- package/skills/asset-style-check/references/style-axes.md +46 -0
- package/skills/blender-brainstorming/EVAL.md +79 -0
- package/skills/blender-brainstorming/SKILL.md +228 -0
- package/skills/blender-brainstorming/contract.json +115 -0
- package/skills/blender-brainstorming/references/alternative-scoping-templates.md +43 -0
- package/skills/blender-brainstorming/references/clarification-patterns.md +29 -0
- package/skills/blender-brainstorming/references/intent-summary-style-guide.md +25 -0
- package/skills/blender-recipe-decomposer/EVAL.md +35 -0
- package/skills/blender-recipe-decomposer/SKILL.md +258 -0
- package/skills/blender-recipe-decomposer/contract.json +152 -0
- package/skills/blender-recipe-decomposer/references/dependency-patterns.md +53 -0
- package/skills/blender-recipe-decomposer/references/recipe-grouping-rules.md +58 -0
- package/skills/blender-recipe-decomposer/references/recipe-naming-rules.md +44 -0
- package/skills/blender-troubleshooting/EVAL.md +78 -0
- package/skills/blender-troubleshooting/SKILL.md +263 -0
- package/skills/blender-troubleshooting/contract.json +352 -0
- package/skills/blender-troubleshooting/references/common-symptom-playbooks.md +51 -0
- package/skills/blender-troubleshooting/references/divergence-routing-table.md +23 -0
- package/skills/blender-troubleshooting/references/four-phase-template.md +51 -0
- package/skills/blendops-help/EVAL.md +67 -0
- package/skills/blendops-help/SKILL.md +312 -0
- package/skills/blendops-help/contract.json +229 -0
- package/skills/blendops-help/references/lifecycle-phases.md +91 -0
- package/skills/blendops-help/references/quick-start-prompts.md +65 -0
- package/skills/blendops-help/references/routing-decision-tree.md +57 -0
- package/skills/bridge-conflicts/EVAL.md +83 -0
- package/skills/bridge-conflicts/SKILL.md +246 -0
- package/skills/bridge-conflicts/contract.json +145 -0
- package/skills/bridge-conflicts/references/bridge-state-matrix-template.md +82 -0
- package/skills/bridge-conflicts/references/conflict-playbooks.md +99 -0
- package/skills/bridge-conflicts/references/do-not-reminders.md +42 -0
- package/skills/camera-composition/EVAL.md +32 -0
- package/skills/camera-composition/SKILL.md +196 -0
- package/skills/camera-composition/contract.json +180 -0
- package/skills/camera-composition/references/camera-presets.md +30 -0
- package/skills/camera-composition/references/camera-rubric.md +24 -0
- package/skills/camera-composition/references/hero-composition-patterns.md +24 -0
- package/skills/camera-composition/references/web-layout-negative-space.md +25 -0
- package/skills/character-portrait/EVAL.md +42 -0
- package/skills/character-portrait/SKILL.md +245 -0
- package/skills/character-portrait/contract.json +205 -0
- package/skills/character-portrait/references/portrait-framing-rules.md +39 -0
- package/skills/character-portrait/references/portrait-lighting-patterns.md +50 -0
- package/skills/character-portrait/references/style-consistency-rules.md +41 -0
- package/skills/cli-appendix-job-outline/EVAL.md +26 -0
- package/skills/cli-appendix-job-outline/SKILL.md +252 -0
- package/skills/cli-appendix-job-outline/contract.json +147 -0
- package/skills/cli-appendix-job-outline/references/flag-order-reminders.md +16 -0
- package/skills/cli-appendix-job-outline/references/job-type-matrix.md +13 -0
- package/skills/cli-appendix-job-outline/references/stateless-limitations.md +12 -0
- package/skills/color-management-decision/EVAL.md +28 -0
- package/skills/color-management-decision/SKILL.md +254 -0
- package/skills/color-management-decision/contract.json +162 -0
- package/skills/color-management-decision/references/look-comparison.md +44 -0
- package/skills/color-management-decision/references/per-channel-rules.md +49 -0
- package/skills/color-management-decision/references/pipeline-mapping.md +47 -0
- package/skills/composition-quality-checker/EVAL.md +38 -0
- package/skills/composition-quality-checker/SKILL.md +260 -0
- package/skills/composition-quality-checker/contract.json +221 -0
- package/skills/composition-quality-checker/references/aspect-ratio-rules.md +37 -0
- package/skills/composition-quality-checker/references/composition-rules.md +58 -0
- package/skills/composition-quality-checker/references/headroom-leadroom-rules.md +46 -0
- package/skills/cycles-vs-eevee-decision/EVAL.md +26 -0
- package/skills/cycles-vs-eevee-decision/SKILL.md +249 -0
- package/skills/cycles-vs-eevee-decision/contract.json +142 -0
- package/skills/cycles-vs-eevee-decision/references/engine-feature-matrix.md +39 -0
- package/skills/cycles-vs-eevee-decision/references/gpu-device-rules.md +51 -0
- package/skills/cycles-vs-eevee-decision/references/samples-by-quality.md +53 -0
- package/skills/done-criteria/EVAL.md +33 -0
- package/skills/done-criteria/SKILL.md +225 -0
- package/skills/done-criteria/contract.json +199 -0
- package/skills/done-criteria/references/done-vs-perfect.md +56 -0
- package/skills/done-criteria/references/out-of-scope-patterns.md +50 -0
- package/skills/done-criteria/references/stop-condition-templates.md +39 -0
- package/skills/environment-shot/EVAL.md +44 -0
- package/skills/environment-shot/SKILL.md +237 -0
- package/skills/environment-shot/contract.json +162 -0
- package/skills/environment-shot/references/depth-layering-rules.md +49 -0
- package/skills/environment-shot/references/time-and-weather-rules.md +35 -0
- package/skills/environment-shot/references/wide-shot-camera-rules.md +51 -0
- package/skills/glb-animation-handoff/EVAL.md +39 -0
- package/skills/glb-animation-handoff/SKILL.md +271 -0
- package/skills/glb-animation-handoff/contract.json +247 -0
- package/skills/glb-animation-handoff/references/animation-types.md +36 -0
- package/skills/glb-animation-handoff/references/transition-rules.md +55 -0
- package/skills/glb-animation-handoff/references/web-stack-caveats.md +40 -0
- package/skills/glb-web-handoff/EVAL.md +33 -0
- package/skills/glb-web-handoff/SKILL.md +212 -0
- package/skills/glb-web-handoff/contract.json +171 -0
- package/skills/glb-web-handoff/references/artifact-status-language.md +26 -0
- package/skills/glb-web-handoff/references/glb-handoff-checklist.md +30 -0
- package/skills/glb-web-handoff/references/performance-caveats.md +26 -0
- package/skills/glb-web-handoff/references/threejs-r3f-handoff.md +28 -0
- package/skills/intent-to-3d-brief-writer/EVAL.md +82 -0
- package/skills/intent-to-3d-brief-writer/SKILL.md +238 -0
- package/skills/intent-to-3d-brief-writer/contract.json +195 -0
- package/skills/intent-to-3d-brief-writer/references/acceptance-criteria-patterns.md +46 -0
- package/skills/intent-to-3d-brief-writer/references/eight-slot-template.md +123 -0
- package/skills/intent-to-3d-brief-writer/references/mixed-audience-handling.md +39 -0
- package/skills/interior-scene/EVAL.md +44 -0
- package/skills/interior-scene/SKILL.md +261 -0
- package/skills/interior-scene/contract.json +277 -0
- package/skills/interior-scene/references/furniture-layout-rules.md +51 -0
- package/skills/interior-scene/references/interior-architecture-rules.md +47 -0
- package/skills/interior-scene/references/interior-camera-rules.md +47 -0
- package/skills/lighting-material-plan/EVAL.md +32 -0
- package/skills/lighting-material-plan/SKILL.md +194 -0
- package/skills/lighting-material-plan/contract.json +213 -0
- package/skills/lighting-material-plan/references/cyberpunk-lookdev.md +22 -0
- package/skills/lighting-material-plan/references/lighting-patterns.md +30 -0
- package/skills/lighting-material-plan/references/material-portability.md +25 -0
- package/skills/lighting-material-plan/references/reflective-floor-pattern.md +22 -0
- package/skills/lighting-material-plan/references/web-material-simplification.md +23 -0
- package/skills/lighting-quality-checker/EVAL.md +41 -0
- package/skills/lighting-quality-checker/SKILL.md +247 -0
- package/skills/lighting-quality-checker/contract.json +187 -0
- package/skills/lighting-quality-checker/references/hdri-balance-rules.md +48 -0
- package/skills/lighting-quality-checker/references/intensity-ranges.md +73 -0
- package/skills/lighting-quality-checker/references/shadow-softness-rules.md +38 -0
- package/skills/material-quality-checker/EVAL.md +40 -0
- package/skills/material-quality-checker/SKILL.md +261 -0
- package/skills/material-quality-checker/contract.json +244 -0
- package/skills/material-quality-checker/references/consumer-stack-rules.md +62 -0
- package/skills/material-quality-checker/references/pbr-sanity-rules.md +78 -0
- package/skills/material-quality-checker/references/texture-budget-rules.md +48 -0
- package/skills/mobile-glb-budget/EVAL.md +40 -0
- package/skills/mobile-glb-budget/SKILL.md +264 -0
- package/skills/mobile-glb-budget/contract.json +309 -0
- package/skills/mobile-glb-budget/references/budget-tiers.md +30 -0
- package/skills/mobile-glb-budget/references/degradation-plan.md +34 -0
- package/skills/mobile-glb-budget/references/violation-rules.md +43 -0
- package/skills/output-format-decision/EVAL.md +27 -0
- package/skills/output-format-decision/SKILL.md +222 -0
- package/skills/output-format-decision/contract.json +179 -0
- package/skills/output-format-decision/references/bit-depth-rules.md +56 -0
- package/skills/output-format-decision/references/compression-tradeoffs.md +62 -0
- package/skills/output-format-decision/references/format-decision-matrix.md +34 -0
- package/skills/pack-prerequisite-checker/EVAL.md +26 -0
- package/skills/pack-prerequisite-checker/SKILL.md +272 -0
- package/skills/pack-prerequisite-checker/contract.json +214 -0
- package/skills/pack-prerequisite-checker/references/blocked-start-playbook.md +21 -0
- package/skills/pack-prerequisite-checker/references/pack-readiness-template.md +38 -0
- package/skills/pack-prerequisite-checker/references/prerequisite-matrix.md +20 -0
- package/skills/path-one-host-outline/EVAL.md +26 -0
- package/skills/path-one-host-outline/SKILL.md +251 -0
- package/skills/path-one-host-outline/contract.json +167 -0
- package/skills/path-one-host-outline/references/connector-vs-manual-matrix.md +21 -0
- package/skills/path-one-host-outline/references/host-checklist-template.md +35 -0
- package/skills/path-one-host-outline/references/lab-addon-reminders.md +12 -0
- package/skills/plain-language-response/EVAL.md +33 -0
- package/skills/plain-language-response/SKILL.md +194 -0
- package/skills/plain-language-response/contract.json +242 -0
- package/skills/plain-language-response/references/caveat-language.md +25 -0
- package/skills/plain-language-response/references/plain-language-patterns.md +30 -0
- package/skills/plain-language-response/references/stakeholder-friendly-examples.md +30 -0
- package/skills/plain-language-response/references/status-summary-templates.md +50 -0
- package/skills/polycount-budget-checker/EVAL.md +40 -0
- package/skills/polycount-budget-checker/SKILL.md +251 -0
- package/skills/polycount-budget-checker/contract.json +196 -0
- package/skills/polycount-budget-checker/references/instance-counting-rules.md +39 -0
- package/skills/polycount-budget-checker/references/per-mesh-rules.md +43 -0
- package/skills/polycount-budget-checker/references/topology-hints.md +56 -0
- package/skills/pre-handoff-verification/EVAL.md +84 -0
- package/skills/pre-handoff-verification/SKILL.md +252 -0
- package/skills/pre-handoff-verification/contract.json +295 -0
- package/skills/pre-handoff-verification/references/downgrade-rules.md +39 -0
- package/skills/pre-handoff-verification/references/seven-point-checklist.md +46 -0
- package/skills/pre-handoff-verification/references/text-only-mode-handling.md +36 -0
- package/skills/preview-report/EVAL.md +39 -0
- package/skills/preview-report/SKILL.md +254 -0
- package/skills/preview-report/contract.json +141 -0
- package/skills/preview-report/references/handoff-recipients.md +41 -0
- package/skills/preview-report/references/report-schema.md +60 -0
- package/skills/preview-report/references/truth-label-rules.md +36 -0
- package/skills/product-grid-scene-planner/EVAL.md +42 -0
- package/skills/product-grid-scene-planner/SKILL.md +246 -0
- package/skills/product-grid-scene-planner/contract.json +257 -0
- package/skills/product-grid-scene-planner/references/grid-consistency-rules.md +53 -0
- package/skills/product-grid-scene-planner/references/grid-layout-rules.md +42 -0
- package/skills/product-grid-scene-planner/references/grid-output-naming-rules.md +52 -0
- package/skills/product-hero-scene-planner/EVAL.md +33 -0
- package/skills/product-hero-scene-planner/SKILL.md +227 -0
- package/skills/product-hero-scene-planner/contract.json +228 -0
- package/skills/product-hero-scene-planner/references/clarification-patterns.md +24 -0
- package/skills/product-hero-scene-planner/references/cyberpunk-shoe-example.md +28 -0
- package/skills/product-hero-scene-planner/references/product-hero-playbooks.md +22 -0
- package/skills/product-hero-scene-planner/references/scene-plan-schema.md +35 -0
- package/skills/r3f-component-plan/EVAL.md +43 -0
- package/skills/r3f-component-plan/SKILL.md +290 -0
- package/skills/r3f-component-plan/contract.json +171 -0
- package/skills/r3f-component-plan/references/component-shape-patterns.md +54 -0
- package/skills/r3f-component-plan/references/suspense-placement-rules.md +50 -0
- package/skills/r3f-component-plan/references/usegltf-caching-rules.md +53 -0
- package/skills/recipe-fit-assessor/EVAL.md +28 -0
- package/skills/recipe-fit-assessor/SKILL.md +266 -0
- package/skills/recipe-fit-assessor/contract.json +220 -0
- package/skills/recipe-fit-assessor/references/recipe-catalog.md +30 -0
- package/skills/recipe-fit-assessor/references/scope-gap-rules.md +27 -0
- package/skills/recipe-fit-assessor/references/workflow-recommendation-template.md +34 -0
- package/skills/render-export-evidence/EVAL.md +86 -0
- package/skills/render-export-evidence/SKILL.md +339 -0
- package/skills/render-export-evidence/contract.json +206 -0
- package/skills/render-export-evidence/references/attempted-vs-failed-rubric.md +75 -0
- package/skills/render-export-evidence/references/evidence-record-templates.md +143 -0
- package/skills/render-export-evidence/references/truth-label-decision-tree.md +57 -0
- package/skills/resolution-aspect-decision/EVAL.md +26 -0
- package/skills/resolution-aspect-decision/SKILL.md +246 -0
- package/skills/resolution-aspect-decision/contract.json +160 -0
- package/skills/resolution-aspect-decision/references/aspect-defaults.md +41 -0
- package/skills/resolution-aspect-decision/references/print-vs-screen-rules.md +58 -0
- package/skills/resolution-aspect-decision/references/resolution-defaults.md +64 -0
- package/skills/runtime-attempt-report/EVAL.md +26 -0
- package/skills/runtime-attempt-report/SKILL.md +268 -0
- package/skills/runtime-attempt-report/contract.json +176 -0
- package/skills/runtime-attempt-report/references/attempt-record-template.md +49 -0
- package/skills/runtime-attempt-report/references/triage-next-steps.md +15 -0
- package/skills/runtime-attempt-report/references/truth-label-blocks.md +27 -0
- package/skills/runtime-path-picker/EVAL.md +26 -0
- package/skills/runtime-path-picker/SKILL.md +268 -0
- package/skills/runtime-path-picker/contract.json +191 -0
- package/skills/runtime-path-picker/references/anti-patterns.md +14 -0
- package/skills/runtime-path-picker/references/decision-tree.md +29 -0
- package/skills/runtime-path-picker/references/path-constraints-table.md +18 -0
- package/skills/runtime-readiness/EVAL.md +33 -0
- package/skills/runtime-readiness/SKILL.md +218 -0
- package/skills/runtime-readiness/contract.json +190 -0
- package/skills/runtime-readiness/references/blocker-report-template.md +28 -0
- package/skills/runtime-readiness/references/evidence-examples.md +23 -0
- package/skills/runtime-readiness/references/readiness-matrix.md +46 -0
- package/skills/runtime-setup/EVAL.md +33 -0
- package/skills/runtime-setup/SKILL.md +209 -0
- package/skills/runtime-setup/contract.json +171 -0
- package/skills/runtime-setup/references/runtime-option-decision-tree.md +28 -0
- package/skills/runtime-setup/references/setup-summary-template.md +33 -0
- package/skills/runtime-setup/references/source-confidence-labels.md +23 -0
- package/skills/scene-readiness/EVAL.md +33 -0
- package/skills/scene-readiness/SKILL.md +195 -0
- package/skills/scene-readiness/contract.json +198 -0
- package/skills/scene-readiness/references/blocker-catalog.md +24 -0
- package/skills/scene-readiness/references/not-run-handling.md +22 -0
- package/skills/scene-readiness/references/quality-rubric.md +23 -0
- package/skills/scene-readiness/references/verdict-language.md +22 -0
- package/skills/scope-guard/EVAL.md +33 -0
- package/skills/scope-guard/SKILL.md +222 -0
- package/skills/scope-guard/contract.json +171 -0
- package/skills/scope-guard/references/options-language-template.md +51 -0
- package/skills/scope-guard/references/recurring-creep-patterns.md +55 -0
- package/skills/scope-guard/references/scope-addition-classification.md +55 -0
- package/skills/stage-gates/EVAL.md +40 -0
- package/skills/stage-gates/SKILL.md +257 -0
- package/skills/stage-gates/contract.json +490 -0
- package/skills/stage-gates/references/failed-gate-handling.md +42 -0
- package/skills/stage-gates/references/gate-template.md +46 -0
- package/skills/stage-gates/references/stage-decomposition-patterns.md +55 -0
- package/skills/workflow-stage-router/EVAL.md +25 -0
- package/skills/workflow-stage-router/SKILL.md +259 -0
- package/skills/workflow-stage-router/contract.json +150 -0
- package/skills/workflow-stage-router/references/milestone-model.md +20 -0
- package/skills/workflow-stage-router/references/routing-decision-tree.md +32 -0
- package/skills/workflow-stage-router/references/stage-handoff-template.md +37 -0
- package/skills.sh.json +102 -0
|
@@ -0,0 +1,246 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: product-grid-scene-planner
|
|
3
|
+
description: Plan a multi-product grid scene (e-commerce, catalog, comparison) before any modeling or render attempt; consistent lighting, camera, and grid spacing.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# product-grid-scene-planner
|
|
7
|
+
|
|
8
|
+
## Purpose
|
|
9
|
+
Translate a multi-product grid intent (e-commerce / catalog / comparison) into a structured scene plan. Distinct from `product-hero-scene-planner` (single product, hero) and `interior-scene` (room scene).
|
|
10
|
+
|
|
11
|
+
## Quick start
|
|
12
|
+
- pin product list (count + per-product type and relative real-world size)
|
|
13
|
+
- normalize product scale across cells (or split incompatible scales into separate grids)
|
|
14
|
+
- pin grid layout (rows × cols + spacing)
|
|
15
|
+
- pin per-cell consistency level (strict / loose for camera angle, lighting, background)
|
|
16
|
+
- pin shared material / lighting / background palette
|
|
17
|
+
- record assumptions register and hand off to asset discovery, format decision, and quality checkers
|
|
18
|
+
|
|
19
|
+
## When to use
|
|
20
|
+
- intent is multi-product display (4+ products in same scene)
|
|
21
|
+
- e-commerce catalog grid
|
|
22
|
+
- product comparison view
|
|
23
|
+
- showroom-style grid
|
|
24
|
+
|
|
25
|
+
## When not to use
|
|
26
|
+
<!-- blendops:generated:start exclusions -->
|
|
27
|
+
- single product hero → use `../product-hero-scene-planner/SKILL.md` (use product-hero-scene-planner)
|
|
28
|
+
- character portrait → use `../character-portrait/SKILL.md` (use character-portrait)
|
|
29
|
+
- outdoor environment scene → use `../environment-shot/SKILL.md` (use environment-shot)
|
|
30
|
+
- interior room scene → use `../interior-scene/SKILL.md` (use interior-scene)
|
|
31
|
+
<!-- blendops:generated:end exclusions -->
|
|
32
|
+
|
|
33
|
+
## Trigger phrases
|
|
34
|
+
<!-- blendops:generated:start triggers -->
|
|
35
|
+
- "grid of products"
|
|
36
|
+
- "lineup of"
|
|
37
|
+
- "catalog showing N items"
|
|
38
|
+
- "comparison render"
|
|
39
|
+
<!-- blendops:generated:end triggers -->
|
|
40
|
+
|
|
41
|
+
## Prerequisites / readiness
|
|
42
|
+
- product list known (count + per-product description)
|
|
43
|
+
- consistency expectations known (identical lighting? identical camera? identical scale?)
|
|
44
|
+
|
|
45
|
+
## Input schema
|
|
46
|
+
|
|
47
|
+
### Required inputs
|
|
48
|
+
|
|
49
|
+
| Input | Why it is required |
|
|
50
|
+
|---|---|
|
|
51
|
+
| Product list + relative sizes | Determines grid size, asset scope, and scale normalization |
|
|
52
|
+
| Grid layout (rows × cols + spacing) | Drives overall and per-cell composition |
|
|
53
|
+
| Aspect ratio | Governs framing and cell proportions |
|
|
54
|
+
| Consistency level (strict / loose) | Determines per-cell camera, lighting, and background rules |
|
|
55
|
+
|
|
56
|
+
### Optional inputs
|
|
57
|
+
|
|
58
|
+
| Input | Use |
|
|
59
|
+
|---|---|
|
|
60
|
+
| Brand palette | Shared material + background consistency |
|
|
61
|
+
| Per-product variants (color / SKU) | Adds variant rows and informs `output-format-decision` |
|
|
62
|
+
| Reference catalog images | Calibrates visual style and spacing |
|
|
63
|
+
|
|
64
|
+
### Assumptions to confirm
|
|
65
|
+
- Scale normalization method is agreed (true relative scale vs. visual bounding-box normalization).
|
|
66
|
+
- Lighting is shared across cells (not separate per-cell lighting setups).
|
|
67
|
+
- Camera angle is consistent (same angle, distance, and lens feel) across cells unless variation is explicitly requested.
|
|
68
|
+
|
|
69
|
+
## Output schema
|
|
70
|
+
|
|
71
|
+
### Primary output
|
|
72
|
+
A structured product-grid plan: Product list, Scale normalization rule (normalized or split), Grid layout (rows × cols + spacing), Consistency level (strict / loose), Per-cell composition and camera rules, Shared lighting plan, Shared background and palette, Aspect + framing, and Assumptions register.
|
|
73
|
+
|
|
74
|
+
### Secondary output
|
|
75
|
+
- per-product asset rows flagged for `asset-discovery`
|
|
76
|
+
- variant / SKU file output notes routed to `output-format-decision`
|
|
77
|
+
- downstream validation and sign-off handoff list
|
|
78
|
+
|
|
79
|
+
### Evidence / caveat output
|
|
80
|
+
|
|
81
|
+
```txt
|
|
82
|
+
Runtime status: Not Run | Attempted | Produced | Verified | Failed
|
|
83
|
+
Artifact status: Not Produced | Produced | Verified | Failed
|
|
84
|
+
Evidence used: <links, paths, logs, or "none">
|
|
85
|
+
Limitations: <known gaps>
|
|
86
|
+
```
|
|
87
|
+
|
|
88
|
+
## Required laws
|
|
89
|
+
- `../../laws/evidence-before-done.md`
|
|
90
|
+
- `../../laws/non-blender-user-language.md`
|
|
91
|
+
- `../../laws/no-arbitrary-python-interface.md`
|
|
92
|
+
- `../../laws/official-runtime-only.md`
|
|
93
|
+
|
|
94
|
+
## Official runtime boundary
|
|
95
|
+
|
|
96
|
+
Planning-only skill — does not run Blender, model, source assets, or render. Runtime status must remain `Not Run` and Artifact status must remain `Not Produced` (truth states are downgrade-only, never upgrade). Hand off asset needs to `asset-discovery`, file output rules to `output-format-decision`, and validation to quality checkers.
|
|
97
|
+
|
|
98
|
+
## Operating procedure
|
|
99
|
+
1. Read product list from user or `intent-to-3d-brief-writer`; pin count, per-product description, and relative sizes.
|
|
100
|
+
2. Normalize scale across differently-sized products (or split incompatible items into separate grid plans).
|
|
101
|
+
3. Pin grid layout (rows × cols + spacing) per `references/grid-layout-rules.md`.
|
|
102
|
+
4. Decide consistency level (strict / loose).
|
|
103
|
+
5. Plan shared palette, shared lighting (one setup applied uniformly), and shared background.
|
|
104
|
+
6. Plan per-cell camera + framing (including caption/label space).
|
|
105
|
+
7. Define per-product asset rows and document the assumptions register.
|
|
106
|
+
8. Hand off to `asset-discovery`, `output-format-decision` (if variant/SKU file outputs apply), `composition-quality-checker`, `lighting-quality-checker`, `material-quality-checker`, `scene-readiness`, `acceptance-criteria-builder`, and `done-criteria`.
|
|
107
|
+
|
|
108
|
+
## Decision tree
|
|
109
|
+
|
|
110
|
+
```txt
|
|
111
|
+
Products at very different scales (lipstick + sofa) in same grid?
|
|
112
|
+
→ Fail if unaddressed; normalize to a clear visual bounding box or split into separate scenes
|
|
113
|
+
Different lighting per cell requested?
|
|
114
|
+
→ Warn; usually erodes catalog uniformity
|
|
115
|
+
20+ products in single render?
|
|
116
|
+
→ Warn; recommend splitting into multiple grid plans
|
|
117
|
+
Brand palette or intent unclear?
|
|
118
|
+
→ Hand off to intent-to-3d-brief-writer
|
|
119
|
+
Variant / SKU file output formats needed?
|
|
120
|
+
→ Hand off file output rules to output-format-decision
|
|
121
|
+
```
|
|
122
|
+
|
|
123
|
+
## Playbooks
|
|
124
|
+
|
|
125
|
+
### Playbook A: 2×2 e-commerce hero grid (16:9)
|
|
126
|
+
4 products, identical 35mm lens, identical 3-point lighting, neutral seamless background, products centered in cells, equal spacing.
|
|
127
|
+
|
|
128
|
+
### Playbook B: 3×3 catalog page (1:1)
|
|
129
|
+
9 products, square cells, identical lighting, brand-color background, consistent product orientation, lower-third caption space per cell.
|
|
130
|
+
|
|
131
|
+
### Playbook C: 1×4 comparison strip (2.39:1)
|
|
132
|
+
4 product variants of same SKU, side-by-side, identical lighting + camera, label space below each.
|
|
133
|
+
|
|
134
|
+
## Mode handling
|
|
135
|
+
|
|
136
|
+
### Text-only mode
|
|
137
|
+
|
|
138
|
+
Emit the complete grid plan and assumptions register. Runtime stays `Not Run`; Artifacts stay `Not Produced`.
|
|
139
|
+
|
|
140
|
+
### Runtime-ready mode
|
|
141
|
+
|
|
142
|
+
Emit the complete grid plan, assumptions register, and downstream handoff targets. Do not execute Blender; Runtime stays `Not Run` and Artifacts stay `Not Produced`.
|
|
143
|
+
|
|
144
|
+
### Blocked runtime mode
|
|
145
|
+
|
|
146
|
+
Emit the complete grid plan and assumptions register; flag unconfirmed inputs under Limitations. Runtime stays `Not Run` and Artifacts stay `Not Produced`.
|
|
147
|
+
|
|
148
|
+
## Validation checklist
|
|
149
|
+
- [ ] Product list complete with count and relative sizes
|
|
150
|
+
- [ ] Scale normalized across products (or explicitly split into separate grids)
|
|
151
|
+
- [ ] Grid layout (rows × cols + spacing) explicit
|
|
152
|
+
- [ ] Consistency level (strict / loose) stated
|
|
153
|
+
- [ ] Shared palette, lighting plan, and background present
|
|
154
|
+
- [ ] Per-cell camera and framing consistent (or variation explicit)
|
|
155
|
+
- [ ] Assumptions register included
|
|
156
|
+
- [ ] Asset rows flagged for `asset-discovery`
|
|
157
|
+
- [ ] Validation and sign-off handoffs named
|
|
158
|
+
|
|
159
|
+
## Pass / Warn / Fail rubric
|
|
160
|
+
|
|
161
|
+
| Verdict | Criteria |
|
|
162
|
+
| --- | --- |
|
|
163
|
+
| Pass | All sections complete + scale normalized (or split) + consistency level stated + shared lighting/palette + assumptions register + asset list + truth states locked to `Not Run` / `Not Produced`. |
|
|
164
|
+
| Warn | Minor cell variance (e.g., per-cell angle or lighting tweak) without clear justification, or 20+ items crammed into one grid. |
|
|
165
|
+
| Fail | Mixed-scale products without normalization or split, missing shared lighting/camera consistency, missing consistency level, missing assumptions register, or upgraded truth states. |
|
|
166
|
+
|
|
167
|
+
## Failure handling
|
|
168
|
+
- Mixed product scales → require normalized visual scale or split into separate grid plans.
|
|
169
|
+
- 20+ products → suggest splitting into multiple grid plans.
|
|
170
|
+
- Missing brand palette or unclear intent → hand off to `intent-to-3d-brief-writer`.
|
|
171
|
+
|
|
172
|
+
## Troubleshooting
|
|
173
|
+
|
|
174
|
+
| Problem | Response |
|
|
175
|
+
| --- | --- |
|
|
176
|
+
| Products appear mismatched in size across cells | Specify bounding-box scale normalization and identical per-cell camera distance in the plan. |
|
|
177
|
+
| One cell stands out visually | Enforce strict consistency level for shared lighting and shared background palette. |
|
|
178
|
+
| Caption space cramped | Increase planned grid spacing or reduce product count per grid. |
|
|
179
|
+
| Background distracts from products | Plan a neutral solid or subtle gradient background that contrasts cleanly with the shared palette. |
|
|
180
|
+
|
|
181
|
+
## Best practices
|
|
182
|
+
- Lock one camera angle and one shared lighting plan; apply identically across all cells.
|
|
183
|
+
- Normalize product scale (or split grids) before finalizing rows and columns.
|
|
184
|
+
- Reserve consistent caption or label space per cell for catalog layout.
|
|
185
|
+
- Keep the shared background tone consistent so material differences across SKUs remain accurate.
|
|
186
|
+
|
|
187
|
+
## Good examples
|
|
188
|
+
- "Products: 4 sneaker variants (identical real-world scale, normalized to equal cell bounding boxes). Grid: 2×2, even spacing. Shared lighting: soft studio three-point setup, even illumination. Shared palette/background: neutral light-gray seamless backdrop. Per-cell camera: standard eye-level framing, identical distance and orientation. Caption space lower 15% reserved. Assumptions register: identical footwear dimensions; no props; single still catalog output. Runtime status: Not Run. Artifact status: Not Produced."
|
|
189
|
+
|
|
190
|
+
## Bad examples
|
|
191
|
+
- "Show 4 products in a grid." — no lighting, layout, scale.
|
|
192
|
+
|
|
193
|
+
## User-facing response template
|
|
194
|
+
|
|
195
|
+
```txt
|
|
196
|
+
Product list: <count + per-product list>
|
|
197
|
+
Scale normalization: <normalized bounding box / true relative scale / split into separate grids>
|
|
198
|
+
Grid layout: <rows × cols> | spacing <value> | aspect <ratio>
|
|
199
|
+
Consistency: <strict / loose>
|
|
200
|
+
Shared palette: <colors + surface tones>
|
|
201
|
+
Shared lighting: <plain-language lighting plan>
|
|
202
|
+
Shared background: <type + tone>
|
|
203
|
+
Per-cell camera: <angle> | <distance> | <framing>
|
|
204
|
+
Caption / label space: <location + proportion>
|
|
205
|
+
Mood + style: <line>
|
|
206
|
+
Assumptions register: <explicit assumptions to confirm>
|
|
207
|
+
|
|
208
|
+
Assets to discover: <per-product rows for asset-discovery>
|
|
209
|
+
Runtime status: Not Run
|
|
210
|
+
Artifact status: Not Produced
|
|
211
|
+
Evidence used: <links, paths, logs, or "none">
|
|
212
|
+
Limitations: <known gaps>
|
|
213
|
+
Next: asset-discovery | output-format-decision | composition-quality-checker | lighting-quality-checker | material-quality-checker | scene-readiness | acceptance-criteria-builder | done-criteria
|
|
214
|
+
```
|
|
215
|
+
|
|
216
|
+
## Anti-patterns
|
|
217
|
+
- Per-cell separate lighting setups (breaks uniformity).
|
|
218
|
+
- Mixed-scale products without normalization.
|
|
219
|
+
- Background clashing with products.
|
|
220
|
+
- Skipping caption space when downstream layout needs it.
|
|
221
|
+
|
|
222
|
+
## Cross-skill handoff
|
|
223
|
+
<!-- blendops:generated:start handoffs -->
|
|
224
|
+
- [upstream_reference] Upstream brief → `../intent-to-3d-brief-writer/SKILL.md`
|
|
225
|
+
- [upstream_reference] Single hero product alternative → `../product-hero-scene-planner/SKILL.md`
|
|
226
|
+
- [upstream_reference] Asset discovery → `../asset-discovery/SKILL.md`
|
|
227
|
+
- [progression] Variant / SKU file output format → `../output-format-decision/SKILL.md`
|
|
228
|
+
- [progression] Composition validation → `../composition-quality-checker/SKILL.md`
|
|
229
|
+
- [progression] Lighting validation → `../lighting-quality-checker/SKILL.md`
|
|
230
|
+
- [progression] Material validation → `../material-quality-checker/SKILL.md`
|
|
231
|
+
- [progression] Overall scene quality validation → `../scene-readiness/SKILL.md`
|
|
232
|
+
- [upstream_reference] Catalog sign-off & stop conditions (acceptance-criteria-builder) → `../acceptance-criteria-builder/SKILL.md`
|
|
233
|
+
- [upstream_reference] Catalog sign-off & stop conditions (done-criteria) → `../done-criteria/SKILL.md`
|
|
234
|
+
<!-- blendops:generated:end handoffs -->
|
|
235
|
+
|
|
236
|
+
## Non-goals
|
|
237
|
+
- Model the products.
|
|
238
|
+
- Source the products.
|
|
239
|
+
- Render.
|
|
240
|
+
- Run Blender.
|
|
241
|
+
|
|
242
|
+
## References
|
|
243
|
+
- `references/grid-layout-rules.md`
|
|
244
|
+
- `references/grid-consistency-rules.md`
|
|
245
|
+
- `references/grid-output-naming-rules.md`
|
|
246
|
+
- `../../docs/skill-system.md`
|
|
@@ -0,0 +1,257 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$schema": "../../schemas/skill-contract.schema.json",
|
|
3
|
+
"id": "product-grid-scene-planner",
|
|
4
|
+
"version": "1.0.0",
|
|
5
|
+
"category": "scene-planners",
|
|
6
|
+
"role": "multi-product-catalog-grid-architect",
|
|
7
|
+
"purpose": "Plan a multi-product grid scene (e-commerce, catalog, comparison) before any modeling or render attempt; consistent lighting, camera, and grid spacing.",
|
|
8
|
+
"capabilityTier": "L0",
|
|
9
|
+
"triggers": [
|
|
10
|
+
"grid of products",
|
|
11
|
+
"lineup of",
|
|
12
|
+
"catalog showing N items",
|
|
13
|
+
"comparison render"
|
|
14
|
+
],
|
|
15
|
+
"exclusions": [
|
|
16
|
+
{
|
|
17
|
+
"condition": "single product hero",
|
|
18
|
+
"delegateTo": "product-hero-scene-planner",
|
|
19
|
+
"reason": "use product-hero-scene-planner"
|
|
20
|
+
},
|
|
21
|
+
{
|
|
22
|
+
"condition": "character portrait",
|
|
23
|
+
"delegateTo": "character-portrait",
|
|
24
|
+
"reason": "use character-portrait"
|
|
25
|
+
},
|
|
26
|
+
{
|
|
27
|
+
"condition": "outdoor environment scene",
|
|
28
|
+
"delegateTo": "environment-shot",
|
|
29
|
+
"reason": "use environment-shot"
|
|
30
|
+
},
|
|
31
|
+
{
|
|
32
|
+
"condition": "interior room scene",
|
|
33
|
+
"delegateTo": "interior-scene",
|
|
34
|
+
"reason": "use interior-scene"
|
|
35
|
+
}
|
|
36
|
+
],
|
|
37
|
+
"inputs": {
|
|
38
|
+
"required": [
|
|
39
|
+
{
|
|
40
|
+
"name": "locked_3d_brief",
|
|
41
|
+
"type": "object",
|
|
42
|
+
"description": "Locked 3D brief specifying product lineup count, grid rows/columns, and comparison goal"
|
|
43
|
+
},
|
|
44
|
+
{
|
|
45
|
+
"name": "product_variant_inventory",
|
|
46
|
+
"type": "array",
|
|
47
|
+
"description": "List of product SKUs or variants with real-world dimensions for relative scale normalization"
|
|
48
|
+
}
|
|
49
|
+
],
|
|
50
|
+
"optional": [
|
|
51
|
+
{
|
|
52
|
+
"name": "catalog_aspect_and_margin_rules",
|
|
53
|
+
"type": "object",
|
|
54
|
+
"description": "Optional e-commerce card aspect ratio and uniform padding requirements"
|
|
55
|
+
}
|
|
56
|
+
]
|
|
57
|
+
},
|
|
58
|
+
"outputs": {
|
|
59
|
+
"primary": [
|
|
60
|
+
"multi_product_grid_layout_matrix",
|
|
61
|
+
"scale_normalization_and_spacing_spec",
|
|
62
|
+
"uniform_catalog_camera_and_lighting_hooks"
|
|
63
|
+
],
|
|
64
|
+
"truthStatePolicy": {
|
|
65
|
+
"runtimeDefault": "Not Run",
|
|
66
|
+
"artifactDefault": "Not Produced",
|
|
67
|
+
"mutationRule": "downgrade_only"
|
|
68
|
+
}
|
|
69
|
+
},
|
|
70
|
+
"handoffs": [
|
|
71
|
+
{
|
|
72
|
+
"target": "intent-to-3d-brief-writer",
|
|
73
|
+
"type": "upstream_reference",
|
|
74
|
+
"label": "Upstream brief",
|
|
75
|
+
"when": {
|
|
76
|
+
"all": [
|
|
77
|
+
{
|
|
78
|
+
"field": "goal.clarity",
|
|
79
|
+
"operator": "equals",
|
|
80
|
+
"value": "clear"
|
|
81
|
+
},
|
|
82
|
+
{
|
|
83
|
+
"field": "brief.locked",
|
|
84
|
+
"operator": "equals",
|
|
85
|
+
"value": false
|
|
86
|
+
}
|
|
87
|
+
]
|
|
88
|
+
}
|
|
89
|
+
},
|
|
90
|
+
{
|
|
91
|
+
"target": "product-hero-scene-planner",
|
|
92
|
+
"type": "upstream_reference",
|
|
93
|
+
"label": "Single hero product alternative",
|
|
94
|
+
"when": {
|
|
95
|
+
"all": [
|
|
96
|
+
{
|
|
97
|
+
"field": "brief.locked",
|
|
98
|
+
"operator": "equals",
|
|
99
|
+
"value": true
|
|
100
|
+
},
|
|
101
|
+
{
|
|
102
|
+
"field": "recipe.domain",
|
|
103
|
+
"operator": "equals",
|
|
104
|
+
"value": "product_hero"
|
|
105
|
+
}
|
|
106
|
+
]
|
|
107
|
+
}
|
|
108
|
+
},
|
|
109
|
+
{
|
|
110
|
+
"target": "asset-discovery",
|
|
111
|
+
"type": "upstream_reference",
|
|
112
|
+
"label": "Asset discovery",
|
|
113
|
+
"when": {
|
|
114
|
+
"all": [
|
|
115
|
+
{
|
|
116
|
+
"field": "brief.locked",
|
|
117
|
+
"operator": "equals",
|
|
118
|
+
"value": true
|
|
119
|
+
},
|
|
120
|
+
{
|
|
121
|
+
"field": "assets.discoveryComplete",
|
|
122
|
+
"operator": "equals",
|
|
123
|
+
"value": false
|
|
124
|
+
}
|
|
125
|
+
]
|
|
126
|
+
}
|
|
127
|
+
},
|
|
128
|
+
{
|
|
129
|
+
"target": "output-format-decision",
|
|
130
|
+
"type": "progression",
|
|
131
|
+
"label": "Variant / SKU file output format",
|
|
132
|
+
"when": {
|
|
133
|
+
"all": [
|
|
134
|
+
{
|
|
135
|
+
"field": "decision.formatLocked",
|
|
136
|
+
"operator": "equals",
|
|
137
|
+
"value": false
|
|
138
|
+
}
|
|
139
|
+
]
|
|
140
|
+
}
|
|
141
|
+
},
|
|
142
|
+
{
|
|
143
|
+
"target": "composition-quality-checker",
|
|
144
|
+
"type": "progression",
|
|
145
|
+
"label": "Composition validation",
|
|
146
|
+
"when": {
|
|
147
|
+
"all": [
|
|
148
|
+
{
|
|
149
|
+
"field": "quality.domain",
|
|
150
|
+
"operator": "equals",
|
|
151
|
+
"value": "composition"
|
|
152
|
+
},
|
|
153
|
+
{
|
|
154
|
+
"field": "quality.verdict",
|
|
155
|
+
"operator": "equals",
|
|
156
|
+
"value": "not_run"
|
|
157
|
+
}
|
|
158
|
+
]
|
|
159
|
+
}
|
|
160
|
+
},
|
|
161
|
+
{
|
|
162
|
+
"target": "lighting-quality-checker",
|
|
163
|
+
"type": "progression",
|
|
164
|
+
"label": "Lighting validation",
|
|
165
|
+
"when": {
|
|
166
|
+
"all": [
|
|
167
|
+
{
|
|
168
|
+
"field": "quality.domain",
|
|
169
|
+
"operator": "equals",
|
|
170
|
+
"value": "lighting"
|
|
171
|
+
},
|
|
172
|
+
{
|
|
173
|
+
"field": "quality.verdict",
|
|
174
|
+
"operator": "equals",
|
|
175
|
+
"value": "not_run"
|
|
176
|
+
}
|
|
177
|
+
]
|
|
178
|
+
}
|
|
179
|
+
},
|
|
180
|
+
{
|
|
181
|
+
"target": "material-quality-checker",
|
|
182
|
+
"type": "progression",
|
|
183
|
+
"label": "Material validation",
|
|
184
|
+
"when": {
|
|
185
|
+
"all": [
|
|
186
|
+
{
|
|
187
|
+
"field": "quality.domain",
|
|
188
|
+
"operator": "equals",
|
|
189
|
+
"value": "material"
|
|
190
|
+
},
|
|
191
|
+
{
|
|
192
|
+
"field": "quality.verdict",
|
|
193
|
+
"operator": "equals",
|
|
194
|
+
"value": "not_run"
|
|
195
|
+
}
|
|
196
|
+
]
|
|
197
|
+
}
|
|
198
|
+
},
|
|
199
|
+
{
|
|
200
|
+
"target": "scene-readiness",
|
|
201
|
+
"type": "progression",
|
|
202
|
+
"label": "Overall scene quality validation",
|
|
203
|
+
"when": {
|
|
204
|
+
"all": [
|
|
205
|
+
{
|
|
206
|
+
"field": "quality.domain",
|
|
207
|
+
"operator": "equals",
|
|
208
|
+
"value": "holistic"
|
|
209
|
+
},
|
|
210
|
+
{
|
|
211
|
+
"field": "stage.current",
|
|
212
|
+
"operator": "equals",
|
|
213
|
+
"value": "quality_validation"
|
|
214
|
+
}
|
|
215
|
+
]
|
|
216
|
+
}
|
|
217
|
+
},
|
|
218
|
+
{
|
|
219
|
+
"target": "acceptance-criteria-builder",
|
|
220
|
+
"type": "upstream_reference",
|
|
221
|
+
"label": "Catalog sign-off & stop conditions (acceptance-criteria-builder)",
|
|
222
|
+
"when": {
|
|
223
|
+
"all": [
|
|
224
|
+
{
|
|
225
|
+
"field": "brief.locked",
|
|
226
|
+
"operator": "equals",
|
|
227
|
+
"value": true
|
|
228
|
+
},
|
|
229
|
+
{
|
|
230
|
+
"field": "stage.current",
|
|
231
|
+
"operator": "equals",
|
|
232
|
+
"value": "acceptance_criteria"
|
|
233
|
+
}
|
|
234
|
+
]
|
|
235
|
+
}
|
|
236
|
+
},
|
|
237
|
+
{
|
|
238
|
+
"target": "done-criteria",
|
|
239
|
+
"type": "upstream_reference",
|
|
240
|
+
"label": "Catalog sign-off & stop conditions (done-criteria)",
|
|
241
|
+
"when": {
|
|
242
|
+
"all": [
|
|
243
|
+
{
|
|
244
|
+
"field": "brief.locked",
|
|
245
|
+
"operator": "equals",
|
|
246
|
+
"value": true
|
|
247
|
+
},
|
|
248
|
+
{
|
|
249
|
+
"field": "stage.current",
|
|
250
|
+
"operator": "equals",
|
|
251
|
+
"value": "stop_condition"
|
|
252
|
+
}
|
|
253
|
+
]
|
|
254
|
+
}
|
|
255
|
+
}
|
|
256
|
+
]
|
|
257
|
+
}
|
|
@@ -0,0 +1,53 @@
|
|
|
1
|
+
# Grid consistency rules
|
|
2
|
+
|
|
3
|
+
## What to keep identical across cells
|
|
4
|
+
|
|
5
|
+
- Camera focal length
|
|
6
|
+
- Camera distance to product
|
|
7
|
+
- Camera angle (yaw / pitch / roll)
|
|
8
|
+
- Lighting rig (key + fill + rim positions and strengths)
|
|
9
|
+
- Background color / material
|
|
10
|
+
- Material color space + render settings
|
|
11
|
+
- Render engine + samples
|
|
12
|
+
|
|
13
|
+
## What can vary across cells
|
|
14
|
+
|
|
15
|
+
- Product (the obvious one)
|
|
16
|
+
- Per-product material color / variant (if intentional)
|
|
17
|
+
- Minor scale variation if products are inherently different sizes (handle by camera distance, not by cell variation)
|
|
18
|
+
|
|
19
|
+
## What must NOT vary
|
|
20
|
+
|
|
21
|
+
- Light direction relative to camera
|
|
22
|
+
- Background tone
|
|
23
|
+
- Color management settings
|
|
24
|
+
- Render samples / quality
|
|
25
|
+
|
|
26
|
+
## Strict vs loose consistency
|
|
27
|
+
|
|
28
|
+
| Mode | Use case |
|
|
29
|
+
|---|---|
|
|
30
|
+
| Strict | E-commerce / catalog (everything identical) |
|
|
31
|
+
| Loose | Editorial spread (minor variation OK; flag explicitly) |
|
|
32
|
+
|
|
33
|
+
## How to verify
|
|
34
|
+
|
|
35
|
+
After render, inspect each cell at full resolution side-by-side. Differences in:
|
|
36
|
+
- product color → likely material variant or color management mismatch.
|
|
37
|
+
- shadow direction → lighting drift.
|
|
38
|
+
- background tone → background drift.
|
|
39
|
+
- product silhouette → camera drift.
|
|
40
|
+
|
|
41
|
+
Each of these indicates a consistency failure.
|
|
42
|
+
|
|
43
|
+
## Single-render vs separate-renders
|
|
44
|
+
|
|
45
|
+
| Approach | Pros | Cons |
|
|
46
|
+
|---|---|---|
|
|
47
|
+
| Single render of whole grid | Guaranteed consistency | High memory if many products |
|
|
48
|
+
| Separate render per product, composited | Lower memory; per-product re-render easy | Risk of inconsistency between renders |
|
|
49
|
+
|
|
50
|
+
Recommend single render unless memory forces split.
|
|
51
|
+
|
|
52
|
+
## Related skill
|
|
53
|
+
`../SKILL.md`
|
|
@@ -0,0 +1,42 @@
|
|
|
1
|
+
# Grid layout rules
|
|
2
|
+
|
|
3
|
+
## Standard layouts
|
|
4
|
+
|
|
5
|
+
| Layout | Use case |
|
|
6
|
+
|---|---|
|
|
7
|
+
| 1×N (strip) | Comparison / variant lineup |
|
|
8
|
+
| 2×N (rows of 2) | E-commerce hero |
|
|
9
|
+
| 3×N (rows of 3) | Catalog page |
|
|
10
|
+
| 4×N (rows of 4) | Dense catalog |
|
|
11
|
+
| Square (N×N) | Social / editorial |
|
|
12
|
+
|
|
13
|
+
## Aspect-friendly layouts
|
|
14
|
+
|
|
15
|
+
| Aspect | Recommended grids |
|
|
16
|
+
|---|---|
|
|
17
|
+
| 16:9 | 1×4, 2×3, 2×4 |
|
|
18
|
+
| 1:1 | 2×2, 3×3, 4×4 |
|
|
19
|
+
| 9:16 | 4×1, 6×1, 3×2 |
|
|
20
|
+
| 2.39:1 | 1×4, 1×5, 1×6 |
|
|
21
|
+
|
|
22
|
+
## Spacing
|
|
23
|
+
|
|
24
|
+
- 0.3–0.5m between products at world scale (for medium products).
|
|
25
|
+
- Equal spacing both axes; do not vary horizontal vs vertical without intent.
|
|
26
|
+
- Avoid spacing < 0.1m → products read as overlapping.
|
|
27
|
+
|
|
28
|
+
## Cell size consistency
|
|
29
|
+
|
|
30
|
+
- Each cell must have the same world-space dimensions.
|
|
31
|
+
- Each product centered in its cell.
|
|
32
|
+
- Different product silhouettes must still fit; size cell to largest product silhouette.
|
|
33
|
+
|
|
34
|
+
## Common failures
|
|
35
|
+
|
|
36
|
+
- Variable spacing → reads as misaligned.
|
|
37
|
+
- Cells different sizes → reads as catalog error.
|
|
38
|
+
- Products not centered in cells → grid feels broken.
|
|
39
|
+
- Too many products in one render (> 9) → consider multi-page.
|
|
40
|
+
|
|
41
|
+
## Related skill
|
|
42
|
+
`../SKILL.md`
|
|
@@ -0,0 +1,52 @@
|
|
|
1
|
+
# Grid output naming + export rules
|
|
2
|
+
|
|
3
|
+
## File naming convention
|
|
4
|
+
|
|
5
|
+
For multi-product grids, use a consistent name pattern:
|
|
6
|
+
|
|
7
|
+
```
|
|
8
|
+
<product-line>-grid-<NxN>-<aspect>-<YYYY-MM-DD>.png
|
|
9
|
+
```
|
|
10
|
+
|
|
11
|
+
Examples:
|
|
12
|
+
- `sneakers-grid-2x2-16-9-2026-05-09.png`
|
|
13
|
+
- `mugs-catalog-3x3-1-1-2026-05-09.png`
|
|
14
|
+
|
|
15
|
+
## Per-cell exports (optional)
|
|
16
|
+
|
|
17
|
+
If downstream layout requires per-cell separate images:
|
|
18
|
+
|
|
19
|
+
```
|
|
20
|
+
<product-line>-cell-<row>-<col>-<sku>-<YYYY-MM-DD>.png
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
Example:
|
|
24
|
+
- `sneakers-cell-1-1-sku-001-2026-05-09.png`
|
|
25
|
+
|
|
26
|
+
## Caption / label rendering
|
|
27
|
+
|
|
28
|
+
Captions are typically added in downstream layout (Figma / Sketch / CSS), not baked into the render. Reserve consistent space per cell for captions:
|
|
29
|
+
|
|
30
|
+
| Aspect | Caption space |
|
|
31
|
+
|---|---|
|
|
32
|
+
| 16:9 | Lower 15% of cell |
|
|
33
|
+
| 1:1 | Lower 20% of cell |
|
|
34
|
+
| 9:16 | Lower 25% of cell |
|
|
35
|
+
|
|
36
|
+
## Resolution per render
|
|
37
|
+
|
|
38
|
+
Render at the consumer's required resolution × 1.5 (for downscale-quality margin):
|
|
39
|
+
- 16:9 web hero → 2880×1620 (renders to 1920×1080)
|
|
40
|
+
- Square social → 2160×2160 (renders to 1440×1440)
|
|
41
|
+
|
|
42
|
+
Always document the rendered resolution and target resolution in the export evidence.
|
|
43
|
+
|
|
44
|
+
## glTF / GLB grid handoff (rare)
|
|
45
|
+
|
|
46
|
+
Multi-product grids rarely export as a single GLB; usually they are 2D renders. If a grid GLB is requested:
|
|
47
|
+
- Each product as a separate glTF node.
|
|
48
|
+
- Shared parent node for the grid arrangement.
|
|
49
|
+
- Document scale + grid arrangement in handoff.
|
|
50
|
+
|
|
51
|
+
## Related skill
|
|
52
|
+
`../SKILL.md`
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
# EVAL — product-hero-scene-planner
|
|
2
|
+
|
|
3
|
+
## Text-only eval prompt
|
|
4
|
+
Use product-hero-scene-planner to create a full cyberpunk shoe hero scene plan without runtime execution.
|
|
5
|
+
|
|
6
|
+
## Expected behavior
|
|
7
|
+
- complete scene plan schema
|
|
8
|
+
- clarification questions when needed
|
|
9
|
+
- assumptions and caveats explicit
|
|
10
|
+
|
|
11
|
+
## Pass / Warn / Fail criteria
|
|
12
|
+
- Pass: all plan sections + no runtime overclaims
|
|
13
|
+
- Warn: minor section gaps with caveats
|
|
14
|
+
- Fail: major sections missing or artifact claims without evidence
|
|
15
|
+
|
|
16
|
+
## Common failure modes
|
|
17
|
+
- shallow 3-step plan
|
|
18
|
+
- no assumptions policy
|
|
19
|
+
|
|
20
|
+
## Evidence expectations
|
|
21
|
+
- plan sections listed
|
|
22
|
+
- unresolved assumptions listed
|
|
23
|
+
- runtime status marked Not Run in text-only mode
|
|
24
|
+
|
|
25
|
+
## Sample passing response outline
|
|
26
|
+
- Scope and mode stated clearly
|
|
27
|
+
- Evidence expectations listed
|
|
28
|
+
- Pass/warn/fail reasoning tied to checks
|
|
29
|
+
|
|
30
|
+
## Sample failing response outline
|
|
31
|
+
- Overclaims runtime/artifact success
|
|
32
|
+
- Missing caveats or blocker details
|
|
33
|
+
- No clear next action
|