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,266 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: recipe-fit-assessor
|
|
3
|
+
description: Match user goals to BlendOps recipes and packs; flag scope gaps; recommend closest canonical workflow and skill chain.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# recipe-fit-assessor
|
|
7
|
+
|
|
8
|
+
## Purpose
|
|
9
|
+
|
|
10
|
+
Map a user's stated goal to the closest documented BlendOps recipe or pack before expensive planning or runtime work, returning a fit verdict (`Strong` / `Partial` / `Poor`), rationale, explicit gap list, and **one** recommended next skill. This skill is planning-only and never runs Blender, packs, or runtime.
|
|
11
|
+
|
|
12
|
+
## Quick start
|
|
13
|
+
|
|
14
|
+
- capture goal + constraints + deliverables
|
|
15
|
+
- compare against catalog rows in `references/recipe-catalog.md`
|
|
16
|
+
- assign fit verdict (Strong / Partial / Poor)
|
|
17
|
+
- list gap fixes or recommend a different workflow entrypoint
|
|
18
|
+
|
|
19
|
+
## When to use
|
|
20
|
+
|
|
21
|
+
- user asks "which recipe / pack fits my idea"
|
|
22
|
+
- scope drifts between product hero, portrait, interior, web GLB, batch renders
|
|
23
|
+
- before locking `intent-to-3d-brief-writer` output to a pack
|
|
24
|
+
|
|
25
|
+
## When not to use
|
|
26
|
+
<!-- blendops:generated:start exclusions -->
|
|
27
|
+
- Diverging raw creative ideas before a delivery shape exists → use `../blender-brainstorming/SKILL.md` (Explores creative directions and clarifies vague ideas before recipe selection)
|
|
28
|
+
- General entry routing across BlendOps when the goal itself is unclear → use `../blendops-help/SKILL.md` (Handles ambiguous entry triage at precedence Rank 1)
|
|
29
|
+
- Checking whether a selected pack's preflight prerequisites are met → use `../pack-prerequisite-checker/SKILL.md` (Evaluates preflight readiness once the recipe/pack is already selected)
|
|
30
|
+
- Picking the next workflow stage after preflight passed and artifacts already exist → use `../workflow-stage-router/SKILL.md` (Routes active in-flight workflows at precedence Rank 4)
|
|
31
|
+
- Writing the structured 8-slot 3D brief after recipe fit is settled → use `../intent-to-3d-brief-writer/SKILL.md` (Authors the formal brief after recipe fit is determined)
|
|
32
|
+
- Detailed scene planning once a domain and brief are locked → use `../product-hero-scene-planner/SKILL.md` (Builds the domain-specific scene plan after preflight passes)
|
|
33
|
+
- Runtime setup, path selection, or bridge conflict troubleshooting → use `../runtime-path-picker/SKILL.md` (Handles MCP runtime selection and setup outside recipe scoring)
|
|
34
|
+
- Legal or asset license verification → use `../asset-license-checker/SKILL.md` (Audits asset provenance and license compatibility)
|
|
35
|
+
<!-- blendops:generated:end exclusions -->
|
|
36
|
+
|
|
37
|
+
## Trigger phrases
|
|
38
|
+
<!-- blendops:generated:start triggers -->
|
|
39
|
+
- "what recipe should I use"
|
|
40
|
+
- "does product hero fit"
|
|
41
|
+
- "closest workflow for X"
|
|
42
|
+
- "which pack"
|
|
43
|
+
<!-- blendops:generated:end triggers -->
|
|
44
|
+
|
|
45
|
+
## Prerequisites / readiness
|
|
46
|
+
|
|
47
|
+
- rough goal statement exists
|
|
48
|
+
- intended outputs known (still image, GLB, animation, web, print)
|
|
49
|
+
- audience skill level known (non-Blender user assumed default)
|
|
50
|
+
|
|
51
|
+
## Input schema
|
|
52
|
+
|
|
53
|
+
### Required inputs
|
|
54
|
+
|
|
55
|
+
| Input | Why it is required |
|
|
56
|
+
|---|---|
|
|
57
|
+
| Goal summary | Defines fit target |
|
|
58
|
+
| Deliverable type | Maps to recipe outputs |
|
|
59
|
+
| Constraints (time, realism, web vs cinematic) | Drives fit verdict |
|
|
60
|
+
|
|
61
|
+
### Optional inputs
|
|
62
|
+
|
|
63
|
+
| Input | Use |
|
|
64
|
+
|---|---|
|
|
65
|
+
| Reference links / moodboards | Clarify genre fit |
|
|
66
|
+
| Prior pack choice | Re-evaluate fit |
|
|
67
|
+
|
|
68
|
+
### Assumptions to confirm
|
|
69
|
+
|
|
70
|
+
- User accepts switching packs if fit is Poor.
|
|
71
|
+
- Recipes under `docs/recipes/` and packs under `packs/` are the authoritative catalog.
|
|
72
|
+
|
|
73
|
+
## Output schema
|
|
74
|
+
|
|
75
|
+
### Primary output
|
|
76
|
+
|
|
77
|
+
- Recommended closest documented recipe or pack name
|
|
78
|
+
- Fit verdict (`Strong` | `Partial` | `Poor`) + plain-language rationale
|
|
79
|
+
- Gap list (what must change or be accepted to reach a Strong fit, or `none`)
|
|
80
|
+
- **One** recommended next skill from the official catalog (e.g., `intent-to-3d-brief-writer` or the single best-matching skill)
|
|
81
|
+
|
|
82
|
+
### Evidence / caveat output
|
|
83
|
+
|
|
84
|
+
Assessing fit is planning-only and never executes runtime or produces artifacts. Truth states are downgrade-only (never upgrade):
|
|
85
|
+
- Allowed Runtime states: `Not Run | Attempted | Produced | Verified | Failed` (always `Not Run` for fit assessment unless reporting prior state)
|
|
86
|
+
- Allowed Artifact states: `Not Run | Not Produced | Produced | Verified | Failed` (defaults to `Not Produced`)
|
|
87
|
+
|
|
88
|
+
```txt
|
|
89
|
+
Runtime status: Not Run
|
|
90
|
+
Artifact status: Not Produced
|
|
91
|
+
Evidence used: <documented recipe/pack paths consulted>
|
|
92
|
+
Limitations: <catalog coverage gaps or unverified user constraints>
|
|
93
|
+
```
|
|
94
|
+
|
|
95
|
+
## Required laws
|
|
96
|
+
|
|
97
|
+
- `../../laws/evidence-before-done.md`
|
|
98
|
+
- `../../laws/non-blender-user-language.md`
|
|
99
|
+
- `../../laws/no-arbitrary-python-interface.md`
|
|
100
|
+
- `../../laws/official-runtime-only.md`
|
|
101
|
+
|
|
102
|
+
## Official runtime boundary
|
|
103
|
+
|
|
104
|
+
Planning-only skill. Does not configure MCP, Blender, or hosts. When mentioning runtime, use the 2-path + CLI appendix model from `docs/runtime-stack-strategy.md` only as context for whether a workflow expects interactive MCP vs batch CLI — never claim runtime success.
|
|
105
|
+
|
|
106
|
+
## Operating procedure
|
|
107
|
+
|
|
108
|
+
1. Normalize goal using `references/scope-gap-rules.md`.
|
|
109
|
+
2. Score against each catalog row in `references/recipe-catalog.md`.
|
|
110
|
+
3. Pick Strong fit if any; else best Partial with explicit gaps.
|
|
111
|
+
4. Emit recommendation block from `references/workflow-recommendation-template.md`.
|
|
112
|
+
5. Hand off to brief writer or narrow planner per fit.
|
|
113
|
+
|
|
114
|
+
## Decision tree
|
|
115
|
+
|
|
116
|
+
```txt
|
|
117
|
+
Is the user's goal still vague or unformed with no deliverable shape?
|
|
118
|
+
Yes → route to blender-brainstorming (creative divergence) or blendops-help (Rank 1 entry triage)
|
|
119
|
+
No → continue
|
|
120
|
+
Is a recipe/pack already selected and ready for preflight or stage routing?
|
|
121
|
+
Recipe selected, preflight not run → route to pack-prerequisite-checker (Rank 3)
|
|
122
|
+
Preflight passed, stage/artifact inventory exists → route to workflow-stage-router (Rank 4)
|
|
123
|
+
No recipe/pack selected yet → score candidate entries in `references/recipe-catalog.md`
|
|
124
|
+
Does the prompt request multiple incompatible deliverables at once (e.g., studio hero + full interior arch + character rig)?
|
|
125
|
+
Yes → assign Partial or Poor fit, list scope-conflict gaps (`references/scope-gap-rules.md`), and route to blender-recipe-decomposer
|
|
126
|
+
No → evaluate single-domain alignment:
|
|
127
|
+
- Deliverable + style + budget match `product-hero-v0` or documented workflow → Strong fit → recommend `intent-to-3d-brief-writer` (or `pack-prerequisite-checker` if brief is already locked)
|
|
128
|
+
- Domain matches a specialized planner (portrait, interior, environment, product grid) with manageable adaptations → Partial fit with explicit gap bullets → recommend `intent-to-3d-brief-writer`
|
|
129
|
+
- Request violates BlendOps 1.0.0 scope (e.g., multi-user live editing) → Poor fit → document mitigations and alternative entrypoint
|
|
130
|
+
```
|
|
131
|
+
|
|
132
|
+
## Playbooks
|
|
133
|
+
|
|
134
|
+
### Playbook A: Direct product hero match (`Strong` fit)
|
|
135
|
+
|
|
136
|
+
- Match single-product focal stills or web GLB spin deliverables against `packs/product-hero-v0/PACK.md` and `docs/workflows/product-hero-workflow.md` (`references/recipe-catalog.md`).
|
|
137
|
+
- Assign `Fit verdict: Strong` with `Gaps: none` (or minor notes) using `references/workflow-recommendation-template.md`.
|
|
138
|
+
- Recommend `../intent-to-3d-brief-writer/SKILL.md` as the single next skill and keep `Runtime status: Not Run` and `Artifact status: Not Produced`.
|
|
139
|
+
|
|
140
|
+
### Playbook B:Adjacent domain or hybrid deliverable (`Partial` fit)
|
|
141
|
+
|
|
142
|
+
- When the user wants an architectural interior, character portrait, environment establishing shot, or multi-item product grid, score `product-hero-v0` as `Partial` (or anchor on `docs/workflows/full-non-blender-user-workflow.md` + the matching domain planner).
|
|
143
|
+
- List each scope gap and mitigation explicitly per `references/scope-gap-rules.md` (for example, switching the downstream scene planner to `../interior-scene/SKILL.md` or prioritizing the hero still before optional GLB export).
|
|
144
|
+
- Recommend `../intent-to-3d-brief-writer/SKILL.md` to lock the adapted 8-slot brief.
|
|
145
|
+
|
|
146
|
+
### Playbook C: Bundled multi-project ask (`Poor` fit / decomposition needed)
|
|
147
|
+
|
|
148
|
+
- When a user combines incompatible recipes in one request, assign `Fit verdict: Poor` (or `Partial` with blocking scope split) and explain why forcing a single pack causes rework.
|
|
149
|
+
- Recommend `../blender-recipe-decomposer/SKILL.md` as the single immediate next skill to split the deliverables into ordered sub-projects.
|
|
150
|
+
|
|
151
|
+
## Mode handling
|
|
152
|
+
|
|
153
|
+
### Text-only mode
|
|
154
|
+
|
|
155
|
+
Fit from stated intent only; flag unknowns as gaps.
|
|
156
|
+
|
|
157
|
+
### Runtime-ready mode
|
|
158
|
+
|
|
159
|
+
Same as text-only; optionally note if user demands CLI-only automation.
|
|
160
|
+
|
|
161
|
+
### Blocked runtime mode
|
|
162
|
+
|
|
163
|
+
Still usable; note runtime unavailable does not change recipe fit.
|
|
164
|
+
|
|
165
|
+
## Validation checklist
|
|
166
|
+
|
|
167
|
+
* [ ] Documented recipe/pack catalog consulted
|
|
168
|
+
* [ ] Fit verdict (`Strong` / `Partial` / `Poor`) and plain-language rationale assigned
|
|
169
|
+
* [ ] Explicit gap list included (or `none`)
|
|
170
|
+
* [ ] Exactly **one** next skill recommended from the valid 48-skill catalog
|
|
171
|
+
* [ ] Truth states follow downgrade-only rules with Artifact status defaulting to `Not Produced`
|
|
172
|
+
* [ ] No Blender execution, Python code, pack installation, or runtime success claims
|
|
173
|
+
|
|
174
|
+
## Pass / Warn / Fail rubric
|
|
175
|
+
|
|
176
|
+
| Verdict | Criteria |
|
|
177
|
+
|---|---|
|
|
178
|
+
| Pass | Strong fit with documented recipe/pack + clear next skill |
|
|
179
|
+
| Warn | Partial fit; user must accept gaps or expand scope |
|
|
180
|
+
| Fail | Poor fit but user insists on wrong pack without mitigations |
|
|
181
|
+
|
|
182
|
+
## Failure handling
|
|
183
|
+
|
|
184
|
+
- If the user's goal statement is too ambiguous to score against `references/recipe-catalog.md`, do not guess a pack; keep `Runtime status: Not Run` and `Artifact status: Not Produced` and route to `../blender-brainstorming/SKILL.md` or `../blendops-help/SKILL.md`.
|
|
185
|
+
- If the prompt bundles multiple incompatible recipes and the user refuses to prioritize, assign `Fit verdict: Poor`, record the unmitigated scope collision under `Limitations`, and route to `../blender-recipe-decomposer/SKILL.md`.
|
|
186
|
+
- Never claim a recipe or pack is "installed", "executed", or `Verified` during fit assessment.
|
|
187
|
+
|
|
188
|
+
## Troubleshooting
|
|
189
|
+
|
|
190
|
+
| Symptom | Cause | Safe resolution |
|
|
191
|
+
|---|---|---|
|
|
192
|
+
| User asks for an interior room scene using `product-hero-v0` | Studio product pack assumes isolated hero subject lighting rather than enclosed room bounce light | Score `product-hero-v0` as `Partial` / `Poor` for full room architecture, document the lighting/camera gap, and anchor the workflow on `../interior-scene/SKILL.md` after `../intent-to-3d-brief-writer/SKILL.md`. |
|
|
193
|
+
| User wants both a 4K offline Cycles still and a <5 MB mobile GLB from one unprioritized brief | Real-time web budget conflicts with heavy cinematic shader setup (`references/scope-gap-rules.md`) | Downgrade verdict to `Partial`, list material/polycount dual-target gaps, and require primary/secondary deliverable prioritization in `../intent-to-3d-brief-writer/SKILL.md`. |
|
|
194
|
+
| User asks "which pack fits" when preflight and scene plans are already finished | Workflow is already in flight past Rank 2 | Hand off immediately to `../workflow-stage-router/SKILL.md` instead of re-running initial recipe selection. |
|
|
195
|
+
|
|
196
|
+
## Best practices
|
|
197
|
+
|
|
198
|
+
- Consult `references/recipe-catalog.md` and `references/scope-gap-rules.md` on every run so fit verdicts remain grounded in documented repository paths (`packs/product-hero-v0/PACK.md`, `docs/recipes/cyberpunk-shoe-hero.md`, `docs/workflows/product-hero-workflow.md`, `docs/workflows/full-non-blender-user-workflow.md`).
|
|
199
|
+
- Always emit a clear 3-tier verdict (`Strong`, `Partial`, or `Poor`) plus an explicit gap list (`none` only when genuinely `Strong`).
|
|
200
|
+
- Recommend **exactly one** next catalog skill so the agent does not fan out into parallel planners prematurely.
|
|
201
|
+
- Keep `Runtime status: Not Run` and `Artifact status: Not Produced` as the default truth states.
|
|
202
|
+
|
|
203
|
+
## Good examples
|
|
204
|
+
|
|
205
|
+
- "`Fit verdict: Strong` — Single sneaker hero still + web GLB spin aligns directly with `packs/product-hero-v0/PACK.md` and `docs/recipes/cyberpunk-shoe-hero.md`. `Gaps: none`. Recommended next skill: `../intent-to-3d-brief-writer/SKILL.md`. `Runtime status: Not Run`. `Artifact status: Not Produced`."
|
|
206
|
+
- "`Fit verdict: Partial` — Cinematic dining room furniture showcase overlaps `docs/workflows/full-non-blender-user-workflow.md` and `../interior-scene/SKILL.md`, whereas `product-hero-v0` assumes studio isolation. `Gaps`: (1) use interior architectural camera/lighting planner instead of studio sweep; (2) mark optional GLB spin as secondary deliverable. Recommended next skill: `../intent-to-3d-brief-writer/SKILL.md`."
|
|
207
|
+
|
|
208
|
+
## Bad examples
|
|
209
|
+
|
|
210
|
+
- "`Fit verdict: Strong` — Use the `character-rigging-pro-v2` pack and start rendering immediately." — invents a non-existent pack and skips brief/preflight gates.
|
|
211
|
+
- "Use `product-hero-v0` for your 50-character crowd battle animation; no gaps." — ignores `references/recipe-catalog.md` weak-fit rules.
|
|
212
|
+
- "Recommended next skills: `intent-to-3d-brief-writer`, `pack-prerequisite-checker`, `product-hero-scene-planner`, and `lighting-material-plan`. `Artifact status: Produced`." — violates the single-next-skill contract and fabricates artifact status.
|
|
213
|
+
|
|
214
|
+
## User-facing response template
|
|
215
|
+
|
|
216
|
+
```txt
|
|
217
|
+
Goal summary: <one-line user goal>
|
|
218
|
+
Deliverables & constraints: <deliverable types + time/platform/realism constraints>
|
|
219
|
+
Fit verdict: <Strong | Partial | Poor>
|
|
220
|
+
Primary catalog anchor: <documented pack or recipe path>
|
|
221
|
+
Alternate anchors: <specialized planner or workflow path, or none>
|
|
222
|
+
Gaps & mitigations:
|
|
223
|
+
- <explicit gap + mitigation, or "none">
|
|
224
|
+
Recommended next skill: <single catalog skill path>
|
|
225
|
+
Runtime status: Not Run
|
|
226
|
+
Artifact status: Not Produced
|
|
227
|
+
Evidence used: <catalog paths consulted>
|
|
228
|
+
Limitations: <unconfirmed user constraints or catalog coverage boundaries>
|
|
229
|
+
```
|
|
230
|
+
|
|
231
|
+
## Anti-patterns
|
|
232
|
+
|
|
233
|
+
- Inventing undocumented packs or recipes that do not exist under `packs/`, `docs/recipes/`, or `docs/workflows/`.
|
|
234
|
+
- Assigning `Strong` fit when the user requests multiple conflicting deliverables without prioritization.
|
|
235
|
+
- Recommending more than **one** immediate next skill in the output block.
|
|
236
|
+
- Writing `Artifact status: Not Run` or upgrading `Runtime status` / `Artifact status` during recipe scoring.
|
|
237
|
+
- Writing the full 8-slot 3D brief or executing preflight checks inside `recipe-fit-assessor` instead of handing off to `intent-to-3d-brief-writer` or `pack-prerequisite-checker`.
|
|
238
|
+
|
|
239
|
+
## Cross-skill handoff
|
|
240
|
+
<!-- blendops:generated:start handoffs -->
|
|
241
|
+
- [upstream_reference] Upstream creative divergence → `../blender-brainstorming/SKILL.md`
|
|
242
|
+
- [boundary_delegation] General entry routing → `../blendops-help/SKILL.md`
|
|
243
|
+
- [conditional] Multi-deliverable scope split when prompt spans multiple incompatible recipes → `../blender-recipe-decomposer/SKILL.md`
|
|
244
|
+
- [progression] Downstream structured brief → `../intent-to-3d-brief-writer/SKILL.md`
|
|
245
|
+
- [progression] Pack prerequisite verification → `../pack-prerequisite-checker/SKILL.md`
|
|
246
|
+
- [conditional] Post-artifact stage routing → `../workflow-stage-router/SKILL.md`
|
|
247
|
+
- [alternative] Domain scene planner (product hero) → `../product-hero-scene-planner/SKILL.md`
|
|
248
|
+
- [alternative] Domain scene planner (product grid) → `../product-grid-scene-planner/SKILL.md`
|
|
249
|
+
- [alternative] Domain scene planner (character portrait) → `../character-portrait/SKILL.md`
|
|
250
|
+
- [alternative] Domain scene planner (environment establishing shot) → `../environment-shot/SKILL.md`
|
|
251
|
+
- [alternative] Domain scene planner (interior architectural) → `../interior-scene/SKILL.md`
|
|
252
|
+
<!-- blendops:generated:end handoffs -->
|
|
253
|
+
|
|
254
|
+
## Non-goals
|
|
255
|
+
|
|
256
|
+
- Brainstorming open-ended creative concepts before a goal exists (use `../blender-brainstorming/SKILL.md`).
|
|
257
|
+
- Authoring the locked 8-slot 3D brief (use `../intent-to-3d-brief-writer/SKILL.md`).
|
|
258
|
+
- Running the 7-row pack preflight gate (use `../pack-prerequisite-checker/SKILL.md`).
|
|
259
|
+
- Selecting MCP runtime paths, configuring Blender, or verifying rendered/exported artifacts.
|
|
260
|
+
|
|
261
|
+
## References
|
|
262
|
+
|
|
263
|
+
* `references/recipe-catalog.md`
|
|
264
|
+
* `references/scope-gap-rules.md`
|
|
265
|
+
* `references/workflow-recommendation-template.md`
|
|
266
|
+
* `../../docs/recipes/README.md`
|
|
@@ -0,0 +1,220 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$schema": "../../schemas/skill-contract.schema.json",
|
|
3
|
+
"id": "recipe-fit-assessor",
|
|
4
|
+
"version": "1.0.0",
|
|
5
|
+
"category": "routing-and-governance",
|
|
6
|
+
"role": "recipe-and-pack-selector",
|
|
7
|
+
"purpose": "Score whether a user's 3D goal fits an existing BlendOps recipe or pack, or needs custom decomposition, and name the exact next skill.",
|
|
8
|
+
"capabilityTier": "L0",
|
|
9
|
+
"routingPrecedence": {
|
|
10
|
+
"group": "entry-and-stage-routing",
|
|
11
|
+
"rank": 2,
|
|
12
|
+
"activationGate": {
|
|
13
|
+
"goalClarity": "clear",
|
|
14
|
+
"recipeSelected": false,
|
|
15
|
+
"preflightPassed": false,
|
|
16
|
+
"hasStageOrArtifactInventory": false
|
|
17
|
+
}
|
|
18
|
+
},
|
|
19
|
+
"triggers": [
|
|
20
|
+
"what recipe should I use",
|
|
21
|
+
"does product hero fit",
|
|
22
|
+
"closest workflow for X",
|
|
23
|
+
"which pack"
|
|
24
|
+
],
|
|
25
|
+
"exclusions": [
|
|
26
|
+
{
|
|
27
|
+
"condition": "Diverging raw creative ideas before a delivery shape exists",
|
|
28
|
+
"delegateTo": "blender-brainstorming",
|
|
29
|
+
"reason": "Explores creative directions and clarifies vague ideas before recipe selection"
|
|
30
|
+
},
|
|
31
|
+
{
|
|
32
|
+
"condition": "General entry routing across BlendOps when the goal itself is unclear",
|
|
33
|
+
"delegateTo": "blendops-help",
|
|
34
|
+
"reason": "Handles ambiguous entry triage at precedence Rank 1"
|
|
35
|
+
},
|
|
36
|
+
{
|
|
37
|
+
"condition": "Checking whether a selected pack's preflight prerequisites are met",
|
|
38
|
+
"delegateTo": "pack-prerequisite-checker",
|
|
39
|
+
"reason": "Evaluates preflight readiness once the recipe/pack is already selected"
|
|
40
|
+
},
|
|
41
|
+
{
|
|
42
|
+
"condition": "Picking the next workflow stage after preflight passed and artifacts already exist",
|
|
43
|
+
"delegateTo": "workflow-stage-router",
|
|
44
|
+
"reason": "Routes active in-flight workflows at precedence Rank 4"
|
|
45
|
+
},
|
|
46
|
+
{
|
|
47
|
+
"condition": "Writing the structured 8-slot 3D brief after recipe fit is settled",
|
|
48
|
+
"delegateTo": "intent-to-3d-brief-writer",
|
|
49
|
+
"reason": "Authors the formal brief after recipe fit is determined"
|
|
50
|
+
},
|
|
51
|
+
{
|
|
52
|
+
"condition": "Detailed scene planning once a domain and brief are locked",
|
|
53
|
+
"delegateTo": "product-hero-scene-planner",
|
|
54
|
+
"reason": "Builds the domain-specific scene plan after preflight passes"
|
|
55
|
+
},
|
|
56
|
+
{
|
|
57
|
+
"condition": "Runtime setup, path selection, or bridge conflict troubleshooting",
|
|
58
|
+
"delegateTo": "runtime-path-picker",
|
|
59
|
+
"reason": "Handles MCP runtime selection and setup outside recipe scoring"
|
|
60
|
+
},
|
|
61
|
+
{
|
|
62
|
+
"condition": "Legal or asset license verification",
|
|
63
|
+
"delegateTo": "asset-license-checker",
|
|
64
|
+
"reason": "Audits asset provenance and license compatibility"
|
|
65
|
+
}
|
|
66
|
+
],
|
|
67
|
+
"inputs": {
|
|
68
|
+
"required": [
|
|
69
|
+
{
|
|
70
|
+
"name": "user_goal_summary",
|
|
71
|
+
"type": "string",
|
|
72
|
+
"description": "Plain-language 3D goal and intended deliverable subject"
|
|
73
|
+
},
|
|
74
|
+
{
|
|
75
|
+
"name": "target_output_destination",
|
|
76
|
+
"type": "string",
|
|
77
|
+
"description": "Target format or channel (e.g., hero still, catalog grid, turntable, web GLB)"
|
|
78
|
+
}
|
|
79
|
+
],
|
|
80
|
+
"optional": [
|
|
81
|
+
{
|
|
82
|
+
"name": "candidate_pack_hint",
|
|
83
|
+
"type": "string",
|
|
84
|
+
"description": "Optional pack or recipe the user is considering"
|
|
85
|
+
}
|
|
86
|
+
]
|
|
87
|
+
},
|
|
88
|
+
"outputs": {
|
|
89
|
+
"primary": [
|
|
90
|
+
"recipe_fit_verdict",
|
|
91
|
+
"candidate_comparison_table",
|
|
92
|
+
"recommended_next_skill"
|
|
93
|
+
],
|
|
94
|
+
"truthStatePolicy": {
|
|
95
|
+
"runtimeDefault": "Not Run",
|
|
96
|
+
"artifactDefault": "Not Produced",
|
|
97
|
+
"mutationRule": "downgrade_only"
|
|
98
|
+
}
|
|
99
|
+
},
|
|
100
|
+
"handoffs": [
|
|
101
|
+
{
|
|
102
|
+
"target": "blender-brainstorming",
|
|
103
|
+
"type": "upstream_reference",
|
|
104
|
+
"label": "Upstream creative divergence",
|
|
105
|
+
"when": {
|
|
106
|
+
"all": [
|
|
107
|
+
{ "field": "goal.clarity", "operator": "equals", "value": "ambiguous_or_mixed" }
|
|
108
|
+
]
|
|
109
|
+
}
|
|
110
|
+
},
|
|
111
|
+
{
|
|
112
|
+
"target": "blendops-help",
|
|
113
|
+
"type": "boundary_delegation",
|
|
114
|
+
"label": "General entry routing",
|
|
115
|
+
"when": {
|
|
116
|
+
"all": [
|
|
117
|
+
{ "field": "request.scope", "operator": "equals", "value": "general_help" }
|
|
118
|
+
]
|
|
119
|
+
}
|
|
120
|
+
},
|
|
121
|
+
{
|
|
122
|
+
"target": "blender-recipe-decomposer",
|
|
123
|
+
"type": "conditional",
|
|
124
|
+
"label": "Multi-deliverable scope split when prompt spans multiple incompatible recipes",
|
|
125
|
+
"when": {
|
|
126
|
+
"all": [
|
|
127
|
+
{ "field": "fit.multiDeliverableDetected", "operator": "equals", "value": true }
|
|
128
|
+
]
|
|
129
|
+
}
|
|
130
|
+
},
|
|
131
|
+
{
|
|
132
|
+
"target": "intent-to-3d-brief-writer",
|
|
133
|
+
"type": "progression",
|
|
134
|
+
"label": "Downstream structured brief",
|
|
135
|
+
"when": {
|
|
136
|
+
"all": [
|
|
137
|
+
{ "field": "fit.verdict", "operator": "in", "value": ["strong_fit", "partial_fit"] },
|
|
138
|
+
{ "field": "brief.locked", "operator": "equals", "value": false }
|
|
139
|
+
]
|
|
140
|
+
}
|
|
141
|
+
},
|
|
142
|
+
{
|
|
143
|
+
"target": "pack-prerequisite-checker",
|
|
144
|
+
"type": "progression",
|
|
145
|
+
"label": "Pack prerequisite verification",
|
|
146
|
+
"when": {
|
|
147
|
+
"all": [
|
|
148
|
+
{ "field": "fit.verdict", "operator": "equals", "value": "strong_fit" },
|
|
149
|
+
{ "field": "brief.locked", "operator": "equals", "value": true }
|
|
150
|
+
]
|
|
151
|
+
}
|
|
152
|
+
},
|
|
153
|
+
{
|
|
154
|
+
"target": "workflow-stage-router",
|
|
155
|
+
"type": "conditional",
|
|
156
|
+
"label": "Post-artifact stage routing",
|
|
157
|
+
"when": {
|
|
158
|
+
"all": [
|
|
159
|
+
{ "field": "preflight.passed", "operator": "equals", "value": true },
|
|
160
|
+
{ "field": "inventory.exists", "operator": "equals", "value": true }
|
|
161
|
+
]
|
|
162
|
+
}
|
|
163
|
+
},
|
|
164
|
+
{
|
|
165
|
+
"target": "product-hero-scene-planner",
|
|
166
|
+
"type": "alternative",
|
|
167
|
+
"label": "Domain scene planner (product hero)",
|
|
168
|
+
"when": {
|
|
169
|
+
"all": [
|
|
170
|
+
{ "field": "brief.locked", "operator": "equals", "value": true },
|
|
171
|
+
{ "field": "recipe.domain", "operator": "equals", "value": "product_hero" }
|
|
172
|
+
]
|
|
173
|
+
}
|
|
174
|
+
},
|
|
175
|
+
{
|
|
176
|
+
"target": "product-grid-scene-planner",
|
|
177
|
+
"type": "alternative",
|
|
178
|
+
"label": "Domain scene planner (product grid)",
|
|
179
|
+
"when": {
|
|
180
|
+
"all": [
|
|
181
|
+
{ "field": "brief.locked", "operator": "equals", "value": true },
|
|
182
|
+
{ "field": "recipe.domain", "operator": "equals", "value": "product_grid" }
|
|
183
|
+
]
|
|
184
|
+
}
|
|
185
|
+
},
|
|
186
|
+
{
|
|
187
|
+
"target": "character-portrait",
|
|
188
|
+
"type": "alternative",
|
|
189
|
+
"label": "Domain scene planner (character portrait)",
|
|
190
|
+
"when": {
|
|
191
|
+
"all": [
|
|
192
|
+
{ "field": "brief.locked", "operator": "equals", "value": true },
|
|
193
|
+
{ "field": "recipe.domain", "operator": "equals", "value": "character_portrait" }
|
|
194
|
+
]
|
|
195
|
+
}
|
|
196
|
+
},
|
|
197
|
+
{
|
|
198
|
+
"target": "environment-shot",
|
|
199
|
+
"type": "alternative",
|
|
200
|
+
"label": "Domain scene planner (environment establishing shot)",
|
|
201
|
+
"when": {
|
|
202
|
+
"all": [
|
|
203
|
+
{ "field": "brief.locked", "operator": "equals", "value": true },
|
|
204
|
+
{ "field": "recipe.domain", "operator": "equals", "value": "environment_shot" }
|
|
205
|
+
]
|
|
206
|
+
}
|
|
207
|
+
},
|
|
208
|
+
{
|
|
209
|
+
"target": "interior-scene",
|
|
210
|
+
"type": "alternative",
|
|
211
|
+
"label": "Domain scene planner (interior architectural)",
|
|
212
|
+
"when": {
|
|
213
|
+
"all": [
|
|
214
|
+
{ "field": "brief.locked", "operator": "equals", "value": true },
|
|
215
|
+
{ "field": "recipe.domain", "operator": "equals", "value": "interior_archviz" }
|
|
216
|
+
]
|
|
217
|
+
}
|
|
218
|
+
}
|
|
219
|
+
]
|
|
220
|
+
}
|
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
# Recipe / pack catalog (BlendOps Canonical Recipe Registry)
|
|
2
|
+
|
|
3
|
+
Use this table for fast fit scoring. Machine-readable recipe definitions live in `registry/recipe-catalog.json` (indexed in `registry/catalog-index.json` and rendered in `docs/knowledge-and-recipe-catalog.md`); human-readable scenario examples and packs live under `docs/recipes/`, `docs/workflows/`, and `packs/`.
|
|
4
|
+
|
|
5
|
+
## Canonical Machine-Readable Recipes (`registry/recipe-catalog.json`)
|
|
6
|
+
|
|
7
|
+
| Canonical Recipe ID | Primary Domain | Primary Outputs | Best When | Weak Fit When |
|
|
8
|
+
|---|---|---|---|---|
|
|
9
|
+
| `recipe.product-hero-scene` | `lighting-camera-and-rendering` | Hero still render + optional web GLB (`packs/product-hero-v0`, `docs/recipes/cyberpunk-shoe-hero.md`) | Single focal product, studio lighting, hero framing | Crowd scenes, multi-character narrative |
|
|
10
|
+
| `recipe.stylized-environment-scene` | `environment-and-architecture` | Wide/establishing environment render | Exterior or stylized architectural vista with foreground/midground/background depth | Single isolated studio prop |
|
|
11
|
+
| `recipe.hard-surface-prop` | `hard-surface-and-organic` | Subdivision/bevel-clean hard-surface prop mesh | Mechanical, industrial, consumer electronics, or weapon/vehicle props | Organic sculpted characters or cloth |
|
|
12
|
+
| `recipe.procedural-geometry-nodes-asset` | `geometry-nodes-and-procedural` | Parametric Geometry Nodes asset + realized mesh | Modular variation, Poisson disk scattering, instanced arrays | Hand-sculpted hero character faces |
|
|
13
|
+
| `recipe.uv-and-pbr-material-preparation` | `uv-texturing-and-baking` | 0–1 UV layout + baked tangent-space normal/AO/ORM PBR maps | High-to-low poly baking, procedural-to-image PBR conversion | Untextured clay blockouts |
|
|
14
|
+
| `recipe.presentation-lighting-and-camera` | `lighting-camera-and-rendering` | Physical camera rig + 3-point/HDRI lighting + AgX/Filmic look | Portfolio presentation, studio turntables, architectural lighting | Unlit collision meshes |
|
|
15
|
+
| `recipe.rigged-and-animated-asset` | `rigging-and-animation` | Skeletal armature + normalized skin weights + baked NLA clips | Character/creature locomotion, mechanical articulated animation | Static props using simple object transforms |
|
|
16
|
+
| `recipe.scene-quality-inspection-and-correction` | `modeling-and-topology` | 7-point pre-handoff audit + remediation plan | Auditing topology, transforms, UV padding, materials, and lighting before render/export | Initial ideation with no scene geometry |
|
|
17
|
+
| `recipe.blender-to-glb-handoff` | `interchange-gltf-and-web` | Validated `.glb` binary + Khronos/Three.js/R3F handoff manifest | Exporting Blender assets to Three.js, React Three Fiber, or `<model-viewer>` | Offline-only Cycles EXR compositing |
|
|
18
|
+
| `recipe.web-ready-asset-optimization` | `optimization-lod-and-performance` | Decimated LODs + KTX2 (UASTC/ETC1S) + Draco/Meshopt compressed GLB | Mobile/web bandwidth and VRAM optimization under strict triangle/draw-call budgets | Unconstrained offline archival masters |
|
|
19
|
+
|
|
20
|
+
## Packs, Scenario Recipes & Workflow Chains
|
|
21
|
+
|
|
22
|
+
| Entry | Primary outputs | Best when | Weak fit when |
|
|
23
|
+
|---|---|---|---|
|
|
24
|
+
| `product-hero-v0` pack (`packs/product-hero-v0/PACK.md`) | Hero still + GLB path (bound to `recipe.product-hero-scene`) | Single product focal, studio lighting | Crowd scenes, heavy narrative |
|
|
25
|
+
| `docs/recipes/cyberpunk-shoe-hero.md` | Styled hero scenario instance of `recipe.product-hero-scene` | Teaching golden-path thinking | Non-footwear without adaptation |
|
|
26
|
+
| `docs/workflows/product-hero-workflow.md` | 5-stage hero subset | Narrow product pipeline | Needs full cross-domain chain |
|
|
27
|
+
| `docs/workflows/full-non-blender-user-workflow.md` | Broad 7-stage chain | Unknown scope, first-time user | User already locked a niche |
|
|
28
|
+
|
|
29
|
+
Cross-reference specialized planners (`character-portrait`, `environment-shot`, `interior-scene`, `product-grid-scene-planner`) and deterministic lookup (`blendops catalog-search --type recipe "<query>"`) when `product-hero-v0` is only a partial match.
|
|
30
|
+
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
# Scope Gap Rules
|
|
2
|
+
|
|
3
|
+
Use these objective thresholds in `recipe-fit-assessor` to score whether an existing BlendOps recipe/pack is a **Strong**, **Partial**, or **Poor** fit for the user's request. Every downgraded gap must name one concrete mitigation.
|
|
4
|
+
|
|
5
|
+
## Fit Rating Matrix
|
|
6
|
+
|
|
7
|
+
| Verdict | Criteria Required | Allowed Next Routing |
|
|
8
|
+
|---|---|---|
|
|
9
|
+
| **Strong Fit** | Deliverable type (`still`, `turntable`, `.glb`, `animation`), visual style (studio vs. dark hero vs. environment), asset sourcing feasibility, and complexity all align with an existing recipe/pack | Proceed directly to `pack-prerequisite-checker` or `intent-to-3d-brief-writer` |
|
|
10
|
+
| **Partial Fit** | Core staging/camera structure fits an existing recipe, **but** 1-2 constraints conflict (e.g., extra mobile GLB budget, extra animation pass, or unverified external asset licenses) | Route through `scope-guard` or `asset-license-checker` to resolve gaps before planning |
|
|
11
|
+
| **Poor Fit** | Fundamental pipeline mismatch — recipe cannot safely stretch to cover the core requirement without inventing an unsupported multi-scene/rig/simulation pipeline | Decline pack shortcut honestly; decompose via `blender-recipe-decomposer` or custom planner (`character-portrait`, `environment-shot`, `interior-scene`) |
|
|
12
|
+
|
|
13
|
+
## Explicit Upgrade & Downgrade Triggers
|
|
14
|
+
- **Upgrade to Strong Fit** when: deliverable matches pack outputs 1:1, polycount/texture complexity fits stated timeline, and lighting/staging style matches the chosen playbook (`product-hero-playbooks.md`).
|
|
15
|
+
- **Downgrade to Partial Fit** when:
|
|
16
|
+
1. User asks for incompatible targets simultaneously (`4K cinematic Cycles animation + <1.5 MB mobile AR GLB`) with no `P0` priority.
|
|
17
|
+
2. External branded logos/characters are required while the recipe assumes clean procedural/CC0 geometry (`asset-license-checker` needed).
|
|
18
|
+
3. Interactive R3F/Three.js handoff is requested on top of a still-only recipe (pair with `glb-web-handoff` + `web-material-simplification.md`).
|
|
19
|
+
- **Trigger Poor Fit** when:
|
|
20
|
+
1. User needs full rigged character animation or photoreal architectural interior lighting while inspecting a product-hero studio pack.
|
|
21
|
+
2. Request requires multi-user real-time collaborative editing or Blender server hosting (explicitly outside BlendOps 1.0.0 scope).
|
|
22
|
+
|
|
23
|
+
## Documentation Rule
|
|
24
|
+
- Every `Partial` or `Poor` finding must output bulleted `[Gap] -> [Mitigation / Recommended Skill]` pairs rather than silent workarounds.
|
|
25
|
+
|
|
26
|
+
## Related skill
|
|
27
|
+
[../SKILL.md](../SKILL.md)
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
# Workflow Recommendation Template
|
|
2
|
+
|
|
3
|
+
Use this exact plain-language recommendation card at the conclusion of `recipe-fit-assessor` so the user and downstream planning skills receive one clear primary anchor, honest gaps, and a single next skill.
|
|
4
|
+
|
|
5
|
+
```txt
|
|
6
|
+
Goal summary: <1 plain-English sentence capturing user intent>
|
|
7
|
+
Deliverables: <explicit formats, e.g. still PNG (16:9) + interactive web .glb>
|
|
8
|
+
Key constraints: <timeline, realism level, web MB/triangle cap, license posture>
|
|
9
|
+
|
|
10
|
+
Fit verdict: Strong | Partial | Poor
|
|
11
|
+
Primary anchor: <exact repo path, e.g. docs/recipes/cyberpunk-shoe-hero.md>
|
|
12
|
+
Alternate anchor(s): <secondary recipe/pack path or "none">
|
|
13
|
+
|
|
14
|
+
Scope gaps & mitigations (required if Partial or Poor):
|
|
15
|
+
- Gap 1: <exact mismatch, e.g. "Recipe targets offline still PNG while web .glb < 5 MB is requested">
|
|
16
|
+
Mitigation: <e.g. "Pair recipe with mobile-glb-budget + glb-web-handoff after lighting plan">
|
|
17
|
+
|
|
18
|
+
Recommended next skill: <single slug, e.g. pack-prerequisite-checker | scope-guard | intent-to-3d-brief-writer>
|
|
19
|
+
Notes for brief writer:
|
|
20
|
+
- <concrete slot detail preserved from user request>
|
|
21
|
+
- <unanswered question to confirm before build>
|
|
22
|
+
|
|
23
|
+
Catalog evidence inspected: <exact doc/catalog paths read>
|
|
24
|
+
Runtime posture (context only):
|
|
25
|
+
Runtime status: Not Run (assessment is planning-only; see runtime-path-picker if execution requested)
|
|
26
|
+
Artifact status: Not Produced
|
|
27
|
+
```
|
|
28
|
+
|
|
29
|
+
## Authoring Rules
|
|
30
|
+
- Keep terminology plain; translate unavoidable terms (`GLB = lightweight 3D web file`, `Cycles = realistic raytraced renderer`) on first use.
|
|
31
|
+
- Never silently omit a `Partial` or `Poor` gap just to push a recipe forward.
|
|
32
|
+
|
|
33
|
+
## Related skill
|
|
34
|
+
[../SKILL.md](../SKILL.md)
|