blendops 0.0.0-stage → 1.1.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 +74 -0
- package/LICENSE +21 -0
- package/README.md +208 -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 +73 -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/README.md +276 -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 +103 -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 +5443 -0
- package/scripts/runtime-orchestrator.mjs +7713 -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,26 @@
|
|
|
1
|
+
# EVAL — pack-prerequisite-checker
|
|
2
|
+
|
|
3
|
+
## Text-only eval prompt
|
|
4
|
+
|
|
5
|
+
User picked `product-hero-v0`, brief has mood + product silhouette but no asset strategy, no runtime path stated, wants GLB for web.
|
|
6
|
+
|
|
7
|
+
## Expected behavior
|
|
8
|
+
|
|
9
|
+
- Flag asset strategy + web handoff skills as needed inputs
|
|
10
|
+
- Runtime row = Needs input until path chosen
|
|
11
|
+
- Warn if GLB web targets unstated (mobile tier)
|
|
12
|
+
- Hand off to `asset-discovery` or `runtime-path-picker`
|
|
13
|
+
|
|
14
|
+
## Pass / Warn / Fail criteria
|
|
15
|
+
|
|
16
|
+
- Pass: matrix + go/no-go + owner actions
|
|
17
|
+
- Warn: accepted gaps documented
|
|
18
|
+
- Fail: declares go with missing critical brief fields
|
|
19
|
+
|
|
20
|
+
## Sample passing response outline
|
|
21
|
+
|
|
22
|
+
- Table + no-go with three owner actions
|
|
23
|
+
|
|
24
|
+
## Sample failing response outline
|
|
25
|
+
|
|
26
|
+
- "Ready to model" with no asset plan
|
|
@@ -0,0 +1,272 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: pack-prerequisite-checker
|
|
3
|
+
description: Verify brief completeness, runtime posture, skill coverage, and evidence habits before starting a pack workflow.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# pack-prerequisite-checker
|
|
7
|
+
|
|
8
|
+
## Purpose
|
|
9
|
+
|
|
10
|
+
Block "half-ready" pack execution: confirm the user's brief, chosen pack/recipe, runtime understanding, and evidence workflow are sufficient to start planners and validators without rework loops.
|
|
11
|
+
|
|
12
|
+
## Quick start
|
|
13
|
+
|
|
14
|
+
- identify target pack/recipe
|
|
15
|
+
- run checklist rows from `references/prerequisite-matrix.md`
|
|
16
|
+
- mark each row Ready / Needs input / Blocked
|
|
17
|
+
- only then authorize entry into execution-heavy skills
|
|
18
|
+
|
|
19
|
+
## When to use
|
|
20
|
+
|
|
21
|
+
- immediately after `recipe-fit-assessor` + `intent-to-3d-brief-writer`
|
|
22
|
+
- before first scene planner for a pack workflow
|
|
23
|
+
- when user jumps mid-pack without status context
|
|
24
|
+
|
|
25
|
+
## When not to use
|
|
26
|
+
<!-- blendops:generated:start exclusions -->
|
|
27
|
+
- Goal or entry point is ambiguous and no pack is chosen yet → use `../blendops-help/SKILL.md` (Triages ambiguous entry requests at precedence Rank 1)
|
|
28
|
+
- Evaluating which recipe or pack fits the user's goal → use `../recipe-fit-assessor/SKILL.md` (Scores candidate recipes/packs at precedence Rank 2 before preflight)
|
|
29
|
+
- Workflow is already past preflight with existing stage or artifact inventory → use `../workflow-stage-router/SKILL.md` (Routes in-flight workflows at precedence Rank 4)
|
|
30
|
+
- Detailed Blender MCP runtime connection preflight → use `../runtime-readiness/SKILL.md` (Inspects Path 1 or Path 2 runtime readiness in detail)
|
|
31
|
+
- Active MCP bridge port or add-on session conflicts → use `../bridge-conflicts/SKILL.md` (Resolves port 9876 and dual-bridge conflicts)
|
|
32
|
+
- Debugging Blender scene or runtime execution errors → use `../blender-troubleshooting/SKILL.md` (Diagnoses runtime or scene failures)
|
|
33
|
+
- Auditing external 3D asset license compliance → use `../asset-license-checker/SKILL.md` (Performs dedicated asset license and provenance verification)
|
|
34
|
+
<!-- blendops:generated:end exclusions -->
|
|
35
|
+
|
|
36
|
+
## Trigger phrases
|
|
37
|
+
<!-- blendops:generated:start triggers -->
|
|
38
|
+
- "are we ready to start"
|
|
39
|
+
- "pre-flight for the pack"
|
|
40
|
+
- "what's missing before we build"
|
|
41
|
+
- "check prerequisites"
|
|
42
|
+
<!-- blendops:generated:end triggers -->
|
|
43
|
+
|
|
44
|
+
## Prerequisites / readiness
|
|
45
|
+
|
|
46
|
+
- intended pack/recipe named OR explicitly "exploratory"
|
|
47
|
+
- user OK receiving Blocked rows
|
|
48
|
+
|
|
49
|
+
## Input schema
|
|
50
|
+
|
|
51
|
+
### Required inputs
|
|
52
|
+
|
|
53
|
+
| Input | Why it is required |
|
|
54
|
+
|---|---|
|
|
55
|
+
| Current brief summary | Validates completeness |
|
|
56
|
+
| Target pack/recipe | Selects matrix rows |
|
|
57
|
+
| Evidence expectation | Prevents false Verified claims |
|
|
58
|
+
|
|
59
|
+
### Optional inputs
|
|
60
|
+
|
|
61
|
+
| Input | Use |
|
|
62
|
+
|---|---|
|
|
63
|
+
| Known runtime path intent | Gates MCP vs CLI appendix posture |
|
|
64
|
+
| Install target doc | Confirms user knows upstream steps |
|
|
65
|
+
|
|
66
|
+
## Output schema
|
|
67
|
+
|
|
68
|
+
### Primary output
|
|
69
|
+
|
|
70
|
+
- row table: Area | Status (`Ready` / `Needs input` / `Blocked`) | Owner action
|
|
71
|
+
- go / no-go summary
|
|
72
|
+
- one next skill (downstream domain planner if go; upstream remediation skill if no-go)
|
|
73
|
+
|
|
74
|
+
### Evidence / caveat output
|
|
75
|
+
|
|
76
|
+
```txt
|
|
77
|
+
Runtime status: Not Run | Attempted | Produced | Verified | Failed
|
|
78
|
+
Artifact status: Not Produced | Produced | Verified | Failed
|
|
79
|
+
Evidence used: <brief text, doc paths>
|
|
80
|
+
Limitations: <unknowns>
|
|
81
|
+
```
|
|
82
|
+
|
|
83
|
+
Truth-state rules:
|
|
84
|
+
|
|
85
|
+
* Artifact status defaults to `Not Produced`.
|
|
86
|
+
* States are downgrade-only (never upgrade).
|
|
87
|
+
* Preflight gating never executes packs, planners, or runtime, and never produces artifacts (a gate run alone stays `Runtime status: Not Run` and `Artifact status: Not Produced`).
|
|
88
|
+
|
|
89
|
+
## Required laws
|
|
90
|
+
|
|
91
|
+
- `../../laws/evidence-before-done.md`
|
|
92
|
+
- `../../laws/non-blender-user-language.md`
|
|
93
|
+
- `../../laws/no-arbitrary-python-interface.md`
|
|
94
|
+
- `../../laws/official-runtime-only.md`
|
|
95
|
+
|
|
96
|
+
## Official runtime boundary
|
|
97
|
+
|
|
98
|
+
Preflight gate only — never executes packs, domain planners, or Blender runtime. Uses the 2-path + CLI appendix model per `docs/runtime-stack-strategy.md`:
|
|
99
|
+
|
|
100
|
+
* Path 1 always implies the Lab MCP add-on inside Blender 5.1+; Connector is never standalone.
|
|
101
|
+
* Path 2 and CLI appendix require explicit scope caveats and readiness confirmation via `runtime-readiness`.
|
|
102
|
+
* Defer runtime detail to `runtime-readiness`, bridge conflicts to `bridge-conflicts`, and runtime errors to `blender-troubleshooting`.
|
|
103
|
+
|
|
104
|
+
## Operating procedure
|
|
105
|
+
|
|
106
|
+
1. Load matrix `references/prerequisite-matrix.md` and evaluate brief completeness, runtime posture, skill coverage, and evidence habits.
|
|
107
|
+
2. Mark each row `Ready`, `Needs input`, or `Blocked`; apply `references/blocked-start-playbook.md` for any `Blocked` row.
|
|
108
|
+
3. Emit `references/pack-readiness-template.md` with explicit go/no-go and downgrade-only truth states (gating never produces artifacts).
|
|
109
|
+
4. Recommend exactly one next skill: if go, hand off to the target domain planner; if no-go, hand off to the single blocking upstream skill (never run pack execution, runtime debugging, or license checks inside this skill).
|
|
110
|
+
|
|
111
|
+
## Decision tree
|
|
112
|
+
|
|
113
|
+
```txt
|
|
114
|
+
Is the user's goal ambiguous or is no recipe/pack selected yet?
|
|
115
|
+
Goal ambiguous → route to blendops-help (Rank 1)
|
|
116
|
+
Goal clear, no recipe/pack selected → route to recipe-fit-assessor (Rank 2)
|
|
117
|
+
Has preflight already passed and do stage/artifact inventories already exist?
|
|
118
|
+
Yes → route to workflow-stage-router (Rank 4)
|
|
119
|
+
No → evaluate the 7-row prerequisite matrix (`references/prerequisite-matrix.md`)
|
|
120
|
+
Are critical rows (Goal & scope, Deliverables, Evidence habit) all Ready?
|
|
121
|
+
No → verdict = NO-GO; apply `references/blocked-start-playbook.md` and route to the single blocking upstream skill:
|
|
122
|
+
- Brief incomplete → intent-to-3d-brief-writer
|
|
123
|
+
- Conflicting multi-deliverable scope → scope-guard
|
|
124
|
+
- Unchecked third-party asset licenses → asset-license-checker
|
|
125
|
+
- Active MCP bridge collision on port 9876 → bridge-conflicts
|
|
126
|
+
Yes → check whether immediate runtime mutation is requested:
|
|
127
|
+
- Planning-only start → verdict = GO (or GO with Warn on non-critical Needs input); route to target domain scene planner
|
|
128
|
+
- Immediate runtime mutation requested with unverified runtime posture → route to runtime-readiness
|
|
129
|
+
```
|
|
130
|
+
|
|
131
|
+
## Playbooks
|
|
132
|
+
|
|
133
|
+
### Playbook A: Ready-to-plan product hero preflight (`GO`)
|
|
134
|
+
|
|
135
|
+
- Score all 7 rows in `references/prerequisite-matrix.md` (`Goal & scope`, `Deliverables`, `Asset plan`, `Quality bar`, `Runtime posture`, `Evidence habit`, `Single-bridge`).
|
|
136
|
+
- Confirm critical rows are `Ready` and non-critical runtime rows are either `Ready` or `Needs input` (acceptable for pure planning entry).
|
|
137
|
+
- Emit `Summary: GO` using `references/pack-readiness-template.md`, keep `Runtime status: Not Run` and `Artifact status: Not Produced`, and name the single target domain planner (such as `../product-hero-scene-planner/SKILL.md`).
|
|
138
|
+
|
|
139
|
+
### Playbook B: Half-baked brief or unprioritized deliverables (`NO-GO`)
|
|
140
|
+
|
|
141
|
+
- Mark `Goal & scope` or `Deliverables` as `Blocked` in the prerequisite matrix.
|
|
142
|
+
- Follow `references/blocked-start-playbook.md`: block entry into scene planners, list the exact missing brief slots or conflicting deliverables, and recommend `../intent-to-3d-brief-writer/SKILL.md` as the single remediation skill.
|
|
143
|
+
- Preserve `Runtime status: Not Run` and `Artifact status: Not Produced`.
|
|
144
|
+
|
|
145
|
+
### Playbook C: Mid-pack jump with runtime or bridge confusion (`NO-GO`)
|
|
146
|
+
|
|
147
|
+
- When a user jumps directly to pack execution while both Path 1 and Path 2 bridges are enabled on port `9876` (or claims the Anthropic Connector works without Blender 5.1+ and the Lab add-on), mark `Runtime posture` / `Single-bridge` as `Blocked`.
|
|
148
|
+
- Route to `../bridge-conflicts/SKILL.md` or `../runtime-readiness/SKILL.md` before allowing any mutation-dependent pack step.
|
|
149
|
+
|
|
150
|
+
## Mode handling
|
|
151
|
+
|
|
152
|
+
### Text-only mode
|
|
153
|
+
|
|
154
|
+
Mark runtime rows as Needs input unless user supplied path choice.
|
|
155
|
+
|
|
156
|
+
### Runtime-ready mode
|
|
157
|
+
|
|
158
|
+
User-declared path must pair with `runtime-readiness` handoff suggestion.
|
|
159
|
+
|
|
160
|
+
### Blocked runtime mode
|
|
161
|
+
|
|
162
|
+
Still check non-runtime rows (brief, assets plan, evidence).
|
|
163
|
+
|
|
164
|
+
## Validation checklist
|
|
165
|
+
|
|
166
|
+
* [ ] Matrix covered across brief completeness, runtime posture, skill coverage, and evidence habits
|
|
167
|
+
* [ ] Every row marked `Ready`, `Needs input`, or `Blocked` with owner action for blocked/missing items
|
|
168
|
+
* [ ] Explicit go/no-go decision recorded
|
|
169
|
+
* [ ] Exactly one next skill named from the catalog
|
|
170
|
+
* [ ] Truth states follow downgrade-only rule with default `Not Produced` (no artifacts claimed by gate)
|
|
171
|
+
|
|
172
|
+
## Pass / Warn / Fail rubric
|
|
173
|
+
|
|
174
|
+
| Verdict | Criteria |
|
|
175
|
+
|---|---|
|
|
176
|
+
| Pass | All critical rows Ready |
|
|
177
|
+
| Warn | Non-critical gaps logged with acceptance |
|
|
178
|
+
| Fail | Critical row Blocked without mitigation |
|
|
179
|
+
|
|
180
|
+
## Failure handling
|
|
181
|
+
|
|
182
|
+
- If any critical prerequisite row (`Goal & scope`, `Deliverables`, `Evidence habit`) is `Blocked`, issue an explicit `NO-GO` verdict and route to the single upstream remediation skill from `references/blocked-start-playbook.md`.
|
|
183
|
+
- If the user claims `Artifact status: Verified` before the pack has even started, reject the upgraded truth state, reset `Artifact status: Not Produced` (downgrade-only), and mark `Evidence habit` as `Blocked` until acknowledged.
|
|
184
|
+
- If an active MCP port `9876` collision or dual-bridge setup is reported, halt preflight and hand off to `../bridge-conflicts/SKILL.md`.
|
|
185
|
+
- Never execute domain scene planning, asset license audits, or runtime debugging inside this gate skill.
|
|
186
|
+
|
|
187
|
+
## Troubleshooting
|
|
188
|
+
|
|
189
|
+
| Symptom | Cause | Safe resolution |
|
|
190
|
+
|---|---|---|
|
|
191
|
+
| User wants to start scene planning in text-only mode without Blender installed | `Runtime posture` is `Needs input`, but no runtime mutation is requested yet | Allow `Summary: GO` (with `Warn` note on `Runtime posture: Needs input`) if `Goal & scope`, `Deliverables`, and `Evidence habit` are `Ready`. |
|
|
192
|
+
| User assumes Claude Desktop Connector satisfies Path 1 prerequisites by itself | Standalone Connector misconception | Mark `Runtime posture` as `Needs input` / `Blocked`, state that Path 1 requires Blender 5.1+ plus the Lab MCP add-on inside Blender, and route readiness probing to `../runtime-readiness/SKILL.md`. |
|
|
193
|
+
| Multiple rows are `Blocked` simultaneously | User skipped both brief writing and asset planning | Order the minimum fixes per `references/blocked-start-playbook.md` and name the single earliest upstream blocker (`../intent-to-3d-brief-writer/SKILL.md`) as the immediate next skill. |
|
|
194
|
+
|
|
195
|
+
## Best practices
|
|
196
|
+
|
|
197
|
+
- Evaluate every row of `references/prerequisite-matrix.md` explicitly (`Ready`, `Needs input`, or `Blocked`) rather than giving an informal thumbs-up.
|
|
198
|
+
- Keep the gate output strictly decision-focused: one 7-row table, one `GO` / `NO-GO` verdict, and **one** immediate next skill from the catalog.
|
|
199
|
+
- Enforce `Artifact status: Not Produced` and `Runtime status: Not Run` as the default truth states for preflight gating.
|
|
200
|
+
- Always remind users of the single-bridge constraint (Path 1 and Path 2 cannot attach to the same Blender instance simultaneously).
|
|
201
|
+
|
|
202
|
+
## Good examples
|
|
203
|
+
|
|
204
|
+
- "`Pack / recipe: product-hero-v0` — All 7 matrix rows evaluated (`Goal & scope: Ready`, `Deliverables: Ready`, `Asset plan: Ready`, `Quality bar: Ready`, `Runtime posture: Needs input (planning-only)`, `Evidence habit: Ready`, `Single-bridge: Ready`). `Summary: GO`. Next skill: `../product-hero-scene-planner/SKILL.md`. `Runtime status: Not Run`. `Artifact status: Not Produced`."
|
|
205
|
+
- "`Pack / recipe: product-hero-v0` — `Goal & scope: Blocked` (missing camera framing and hero subject dimensions), `Deliverables: Needs input`. `Summary: NO-GO`. Next skill: `../intent-to-3d-brief-writer/SKILL.md`. `Runtime status: Not Run`. `Artifact status: Not Produced`."
|
|
206
|
+
|
|
207
|
+
## Bad examples
|
|
208
|
+
|
|
209
|
+
- "`Summary: GO` — Brief is still vague, we will figure out deliverables and licenses during rendering. Next skills: `product-hero-scene-planner`, `lighting-material-plan`, and `render-export-evidence`." — bypasses blocked critical rows and recommends multiple skills at once.
|
|
210
|
+
- "`Summary: GO` — Preflight passed so `Runtime status: Verified` and `Artifact status: Produced`." — fabricates runtime and artifact truth states from a planning gate.
|
|
211
|
+
- "I inspected your third-party FBX EULA and cleared the license." — overreaches into `asset-license-checker`.
|
|
212
|
+
|
|
213
|
+
## User-facing response template
|
|
214
|
+
|
|
215
|
+
```txt
|
|
216
|
+
Pack / recipe: <target pack or recipe name>
|
|
217
|
+
|
|
218
|
+
Prerequisite matrix:
|
|
219
|
+
| Area | Status | Notes / owner action |
|
|
220
|
+
|---|---|---|
|
|
221
|
+
| Goal & scope | <Ready | Needs input | Blocked> | <notes / action> |
|
|
222
|
+
| Deliverables | <Ready | Needs input | Blocked> | <notes / action> |
|
|
223
|
+
| Asset plan | <Ready | Needs input | Blocked> | <notes / action> |
|
|
224
|
+
| Quality bar | <Ready | Needs input | Blocked> | <notes / action> |
|
|
225
|
+
| Runtime posture | <Ready | Needs input | Blocked> | <notes / action> |
|
|
226
|
+
| Evidence habit | <Ready | Needs input | Blocked> | <notes / action> |
|
|
227
|
+
| Single-bridge | <Ready | Needs input | Blocked> | <notes / action> |
|
|
228
|
+
|
|
229
|
+
Summary: <GO | NO-GO>
|
|
230
|
+
Minimum fixes (if NO-GO): <ordered list or none>
|
|
231
|
+
Recommended next skill: <single catalog skill path>
|
|
232
|
+
Runtime status: Not Run
|
|
233
|
+
Artifact status: Not Produced
|
|
234
|
+
Evidence used: <brief text and pack/recipe doc paths>
|
|
235
|
+
Limitations: <unverified runtime or asset assumptions>
|
|
236
|
+
```
|
|
237
|
+
|
|
238
|
+
## Anti-patterns
|
|
239
|
+
|
|
240
|
+
- Authorizing `Summary: GO` when `Goal & scope`, `Deliverables`, or `Evidence habit` is `Blocked`.
|
|
241
|
+
- Recommending three or four downstream skills simultaneously instead of naming **one** immediate next skill.
|
|
242
|
+
- Writing `Artifact status: Not Run` or upgrading truth states (`Produced` / `Verified`) as a side effect of passing preflight.
|
|
243
|
+
- Treating the Anthropic Connector as a standalone Path 1 setup that skips the Blender 5.1+ Lab MCP add-on.
|
|
244
|
+
- Performing deep MCP diagnostics, scene planning, or legal license review inside `pack-prerequisite-checker`.
|
|
245
|
+
|
|
246
|
+
## Cross-skill handoff
|
|
247
|
+
<!-- blendops:generated:start handoffs -->
|
|
248
|
+
- [upstream_reference] Recipe selection → `../recipe-fit-assessor/SKILL.md`
|
|
249
|
+
- [fallback] Brief completeness → `../intent-to-3d-brief-writer/SKILL.md`
|
|
250
|
+
- [conditional] Runtime detail → `../runtime-readiness/SKILL.md`
|
|
251
|
+
- [fallback] Bridge conflicts → `../bridge-conflicts/SKILL.md`
|
|
252
|
+
- [fallback] Runtime debugging → `../blender-troubleshooting/SKILL.md`
|
|
253
|
+
- [conditional] License checks → `../asset-license-checker/SKILL.md`
|
|
254
|
+
- [alternative] Domain planner (product hero when Go) → `../product-hero-scene-planner/SKILL.md`
|
|
255
|
+
- [alternative] Domain planner (product grid when Go) → `../product-grid-scene-planner/SKILL.md`
|
|
256
|
+
- [alternative] Domain planner (character portrait when Go) → `../character-portrait/SKILL.md`
|
|
257
|
+
- [alternative] Domain planner (environment establishing shot when Go) → `../environment-shot/SKILL.md`
|
|
258
|
+
- [alternative] Domain planner (interior architectural when Go) → `../interior-scene/SKILL.md`
|
|
259
|
+
<!-- blendops:generated:end handoffs -->
|
|
260
|
+
|
|
261
|
+
## Non-goals
|
|
262
|
+
|
|
263
|
+
- Scoring which recipe or pack fits the user's initial idea (use `../recipe-fit-assessor/SKILL.md`).
|
|
264
|
+
- Routing active mid-flight workflows that already passed preflight (use `../workflow-stage-router/SKILL.md`).
|
|
265
|
+
- Writing the 8-slot 3D brief, planning scene geometry/lighting, or auditing asset licenses directly.
|
|
266
|
+
- Running Blender, configuring MCP hosts, or verifying rendered/exported files.
|
|
267
|
+
|
|
268
|
+
## References
|
|
269
|
+
|
|
270
|
+
* `references/prerequisite-matrix.md`
|
|
271
|
+
* `references/blocked-start-playbook.md`
|
|
272
|
+
* `references/pack-readiness-template.md`
|
|
@@ -0,0 +1,214 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$schema": "../../schemas/skill-contract.schema.json",
|
|
3
|
+
"id": "pack-prerequisite-checker",
|
|
4
|
+
"version": "1.0.0",
|
|
5
|
+
"category": "routing-and-governance",
|
|
6
|
+
"role": "pack-preflight-readiness-gate",
|
|
7
|
+
"purpose": "Verify brief, runtime posture, skill coverage, and evidence habits before starting a BlendOps workflow pack, then emit a Go/No-Go decision and single next skill.",
|
|
8
|
+
"capabilityTier": "L0",
|
|
9
|
+
"routingPrecedence": {
|
|
10
|
+
"group": "entry-and-stage-routing",
|
|
11
|
+
"rank": 3,
|
|
12
|
+
"activationGate": {
|
|
13
|
+
"goalClarity": "clear",
|
|
14
|
+
"recipeSelected": true,
|
|
15
|
+
"preflightPassed": false,
|
|
16
|
+
"hasStageOrArtifactInventory": false
|
|
17
|
+
}
|
|
18
|
+
},
|
|
19
|
+
"triggers": [
|
|
20
|
+
"are we ready to start",
|
|
21
|
+
"pre-flight for the pack",
|
|
22
|
+
"what's missing before we build",
|
|
23
|
+
"check prerequisites"
|
|
24
|
+
],
|
|
25
|
+
"exclusions": [
|
|
26
|
+
{
|
|
27
|
+
"condition": "Goal or entry point is ambiguous and no pack is chosen yet",
|
|
28
|
+
"delegateTo": "blendops-help",
|
|
29
|
+
"reason": "Triages ambiguous entry requests at precedence Rank 1"
|
|
30
|
+
},
|
|
31
|
+
{
|
|
32
|
+
"condition": "Evaluating which recipe or pack fits the user's goal",
|
|
33
|
+
"delegateTo": "recipe-fit-assessor",
|
|
34
|
+
"reason": "Scores candidate recipes/packs at precedence Rank 2 before preflight"
|
|
35
|
+
},
|
|
36
|
+
{
|
|
37
|
+
"condition": "Workflow is already past preflight with existing stage or artifact inventory",
|
|
38
|
+
"delegateTo": "workflow-stage-router",
|
|
39
|
+
"reason": "Routes in-flight workflows at precedence Rank 4"
|
|
40
|
+
},
|
|
41
|
+
{
|
|
42
|
+
"condition": "Detailed Blender MCP runtime connection preflight",
|
|
43
|
+
"delegateTo": "runtime-readiness",
|
|
44
|
+
"reason": "Inspects Path 1 or Path 2 runtime readiness in detail"
|
|
45
|
+
},
|
|
46
|
+
{
|
|
47
|
+
"condition": "Active MCP bridge port or add-on session conflicts",
|
|
48
|
+
"delegateTo": "bridge-conflicts",
|
|
49
|
+
"reason": "Resolves port 9876 and dual-bridge conflicts"
|
|
50
|
+
},
|
|
51
|
+
{
|
|
52
|
+
"condition": "Debugging Blender scene or runtime execution errors",
|
|
53
|
+
"delegateTo": "blender-troubleshooting",
|
|
54
|
+
"reason": "Diagnoses runtime or scene failures"
|
|
55
|
+
},
|
|
56
|
+
{
|
|
57
|
+
"condition": "Auditing external 3D asset license compliance",
|
|
58
|
+
"delegateTo": "asset-license-checker",
|
|
59
|
+
"reason": "Performs dedicated asset license and provenance verification"
|
|
60
|
+
}
|
|
61
|
+
],
|
|
62
|
+
"inputs": {
|
|
63
|
+
"required": [
|
|
64
|
+
{
|
|
65
|
+
"name": "target_pack_id",
|
|
66
|
+
"type": "string",
|
|
67
|
+
"description": "Selected BlendOps pack or recipe identifier (e.g., product-hero-v0)"
|
|
68
|
+
},
|
|
69
|
+
{
|
|
70
|
+
"name": "current_brief_status",
|
|
71
|
+
"type": "object",
|
|
72
|
+
"description": "Current 3D brief completeness across subject, destination, and constraints"
|
|
73
|
+
}
|
|
74
|
+
],
|
|
75
|
+
"optional": [
|
|
76
|
+
{
|
|
77
|
+
"name": "declared_runtime_posture",
|
|
78
|
+
"type": "string",
|
|
79
|
+
"description": "Whether the session is text-only planning or targets Path 1 / Path 2 / CLI"
|
|
80
|
+
}
|
|
81
|
+
]
|
|
82
|
+
},
|
|
83
|
+
"outputs": {
|
|
84
|
+
"primary": [
|
|
85
|
+
"prerequisite_matrix_rows",
|
|
86
|
+
"go_no_go_verdict",
|
|
87
|
+
"single_next_skill"
|
|
88
|
+
],
|
|
89
|
+
"truthStatePolicy": {
|
|
90
|
+
"runtimeDefault": "Not Run",
|
|
91
|
+
"artifactDefault": "Not Produced",
|
|
92
|
+
"mutationRule": "downgrade_only"
|
|
93
|
+
}
|
|
94
|
+
},
|
|
95
|
+
"handoffs": [
|
|
96
|
+
{
|
|
97
|
+
"target": "recipe-fit-assessor",
|
|
98
|
+
"type": "upstream_reference",
|
|
99
|
+
"label": "Recipe selection",
|
|
100
|
+
"when": {
|
|
101
|
+
"all": [
|
|
102
|
+
{ "field": "recipe.selected", "operator": "equals", "value": false }
|
|
103
|
+
]
|
|
104
|
+
}
|
|
105
|
+
},
|
|
106
|
+
{
|
|
107
|
+
"target": "intent-to-3d-brief-writer",
|
|
108
|
+
"type": "fallback",
|
|
109
|
+
"label": "Brief completeness",
|
|
110
|
+
"when": {
|
|
111
|
+
"all": [
|
|
112
|
+
{ "field": "brief.complete", "operator": "equals", "value": false }
|
|
113
|
+
]
|
|
114
|
+
}
|
|
115
|
+
},
|
|
116
|
+
{
|
|
117
|
+
"target": "runtime-readiness",
|
|
118
|
+
"type": "conditional",
|
|
119
|
+
"label": "Runtime detail",
|
|
120
|
+
"when": {
|
|
121
|
+
"all": [
|
|
122
|
+
{ "field": "runtime.mode", "operator": "equals", "value": "runtime_requested" },
|
|
123
|
+
{ "field": "runtime.verifiedReady", "operator": "equals", "value": false }
|
|
124
|
+
]
|
|
125
|
+
}
|
|
126
|
+
},
|
|
127
|
+
{
|
|
128
|
+
"target": "bridge-conflicts",
|
|
129
|
+
"type": "fallback",
|
|
130
|
+
"label": "Bridge conflicts",
|
|
131
|
+
"when": {
|
|
132
|
+
"all": [
|
|
133
|
+
{ "field": "runtime.conflictDetected", "operator": "equals", "value": true }
|
|
134
|
+
]
|
|
135
|
+
}
|
|
136
|
+
},
|
|
137
|
+
{
|
|
138
|
+
"target": "blender-troubleshooting",
|
|
139
|
+
"type": "fallback",
|
|
140
|
+
"label": "Runtime debugging",
|
|
141
|
+
"when": {
|
|
142
|
+
"all": [
|
|
143
|
+
{ "field": "runtime.errorDetected", "operator": "equals", "value": true }
|
|
144
|
+
]
|
|
145
|
+
}
|
|
146
|
+
},
|
|
147
|
+
{
|
|
148
|
+
"target": "asset-license-checker",
|
|
149
|
+
"type": "conditional",
|
|
150
|
+
"label": "License checks",
|
|
151
|
+
"when": {
|
|
152
|
+
"all": [
|
|
153
|
+
{ "field": "assets.externalUsed", "operator": "equals", "value": true },
|
|
154
|
+
{ "field": "assets.licenseCleared", "operator": "equals", "value": false }
|
|
155
|
+
]
|
|
156
|
+
}
|
|
157
|
+
},
|
|
158
|
+
{
|
|
159
|
+
"target": "product-hero-scene-planner",
|
|
160
|
+
"type": "alternative",
|
|
161
|
+
"label": "Domain planner (product hero when Go)",
|
|
162
|
+
"when": {
|
|
163
|
+
"all": [
|
|
164
|
+
{ "field": "preflight.verdict", "operator": "equals", "value": "go" },
|
|
165
|
+
{ "field": "recipe.domain", "operator": "equals", "value": "product_hero" }
|
|
166
|
+
]
|
|
167
|
+
}
|
|
168
|
+
},
|
|
169
|
+
{
|
|
170
|
+
"target": "product-grid-scene-planner",
|
|
171
|
+
"type": "alternative",
|
|
172
|
+
"label": "Domain planner (product grid when Go)",
|
|
173
|
+
"when": {
|
|
174
|
+
"all": [
|
|
175
|
+
{ "field": "preflight.verdict", "operator": "equals", "value": "go" },
|
|
176
|
+
{ "field": "recipe.domain", "operator": "equals", "value": "product_grid" }
|
|
177
|
+
]
|
|
178
|
+
}
|
|
179
|
+
},
|
|
180
|
+
{
|
|
181
|
+
"target": "character-portrait",
|
|
182
|
+
"type": "alternative",
|
|
183
|
+
"label": "Domain planner (character portrait when Go)",
|
|
184
|
+
"when": {
|
|
185
|
+
"all": [
|
|
186
|
+
{ "field": "preflight.verdict", "operator": "equals", "value": "go" },
|
|
187
|
+
{ "field": "recipe.domain", "operator": "equals", "value": "character_portrait" }
|
|
188
|
+
]
|
|
189
|
+
}
|
|
190
|
+
},
|
|
191
|
+
{
|
|
192
|
+
"target": "environment-shot",
|
|
193
|
+
"type": "alternative",
|
|
194
|
+
"label": "Domain planner (environment establishing shot when Go)",
|
|
195
|
+
"when": {
|
|
196
|
+
"all": [
|
|
197
|
+
{ "field": "preflight.verdict", "operator": "equals", "value": "go" },
|
|
198
|
+
{ "field": "recipe.domain", "operator": "equals", "value": "environment_shot" }
|
|
199
|
+
]
|
|
200
|
+
}
|
|
201
|
+
},
|
|
202
|
+
{
|
|
203
|
+
"target": "interior-scene",
|
|
204
|
+
"type": "alternative",
|
|
205
|
+
"label": "Domain planner (interior architectural when Go)",
|
|
206
|
+
"when": {
|
|
207
|
+
"all": [
|
|
208
|
+
{ "field": "preflight.verdict", "operator": "equals", "value": "go" },
|
|
209
|
+
{ "field": "recipe.domain", "operator": "equals", "value": "interior_archviz" }
|
|
210
|
+
]
|
|
211
|
+
}
|
|
212
|
+
}
|
|
213
|
+
]
|
|
214
|
+
}
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
# Blocked Start Playbook
|
|
2
|
+
|
|
3
|
+
## Purpose
|
|
4
|
+
Prevent downstream planning or execution skills from wasting work or assuming unverified facts when pack prerequisites fail. Every `Blocked` gate routes cleanly to one specific remediation skill and stops further progression.
|
|
5
|
+
|
|
6
|
+
## Blocker Routing Playbook
|
|
7
|
+
|
|
8
|
+
| Blocked Prerequisite Area | Symptoms / Missing Evidence | Immediate Stop Action | Route Next To | Minimum Unlock Condition |
|
|
9
|
+
|---|---|---|---|---|
|
|
10
|
+
| **Incomplete Brief / Ambiguous Subject** | Missing deliverable format, target platform, or unclarified hero subject | Halt all scene, camera, lighting, and recipe planning | `intent-to-3d-brief-writer` (or `blender-brainstorming` if scope itself unclear) | All required brief slots populated (`Subject`, `Outputs`, `Constraints`) |
|
|
11
|
+
| **Runtime Unknown on Execution Request** | User asks to render, mutate `.blend`, or export `.glb` right now without selected path | Refuse runtime commands; mark `Runtime status: Not Run` | `runtime-path-picker` -> `runtime-setup` -> `runtime-readiness` | Explicit path (`Path 1` / `Path 2` / `CLI fallback`) selected and verified |
|
|
12
|
+
| **Unverified Asset / Stock Licenses** | External meshes, HDRIs, or textures planned for commercial release with missing license terms | Block asset import / pack handoff; flag commercial risk | `asset-license-checker` | Every external asset tagged (`CC0`, `CC-BY` attribution recorded, or custom-made) |
|
|
13
|
+
| **Conflicting Deliverables / Scope Creep** | User demands `4K Cycles film + <1MB mobile GLB + 6 animations` simultaneously with no priority | Freeze planning; surface exact budget/pipeline contradiction | `scope-guard` | Explicit `P0` primary deliverable locked; incompatible asks deferred to a follow-up milestone |
|
|
14
|
+
| **Dual-Bridge / Port `9876` Collision** | Path 1 Lab MCP and Path 2 `mcp-for-blender` both enabled, or stale socket occupies `9876` | Block MCP commands immediately to avoid split-brain scene edits | `bridge-conflicts` | Exactly one active bridge verified running on clean host configuration |
|
|
15
|
+
|
|
16
|
+
## Non-Bypass Policy
|
|
17
|
+
- Never downgrade a `Blocked` gate to `Ready` based on verbal assumptions ("user probably has Blender 5.1+").
|
|
18
|
+
- When switching to **planning-only mode** (`Runtime status: Not Run`, `Artifact status: Not Produced`), document runtime absence honestly as `Not Run (planning-only)` instead of pretending execution is unblocked.
|
|
19
|
+
|
|
20
|
+
## Related skill
|
|
21
|
+
[../SKILL.md](../SKILL.md)
|
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
# Pack Readiness Output Template
|
|
2
|
+
|
|
3
|
+
Use this exact structured readiness report format when concluding `pack-prerequisite-checker`. Replace placeholders with observed inputs (`Ready`, `Needs input`, or `Blocked`) and preserve canonical `Runtime status` / `Artifact status` truth labels.
|
|
4
|
+
|
|
5
|
+
```txt
|
|
6
|
+
Pack / recipe: <pack-or-recipe-slug> (e.g. packs/product-hero-v0/PACK.md)
|
|
7
|
+
|
|
8
|
+
| Area | Status | Notes / Required Owner Action |
|
|
9
|
+
|---|---|---|
|
|
10
|
+
| Goal & scope | Ready / Needs input / Blocked | <brief clarity, target audience, single primary deliverable> |
|
|
11
|
+
| Deliverables & format | Ready / Needs input / Blocked | <still PNG / turntable / .glb / web target specified> |
|
|
12
|
+
| Asset & license plan | Ready / Needs input / Blocked | <procedural vs licensed external assets; CC0/CC-BY clearance> |
|
|
13
|
+
| Quality & budget bar | Ready / Needs input / Blocked | <polycount, texture size, color pipeline AgX/PBR Neutral> |
|
|
14
|
+
| Runtime posture | Ready (planning-only) / Needs input / Blocked | <Path 1 / Path 2 / CLI fallback or explicit planning-only mode> |
|
|
15
|
+
| Single-bridge check | Clear / Needs check / Blocked | <confirm Path 1 & Path 2 are not concurrently active> |
|
|
16
|
+
| Evidence habit | Active | <truth labels locked: Not Run / Not Produced until real files exist> |
|
|
17
|
+
|
|
18
|
+
Pack gate verdict: GO | CONDITIONAL-GO (planning-only) | NO-GO
|
|
19
|
+
|
|
20
|
+
If NO-GO (minimum fixes in strict order):
|
|
21
|
+
1. <first blocker + target skill slug>
|
|
22
|
+
2. <second blocker + target skill slug>
|
|
23
|
+
|
|
24
|
+
If GO / CONDITIONAL-GO:
|
|
25
|
+
Next skill: <exact next skill slug, e.g. product-hero-scene-planner>
|
|
26
|
+
|
|
27
|
+
Truth boundary:
|
|
28
|
+
Runtime status: <Not Run | Attempted | Verified | Failed>
|
|
29
|
+
Artifact status: <Not Produced | Produced | Verified | Failed>
|
|
30
|
+
```
|
|
31
|
+
|
|
32
|
+
## Usage Rules
|
|
33
|
+
- Issue **`GO`** only when every planning gate is `Ready` and runtime readiness matches the user's mode.
|
|
34
|
+
- Issue **`CONDITIONAL-GO (planning-only)`** when the user explicitly wants scene/camera/lighting plans only (`Runtime status: Not Run`, `Artifact status: Not Produced`).
|
|
35
|
+
- Issue **`NO-GO`** if any `Blocked` row exists; never skip directly to scene mutation.
|
|
36
|
+
|
|
37
|
+
## Related skill
|
|
38
|
+
[../SKILL.md](../SKILL.md)
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
# Pack Prerequisite Matrix
|
|
2
|
+
|
|
3
|
+
Score every prerequisite row **`Ready`**, **`Needs input`**, or **`Blocked`** before starting a pack workflow.
|
|
4
|
+
|
|
5
|
+
| Area | Verification Questions | Critical Gate? | Route If Incomplete |
|
|
6
|
+
|---|---|---|---|
|
|
7
|
+
| **Goal & Brief Lock** | Subject dimensions, key visual mood, camera targets, and consumer pipeline locked in `intent-to-3d-brief-writer`? | **YES (Execution)** | `blender-brainstorming` → `intent-to-3d-brief-writer` |
|
|
8
|
+
| **Deliverables Priority** | Still (`PNG`/`EXR`), turntable, animated rig, and/or `.glb` web targets ranked (`Must` vs `Nice`)? | **YES (Execution)** | `output-format-decision` / `resolution-aspect-decision` |
|
|
9
|
+
| **Asset & License Plan** | Procedural vs external library vs kitbash decided, with license & style checks scheduled? | **YES (External Assets)** | `asset-discovery` → `asset-license-checker` |
|
|
10
|
+
| **Quality & Color Gates** | Poly/texture budgets, PBR sanity, and View Transform (`AgX` vs `Khronos PBR Neutral`) pinned? | Optional for early rough draft; **YES before export** | `polycount-budget-checker` / `color-management-decision` |
|
|
11
|
+
| **Runtime Posture** | Path 1 (`Lab MCP 5.1+`, Host a/b), Path 2 (`mcp-for-blender 3.0+`), or CLI fallback stated explicitly? Connector never standalone. | Conditional (`Needs input` OK in pure planning mode) | `runtime-path-picker` → `runtime-setup` |
|
|
12
|
+
| **Single-Bridge Invariant** | Confirmed Path 1 and Path 2 are **not** concurrently enabled inside the same Blender session? | **YES (Runtime)** | `bridge-conflicts` |
|
|
13
|
+
| **Evidence Discipline** | Stakeholder agrees `Not Run` / `Not Produced` stay default until concrete evidence files exist? | **YES (Always)** | `laws/evidence-before-done.md` |
|
|
14
|
+
|
|
15
|
+
## Gate Verdict Rule
|
|
16
|
+
- Any **`Blocked`** critical row stops downstream execution planning until resolved (`blocked-start-playbook.md`).
|
|
17
|
+
- Pure planning workflows may advance with Runtime Posture = `Needs input`, provided all outputs remain explicitly labeled `Runtime status: Not Run`.
|
|
18
|
+
|
|
19
|
+
## Related skill
|
|
20
|
+
- [SKILL.md](../SKILL.md)
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
# EVAL — path-one-host-outline
|
|
2
|
+
|
|
3
|
+
## Text-only eval prompt
|
|
4
|
+
|
|
5
|
+
User has Claude Desktop and wants Path 1. Outline hosts.
|
|
6
|
+
|
|
7
|
+
## Expected behavior
|
|
8
|
+
|
|
9
|
+
- State Blender Lab MCP add-on inside Blender 5.1+ first
|
|
10
|
+
- Describe Connector as hosting Path 1 after Blender-side steps
|
|
11
|
+
- Mention manual MCP alternative for other agents
|
|
12
|
+
- Link-style pointer to install doc
|
|
13
|
+
|
|
14
|
+
## Pass / Warn / Fail criteria
|
|
15
|
+
|
|
16
|
+
- Pass: ordering + (a)/(b) hosts
|
|
17
|
+
- Warn: OS unknown — note verify paths
|
|
18
|
+
- Fail: Connector-only narrative
|
|
19
|
+
|
|
20
|
+
## Sample passing response outline
|
|
21
|
+
|
|
22
|
+
- Numbered Blender-side vs host-side
|
|
23
|
+
|
|
24
|
+
## Sample failing response outline
|
|
25
|
+
|
|
26
|
+
- "Enable Connector and you're done"
|