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,92 @@
|
|
|
1
|
+
# Workflow: product-hero-workflow
|
|
2
|
+
|
|
3
|
+
Status: 1.0.0
|
|
4
|
+
|
|
5
|
+
## Trigger
|
|
6
|
+
|
|
7
|
+
Use this workflow when a non-Blender user asks for a product hero 3D output with web-ready handoff expectations.
|
|
8
|
+
|
|
9
|
+
## Inputs
|
|
10
|
+
|
|
11
|
+
- natural-language user prompt
|
|
12
|
+
- target output context (web/app/game/render)
|
|
13
|
+
- optional visual/style/performance constraints
|
|
14
|
+
|
|
15
|
+
## Laws applied
|
|
16
|
+
|
|
17
|
+
- [../../laws/official-runtime-only.md](../../laws/official-runtime-only.md)
|
|
18
|
+
- [../../laws/no-arbitrary-python-interface.md](../../laws/no-arbitrary-python-interface.md)
|
|
19
|
+
- [../../laws/evidence-before-done.md](../../laws/evidence-before-done.md)
|
|
20
|
+
- [../../laws/non-blender-user-language.md](../../laws/non-blender-user-language.md)
|
|
21
|
+
|
|
22
|
+
## Skills composed
|
|
23
|
+
|
|
24
|
+
- [../../skills/runtime-setup/SKILL.md](../../skills/runtime-setup/SKILL.md)
|
|
25
|
+
- [../../skills/product-hero-scene-planner/SKILL.md](../../skills/product-hero-scene-planner/SKILL.md)
|
|
26
|
+
- [../../skills/scene-readiness/SKILL.md](../../skills/scene-readiness/SKILL.md)
|
|
27
|
+
- [../../skills/glb-web-handoff/SKILL.md](../../skills/glb-web-handoff/SKILL.md)
|
|
28
|
+
- [../../skills/plain-language-response/SKILL.md](../../skills/plain-language-response/SKILL.md)
|
|
29
|
+
|
|
30
|
+
## Stages
|
|
31
|
+
|
|
32
|
+
> [!NOTE]
|
|
33
|
+
> These are workflow stages (per-run pipeline steps). Project roadmap and release checks live in [`TODO.md`](../../TODO.md).
|
|
34
|
+
|
|
35
|
+
### Stage 1 — Runtime readiness gate
|
|
36
|
+
- Confirm official runtime path selection.
|
|
37
|
+
- Capture source confidence (`verified-read` or `linked-only`).
|
|
38
|
+
- Block workflow if official runtime prerequisites are not acknowledged.
|
|
39
|
+
|
|
40
|
+
### Stage 2 — Intent and plan
|
|
41
|
+
- Normalize intent.
|
|
42
|
+
- Ask minimal clarification questions.
|
|
43
|
+
- Build scene plan: composition, lighting, materials, camera, handoff intent.
|
|
44
|
+
|
|
45
|
+
### Stage 3 — Quality gate
|
|
46
|
+
- Apply pass/warn/fail checks against requested intent.
|
|
47
|
+
- Identify blockers and unresolved risks.
|
|
48
|
+
|
|
49
|
+
### Stage 4 — GLB/web handoff gate
|
|
50
|
+
- Prepare handoff expectation report.
|
|
51
|
+
- Record compatibility assumptions and caveats.
|
|
52
|
+
|
|
53
|
+
### Stage 5 — Final non-Blender-user response
|
|
54
|
+
- Produce plain-language status and next actions.
|
|
55
|
+
|
|
56
|
+
## Outputs
|
|
57
|
+
|
|
58
|
+
- intent summary
|
|
59
|
+
- scene plan
|
|
60
|
+
- quality gate report
|
|
61
|
+
- GLB/web handoff report
|
|
62
|
+
- final user-facing plain-language response
|
|
63
|
+
|
|
64
|
+
## Validation gates
|
|
65
|
+
|
|
66
|
+
- Gate A: official runtime-only references present
|
|
67
|
+
- Gate B: scene plan completeness
|
|
68
|
+
- Gate C: quality checklist status assigned
|
|
69
|
+
- Gate D: handoff caveat transparency
|
|
70
|
+
- Gate E: non-Blender-user readability check
|
|
71
|
+
|
|
72
|
+
## Failure modes
|
|
73
|
+
|
|
74
|
+
- runtime prerequisites unclear
|
|
75
|
+
- prompt ambiguity unresolved
|
|
76
|
+
- insufficient evidence for readiness claims
|
|
77
|
+
- handoff compatibility uncertainty
|
|
78
|
+
|
|
79
|
+
## Runtime evidence expectations
|
|
80
|
+
|
|
81
|
+
Every run must capture:
|
|
82
|
+
- selected official runtime path
|
|
83
|
+
- source confidence level
|
|
84
|
+
- what was verified vs what remains linked-only
|
|
85
|
+
- text-only dry-eval marker when runtime is not executed (`Runtime status: Not Run`, `Artifact status: Not Produced`)
|
|
86
|
+
|
|
87
|
+
## Final response format
|
|
88
|
+
|
|
89
|
+
1. What you asked for
|
|
90
|
+
2. What is ready now
|
|
91
|
+
3. What is not fully verified yet
|
|
92
|
+
4. Recommended next step
|
package/laws/README.md
ADDED
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
# BlendOps Laws Collection
|
|
2
|
+
|
|
3
|
+
> [!NOTE]
|
|
4
|
+
> Status: 1.0.0. These laws are shared guardrails for installable Blender skills in `skills/` and pack manifests in `packs/`.
|
|
5
|
+
|
|
6
|
+
## Law index
|
|
7
|
+
|
|
8
|
+
| Law | Doc | Protects |
|
|
9
|
+
|---|---|---|
|
|
10
|
+
| Official runtime only | [official-runtime-only](./official-runtime-only.md) | Keeps BlendOps aligned to official runtime paths only |
|
|
11
|
+
| No arbitrary Python interface | [no-arbitrary-python-interface](./no-arbitrary-python-interface.md) | Prevents arbitrary Python from becoming the user-facing workflow |
|
|
12
|
+
| Evidence before done | [evidence-before-done](./evidence-before-done.md) | Blocks artifact and runtime overclaims without evidence |
|
|
13
|
+
| Non-Blender-user language | [non-blender-user-language](./non-blender-user-language.md) | Keeps outputs clear for users who don't know Blender internals |
|
|
14
|
+
|
|
15
|
+
## Scope
|
|
16
|
+
|
|
17
|
+
| Applies to | Requirement |
|
|
18
|
+
|---|---|
|
|
19
|
+
| Root-level skill units | Follow every relevant law during planning, validation, handoff, and final response. |
|
|
20
|
+
| Pack manifests | Include laws explicitly and preserve their constraints. |
|
|
21
|
+
| User-facing outputs | State artifact/runtime status truthfully and in plain language. |
|
|
22
|
+
| Install docs | Preserve no-runtime and no-global-config-by-default constraints. |
|
|
23
|
+
|
|
24
|
+
## Status block
|
|
25
|
+
|
|
26
|
+
| Field | Value |
|
|
27
|
+
|---|---|
|
|
28
|
+
| Collection status | 1.0.0 |
|
|
29
|
+
| Runtime posture | Official-runtime-only |
|
|
30
|
+
| Runtime install | Not included |
|
|
31
|
+
| Runtime execution guarantee | Not claimed |
|
|
32
|
+
| Promotion requirement | Review and eval evidence must be recorded before any runtime/artifact claim |
|
|
@@ -0,0 +1,37 @@
|
|
|
1
|
+
# Law: evidence-before-done
|
|
2
|
+
|
|
3
|
+
Status: 1.0.0
|
|
4
|
+
|
|
5
|
+
## Purpose
|
|
6
|
+
Block readiness/success claims that are not backed by evidence.
|
|
7
|
+
|
|
8
|
+
## Applies to
|
|
9
|
+
All skills/workflows/evals/pack outputs.
|
|
10
|
+
|
|
11
|
+
## Must do
|
|
12
|
+
- include artifact status (`Not Produced`, `Produced`, `Verified`, `Failed`)
|
|
13
|
+
- include runtime status (`Not Run`, `Attempted`, `Produced`, `Verified`, `Failed`)
|
|
14
|
+
- include verification outcomes
|
|
15
|
+
- include caveats for unresolved checks
|
|
16
|
+
|
|
17
|
+
## Canonical truth states
|
|
18
|
+
- Runtime status: `Not Run`, `Attempted`, `Produced`, `Verified`, `Failed`.
|
|
19
|
+
- Artifact status: `Not Produced` by default; allowed values are `Not Produced`, `Produced`, `Verified`, `Failed` (`Not Run` is never an Artifact status).
|
|
20
|
+
- Do not invent other runtime states; a blocked environment stays `Not Run` (nothing attempted) or `Attempted` (started but incomplete).
|
|
21
|
+
|
|
22
|
+
## Must not do
|
|
23
|
+
- must not claim preview/render/GLB exists without evidence
|
|
24
|
+
- must not mark Ready if evidence is missing
|
|
25
|
+
|
|
26
|
+
## Blocking conditions
|
|
27
|
+
- success claim appears without artifact/evidence section
|
|
28
|
+
|
|
29
|
+
## Validation
|
|
30
|
+
- pass/warn/fail present
|
|
31
|
+
- final verdict maps to evidence state
|
|
32
|
+
|
|
33
|
+
## Good example
|
|
34
|
+
“Status: Conditionally Ready. Plan complete; Runtime status: Not Run; Artifact status: Not Produced.”
|
|
35
|
+
|
|
36
|
+
## Bad example
|
|
37
|
+
“Everything exported and ready.” (no evidence)
|
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
# Law: no-arbitrary-python-interface
|
|
2
|
+
|
|
3
|
+
Status: 1.0.0
|
|
4
|
+
|
|
5
|
+
## Purpose
|
|
6
|
+
Prevent arbitrary-code style final interfaces in user-facing BlendOps outputs.
|
|
7
|
+
|
|
8
|
+
This law governs the product surface, not execution sandboxing: it bans "paste this Python" as the user-facing flow, but it does not cover operator-side sandbox hygiene (trusted environment, secrets handling). Sandbox guidance lives in `runtime-readiness` and `runtime-attempt-report`.
|
|
9
|
+
|
|
10
|
+
## Applies to
|
|
11
|
+
All skills/workflows/pack outputs.
|
|
12
|
+
|
|
13
|
+
## Must do
|
|
14
|
+
- keep outputs workflow- and validation-driven
|
|
15
|
+
- keep runtime execution external and evidence-bound
|
|
16
|
+
|
|
17
|
+
## Must not do
|
|
18
|
+
- must not present arbitrary Python execution as final user interface
|
|
19
|
+
- must not bypass law/validation gates with opaque low-level execution guidance
|
|
20
|
+
|
|
21
|
+
## Blocking conditions
|
|
22
|
+
- output recommends arbitrary-code interface as normal user flow
|
|
23
|
+
|
|
24
|
+
## Validation
|
|
25
|
+
- user-facing output is intent-first and constrained
|
|
26
|
+
- caveats are explicit when runtime certainty is missing
|
|
27
|
+
|
|
28
|
+
## Good example
|
|
29
|
+
“BlendOps provides a structured plan and checks; runtime execution remains external.”
|
|
30
|
+
|
|
31
|
+
## Bad example
|
|
32
|
+
“Paste and run arbitrary Python as the default BlendOps flow.”
|
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
# Law: non-blender-user-language
|
|
2
|
+
|
|
3
|
+
Status: 1.0.0
|
|
4
|
+
|
|
5
|
+
## Purpose
|
|
6
|
+
Ensure user-facing outputs remain understandable for non-Blender users.
|
|
7
|
+
|
|
8
|
+
## Applies to
|
|
9
|
+
All final summaries and user-facing response templates.
|
|
10
|
+
|
|
11
|
+
## Must do
|
|
12
|
+
- use plain language first
|
|
13
|
+
- explain unavoidable technical terms briefly
|
|
14
|
+
- provide clear next actions
|
|
15
|
+
|
|
16
|
+
## Must not do
|
|
17
|
+
- must not rely on dense Blender jargon
|
|
18
|
+
- must not present raw runtime logs as final explanation
|
|
19
|
+
|
|
20
|
+
## Blocking conditions
|
|
21
|
+
- user-facing output cannot be understood without Blender internals
|
|
22
|
+
|
|
23
|
+
## Validation
|
|
24
|
+
- summary is plain-language
|
|
25
|
+
- caveats and status are clear
|
|
26
|
+
- next actions are actionable
|
|
27
|
+
|
|
28
|
+
## Good example
|
|
29
|
+
“Runtime was not executed yet (`Runtime status: Not Run`), so no output files were created (`Artifact status: Not Produced`).”
|
|
30
|
+
|
|
31
|
+
## Bad example
|
|
32
|
+
“Deferred pipeline tangent-space mismatch requires shader graph remediation.”
|
|
@@ -0,0 +1,78 @@
|
|
|
1
|
+
|
|
2
|
+
|
|
3
|
+
# Law: official-runtime-only
|
|
4
|
+
|
|
5
|
+
Status: 1.0.0
|
|
6
|
+
|
|
7
|
+
## Purpose
|
|
8
|
+
|
|
9
|
+
Ensure active skill outputs reference well-defined Blender runtime paths only and never invent or imply a runtime path that does not exist.
|
|
10
|
+
|
|
11
|
+
## "Official" definition for this law
|
|
12
|
+
|
|
13
|
+
This law uses the term **"official"** to mean: the runtime path is documented by Anthropic, the Blender Foundation, or its mature published upstream maintainer; the source URL/repo can be linked; and the path is one of the two MCP paths (or the CLI appendix) listed in [`docs/runtime-stack-strategy.md`](../docs/runtime-stack-strategy.md).
|
|
14
|
+
|
|
15
|
+
The currently recognized paths are:
|
|
16
|
+
|
|
17
|
+
| Path | Provenance | "Official" status for this law |
|
|
18
|
+
|---|---|---|
|
|
19
|
+
| **Path 1** Official Blender Lab MCP (Lab add-on + Lab server in Blender; host = Anthropic Blender Connector OR manual MCP client) | Blender Foundation Lab (`bpype/blender_mcp`) for the Blender-side stack; Anthropic for host option (a) | Official — endorsed by Blender Foundation for the Blender side, and by Anthropic for host option (a). Anthropic Connector is **not** a separate runtime; it is one MCP host on top of Lab MCP. |
|
|
20
|
+
| **Path 2** Community `mcp-for-blender` | Community / `ahujasid` (mature prior art) | Third-party but **mature and recognized**; treated as a supported path in BlendOps with extra caveats in [`docs/unofficial-runtime-bridges.md`](../docs/unofficial-runtime-bridges.md). |
|
|
21
|
+
| **CLI fallback (appendix)** | Blender Foundation | Official source for `blender` CLI. **Documented upstream** as a first-class Blender CLI surface; BlendOps simply has no in-repo evidence file yet capturing a per-recipe CLI-fallback eval. Appendix only — not presented as a peer execution path of Path 1/2 because no in-repo eval record exists. |
|
|
22
|
+
|
|
23
|
+
What this law forbids:
|
|
24
|
+
|
|
25
|
+
- Inventing a runtime path that is not one of the above.
|
|
26
|
+
- Linking to non-public, non-listed, or speculative MCP forks.
|
|
27
|
+
- Implying that BlendOps owns or ships a runtime.
|
|
28
|
+
- Describing the Anthropic Connector as if it were standalone or as if it bypassed the Blender Lab MCP add-on. (It does not — Anthropic's tutorial step 2 explicitly tells you to install the Lab add-on inside Blender.)
|
|
29
|
+
- Applying a Blender version floor incorrectly across paths (the 5.1+ floor is bound to Path 1 because of the Lab add-on manifest; Path 2 is 3.0+; CLI is 4.2+ recommended).
|
|
30
|
+
- Presenting CLI fallback as a publisher-verified peer of Path 1 / Path 2.
|
|
31
|
+
|
|
32
|
+
What this law permits (clarified 2026-05-08, updated for the 2-path model):
|
|
33
|
+
|
|
34
|
+
- Documenting Path 2 with full setup instructions and tool surface, because it is the only currently user-verified BlendOps runtime path and the de facto standard for many MCP clients on older Blender.
|
|
35
|
+
- Listing both Path 1 (with both host options a/b) and Path 2 side-by-side in user-facing docs.
|
|
36
|
+
- Recording per-path verification status (`Not Verified`, `Read-only smoke`, `User-reported verified`, `Verified`, `Not Run`).
|
|
37
|
+
|
|
38
|
+
## Applies to
|
|
39
|
+
|
|
40
|
+
All files under `skills/` and `packs/`.
|
|
41
|
+
|
|
42
|
+
## Must do
|
|
43
|
+
|
|
44
|
+
- name the runtime path explicitly (Path 1 or Path 2) when discussing runtime steps; for Path 1 also name the host option (a — Anthropic Connector, b — manual MCP client) when relevant
|
|
45
|
+
- include source confidence (`verified-read`, `linked-only`, `unknown`) per claim
|
|
46
|
+
- defer exact setup details to the upstream tutorials when unverified
|
|
47
|
+
- treat CLI fallback as appendix, not peer
|
|
48
|
+
|
|
49
|
+
## Must not do
|
|
50
|
+
|
|
51
|
+
- must not invent a runtime path outside the recognized set
|
|
52
|
+
- must not imply BlendOps owns a runtime
|
|
53
|
+
- must not invent setup commands/details
|
|
54
|
+
- must not describe Anthropic Connector as standalone or as not requiring the Lab add-on inside Blender
|
|
55
|
+
- must not loosen the Blender 5.1+ floor for Path 1 (regardless of host option)
|
|
56
|
+
- must not call Path 2 "experimental" in a way that implies engineering immaturity (it is a mature prior-art project; the caveat is provenance, not maturity)
|
|
57
|
+
- must not present CLI fallback as publisher-verified
|
|
58
|
+
|
|
59
|
+
## Blocking conditions
|
|
60
|
+
|
|
61
|
+
- runtime setup instruction references a path outside the recognized set
|
|
62
|
+
- runtime setup claim lacks confidence/caveat
|
|
63
|
+
- a per-path property is mis-attributed (e.g., Anthropic Connector framed as Blender-4.2+-enough)
|
|
64
|
+
|
|
65
|
+
## Validation
|
|
66
|
+
|
|
67
|
+
- official source links present per path mentioned (Anthropic tutorial + Lab MCP for Path 1; `mcp-for-blender` for Path 2; Blender CLI docs for CLI appendix)
|
|
68
|
+
- no invented runtime path references
|
|
69
|
+
- confidence labels used when needed
|
|
70
|
+
- per-path Blender-version requirement is correctly attributed (Path 1 → 5.1+; Path 2 → 3.0+; CLI → 4.2+ recommended, not verified)
|
|
71
|
+
|
|
72
|
+
## Good example
|
|
73
|
+
|
|
74
|
+
"Path 1 with host option (a) Anthropic Connector requires Blender 5.1+ because the Lab MCP add-on it depends on declares `blender_version_min = 5.1.0`. Source confidence: linked-only for Anthropic tutorial, linked-only for Lab MCP page."
|
|
75
|
+
|
|
76
|
+
## Bad example
|
|
77
|
+
|
|
78
|
+
"Use the Anthropic Connector path; Blender 4.2+ is enough." (mis-attributes the version floor; ignores that Anthropic's own tutorial tells you to install the Lab add-on which requires 5.1+)
|
package/package.json
CHANGED
|
@@ -1,6 +1,101 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "blendops",
|
|
3
|
-
"version": "
|
|
4
|
-
"
|
|
5
|
-
"
|
|
6
|
-
|
|
3
|
+
"version": "1.0.0",
|
|
4
|
+
"description": "AI-native Blender workflow, knowledge catalog, and portable skill pack for non-Blender users. Ships 48 Anthropic Skills, 4 hard guardrail laws, 10 canonical recipes, deterministic SceneSpec/ExecutionPlan compilation, MCP runtime qualification, GLB inspection, and 26+ agent install targets.",
|
|
5
|
+
"homepage": "https://github.com/ThanhNguyxnOrg/blendops#readme",
|
|
6
|
+
"repository": {
|
|
7
|
+
"type": "git",
|
|
8
|
+
"url": "https://github.com/ThanhNguyxnOrg/blendops.git"
|
|
9
|
+
},
|
|
10
|
+
"bugs": {
|
|
11
|
+
"url": "https://github.com/ThanhNguyxnOrg/blendops/issues"
|
|
12
|
+
},
|
|
13
|
+
"license": "MIT",
|
|
14
|
+
"keywords": [
|
|
15
|
+
"blender",
|
|
16
|
+
"blender-mcp",
|
|
17
|
+
"claude",
|
|
18
|
+
"claude-skills",
|
|
19
|
+
"anthropic-skills",
|
|
20
|
+
"openai-skills",
|
|
21
|
+
"ai-agent",
|
|
22
|
+
"mcp",
|
|
23
|
+
"model-context-protocol",
|
|
24
|
+
"workflow",
|
|
25
|
+
"3d",
|
|
26
|
+
"glb",
|
|
27
|
+
"non-blender-user"
|
|
28
|
+
],
|
|
29
|
+
"engines": {
|
|
30
|
+
"node": ">=20.0.0"
|
|
31
|
+
},
|
|
32
|
+
"bin": {
|
|
33
|
+
"blendops": "bin/blendops.mjs"
|
|
34
|
+
},
|
|
35
|
+
"files": [
|
|
36
|
+
"bin/",
|
|
37
|
+
"scripts/install-skills.mjs",
|
|
38
|
+
"scripts/build-knowledge-catalog.mjs",
|
|
39
|
+
"scripts/compile-scene-plan.mjs",
|
|
40
|
+
"scripts/runtime-orchestrator.mjs",
|
|
41
|
+
"scripts/validate-capability-policy.mjs",
|
|
42
|
+
"scripts/validate-evidence-packet.mjs",
|
|
43
|
+
"scripts/export-claude-skills.mjs",
|
|
44
|
+
"scripts/inspect-glb.mjs",
|
|
45
|
+
"scripts/generate-glb-handoff-report.mjs",
|
|
46
|
+
"docs/knowledge-and-recipe-catalog.md",
|
|
47
|
+
"docs/recipes/",
|
|
48
|
+
"docs/workflows/",
|
|
49
|
+
"docs/examples/glb-web-handoff/",
|
|
50
|
+
"skills/",
|
|
51
|
+
"laws/",
|
|
52
|
+
"packs/",
|
|
53
|
+
"bundles/generic-project-local/",
|
|
54
|
+
"bundles/claude-desktop-manual/",
|
|
55
|
+
"bundles/skill-package/",
|
|
56
|
+
"registry/",
|
|
57
|
+
"schemas/",
|
|
58
|
+
"skills.sh.json",
|
|
59
|
+
"README.md",
|
|
60
|
+
"LICENSE",
|
|
61
|
+
"CHANGELOG.md"
|
|
62
|
+
],
|
|
63
|
+
"scripts": {
|
|
64
|
+
"dev": "node scripts/dev-server.mjs",
|
|
65
|
+
"start": "node scripts/dev-server.mjs",
|
|
66
|
+
"build": "npm run ci",
|
|
67
|
+
"catalog:build": "node scripts/build-knowledge-catalog.mjs --build",
|
|
68
|
+
"catalog:check": "node scripts/build-knowledge-catalog.mjs --check",
|
|
69
|
+
"catalog:eval": "node scripts/build-knowledge-catalog.mjs --eval",
|
|
70
|
+
"plan:compile": "node scripts/compile-scene-plan.mjs",
|
|
71
|
+
"operations:check": "node scripts/runtime-orchestrator.mjs --check",
|
|
72
|
+
"registry:build": "node scripts/build-registry.mjs",
|
|
73
|
+
"registry:check": "node scripts/build-registry.mjs --check",
|
|
74
|
+
"evals:build": "node scripts/run-evals.mjs --build",
|
|
75
|
+
"evals:check": "node scripts/run-evals.mjs --check",
|
|
76
|
+
"evals:list": "node scripts/run-evals.mjs --list",
|
|
77
|
+
"evals:run": "node scripts/run-evals.mjs",
|
|
78
|
+
"bundles:summaries:build": "node scripts/generate-bundle-reference-summaries.mjs",
|
|
79
|
+
"bundles:summaries:check": "node scripts/generate-bundle-reference-summaries.mjs --check",
|
|
80
|
+
"skills:install": "node scripts/install-skills.mjs",
|
|
81
|
+
"glb:inspect": "node scripts/inspect-glb.mjs",
|
|
82
|
+
"glb:handoff": "node scripts/generate-glb-handoff-report.mjs",
|
|
83
|
+
"arch:build": "node scripts/validate-repository-architecture.mjs",
|
|
84
|
+
"arch:check": "node scripts/validate-repository-architecture.mjs --check",
|
|
85
|
+
"test": "node --test scripts/test-skills-export.mjs scripts/test-routing-contracts.mjs scripts/test-behavioral-evals.mjs scripts/test-skill-templates.mjs scripts/test-catalog-contracts.mjs scripts/test-eval-coverage.mjs scripts/test-adapter-matrix.mjs scripts/test-bundle-summaries.mjs scripts/test-dev-server.mjs scripts/test-project-installer.mjs scripts/test-cli-package.mjs scripts/test-glb-handoff.mjs scripts/test-repository-architecture.mjs scripts/test-knowledge-catalog.mjs scripts/test-scene-spec-harmonizer.mjs scripts/test-runtime-orchestrator.mjs scripts/test-runtime-hardening.mjs scripts/test-mcp-qualification.mjs scripts/test-mcp-client-skills-sh.mjs",
|
|
86
|
+
"docs:check": "node scripts/check-docs.mjs",
|
|
87
|
+
"skills:export": "node scripts/export-claude-skills.mjs",
|
|
88
|
+
"ci": "npm run docs:check && npm run catalog:check && npm run operations:check && npm run arch:check && npm run registry:check && npm run evals:check && npm run evals:run && npm run bundles:summaries:check && npm run skills:export && npm test",
|
|
89
|
+
"audit:sync-digest": "node scripts/sync-current-audit-digest.mjs"
|
|
90
|
+
},
|
|
91
|
+
"dependencies": {
|
|
92
|
+
"@modelcontextprotocol/sdk": "1.32.2",
|
|
93
|
+
"ajv": "8.20.0",
|
|
94
|
+
"fflate": "0.8.3",
|
|
95
|
+
"zod": "4.6.7"
|
|
96
|
+
},
|
|
97
|
+
"devDependencies": {},
|
|
98
|
+
"publishConfig": {
|
|
99
|
+
"access": "public"
|
|
100
|
+
}
|
|
101
|
+
}
|
package/packs/README.md
ADDED
|
@@ -0,0 +1,114 @@
|
|
|
1
|
+
# PACK: product-hero-v0
|
|
2
|
+
|
|
3
|
+
> [!NOTE]
|
|
4
|
+
> Status: 1.0.0. This pack composes laws and skills for product-hero planning, validation, and handoff under official-runtime-only boundaries (retaining canonical pack identifier `product-hero-v0`).
|
|
5
|
+
|
|
6
|
+
## Pack status
|
|
7
|
+
|
|
8
|
+
| Field | Value |
|
|
9
|
+
|---|---|
|
|
10
|
+
| Pack name | `product-hero-v0` |
|
|
11
|
+
| Version | `1.0.0` |
|
|
12
|
+
| Release posture | Production (`v1.0.0`) |
|
|
13
|
+
| Runtime posture | Official-runtime-only |
|
|
14
|
+
| Runtime install | Not included |
|
|
15
|
+
| Runtime execution guarantee | Not claimed |
|
|
16
|
+
| Artifact guarantee | Not claimed without evidence |
|
|
17
|
+
|
|
18
|
+
## Intended workflow
|
|
19
|
+
|
|
20
|
+
Compose the included skills to plan, validate, and communicate product-hero Blender/web-3D outcomes under official-runtime-only boundaries.
|
|
21
|
+
|
|
22
|
+
| Stage | Skill family | Output |
|
|
23
|
+
|---|---|---|
|
|
24
|
+
| Help | Next-step routing skill | Safe entrypoint and skill/doc handoff |
|
|
25
|
+
| Setup | Runtime setup and readiness skills | Prerequisites, confidence labels, blockers |
|
|
26
|
+
| Planning | Product, camera, lighting, and material planners | Structured scene/workflow plan |
|
|
27
|
+
| Quality | Scene quality and render/export evidence skills | Pass/warn/fail readiness verdict and artifact truth labels |
|
|
28
|
+
| Handoff | GLB/web and response writer skills | Plain-language status and web handoff notes |
|
|
29
|
+
|
|
30
|
+
## Included laws
|
|
31
|
+
|
|
32
|
+
| Law | Path |
|
|
33
|
+
|---|---|
|
|
34
|
+
| Official runtime only | `../../laws/official-runtime-only.md` |
|
|
35
|
+
| No arbitrary Python interface | `../../laws/no-arbitrary-python-interface.md` |
|
|
36
|
+
| Evidence before done | `../../laws/evidence-before-done.md` |
|
|
37
|
+
| Non-Blender-user language | `../../laws/non-blender-user-language.md` |
|
|
38
|
+
|
|
39
|
+
## Included skills
|
|
40
|
+
|
|
41
|
+
| Category | Skill path | Status |
|
|
42
|
+
|---|---|---|
|
|
43
|
+
| Help / routing | `../../skills/blendops-help/SKILL.md` | 1.0.0 |
|
|
44
|
+
| Process / discipline (Superpowers + BMad inspired) | `../../skills/blender-brainstorming/SKILL.md` | 1.0.0 |
|
|
45
|
+
| Process / discipline | `../../skills/intent-to-3d-brief-writer/SKILL.md` | 1.0.0 |
|
|
46
|
+
| Process / discipline | `../../skills/asset-discovery/SKILL.md` | 1.0.0 |
|
|
47
|
+
| Setup / readiness | `../../skills/runtime-setup/SKILL.md` | 1.0.0 |
|
|
48
|
+
| Setup / readiness | `../../skills/runtime-readiness/SKILL.md` | 1.0.0 |
|
|
49
|
+
| Setup / readiness | `../../skills/bridge-conflicts/SKILL.md` | 1.0.0 |
|
|
50
|
+
| Planning | `../../skills/product-hero-scene-planner/SKILL.md` | 1.0.0 |
|
|
51
|
+
| Planning | `../../skills/camera-composition/SKILL.md` | 1.0.0 |
|
|
52
|
+
| Planning | `../../skills/lighting-material-plan/SKILL.md` | 1.0.0 |
|
|
53
|
+
| Quality / eval | `../../skills/scene-readiness/SKILL.md` | 1.0.0 |
|
|
54
|
+
| Quality / debugging | `../../skills/blender-troubleshooting/SKILL.md` | 1.0.0 |
|
|
55
|
+
| Quality / evidence | `../../skills/render-export-evidence/SKILL.md` | 1.0.0 |
|
|
56
|
+
| Quality / pre-handoff | `../../skills/pre-handoff-verification/SKILL.md` | 1.0.0 |
|
|
57
|
+
| Handoff / communication | `../../skills/glb-web-handoff/SKILL.md` | 1.0.0 |
|
|
58
|
+
| Handoff / communication | `../../skills/plain-language-response/SKILL.md` | 1.0.0 |
|
|
59
|
+
|
|
60
|
+
## Recipe scenario
|
|
61
|
+
|
|
62
|
+
| Scenario | Status |
|
|
63
|
+
|---|---|
|
|
64
|
+
| Cyberpunk shoe hero planning and handoff | Text-only and planning flow supported; runtime output not claimed |
|
|
65
|
+
|
|
66
|
+
## Activation prompt
|
|
67
|
+
|
|
68
|
+
```txt
|
|
69
|
+
Use the product-hero-v0 pack to plan a cyberpunk shoe web hero. Do not run Blender unless official runtime is available.
|
|
70
|
+
```
|
|
71
|
+
|
|
72
|
+
## Required review gates
|
|
73
|
+
|
|
74
|
+
This pack expects included skills to pass Gate 0 through Gate 8 in `skill-reviews/review-gates.md`.
|
|
75
|
+
|
|
76
|
+
## Eval expectations
|
|
77
|
+
|
|
78
|
+
| Expectation | Status language |
|
|
79
|
+
|---|---|
|
|
80
|
+
| Per-skill evals | Each included skill ships `SKILL.md`, `contract.json`, `EVAL.md`, `evals/suites/<id>.eval.json`, and 3+ `references/` files. |
|
|
81
|
+
| Automated deterministic evals | Verified across all 48 catalog skills (`269/269` deterministic cases via `npm run evals:run`). |
|
|
82
|
+
| Runtime blockers | Must be recordable without overclaims. |
|
|
83
|
+
| Depth audit | Tracked in `skill-reviews/reports/v0-skill-depth-audit.md`. |
|
|
84
|
+
| Gate review | Tracked in `skill-reviews/reports/v0-skill-gate-review.md`. |
|
|
85
|
+
|
|
86
|
+
## Release readiness checklist
|
|
87
|
+
|
|
88
|
+
- [ ] all included skills pass review gates or have explicit warnings
|
|
89
|
+
- [ ] no uncaveated Path 2 references; CLI appendix never a peer path
|
|
90
|
+
- [ ] no artifact overclaims without evidence
|
|
91
|
+
- [ ] install dry-run in disposable fixture succeeds
|
|
92
|
+
- [ ] rollback instructions validated
|
|
93
|
+
- [ ] runtime eval findings integrated
|
|
94
|
+
|
|
95
|
+
## Non-goals
|
|
96
|
+
|
|
97
|
+
| Non-goal | Meaning |
|
|
98
|
+
|---|---|
|
|
99
|
+
| No runtime installation | The pack doesn't install Blender or runtime connectors. |
|
|
100
|
+
| No runtime execution guarantees | The pack doesn't claim Blender execution works. |
|
|
101
|
+
| No custom CLI/MCP/addon runtime ownership | BlendOps remains a product/workflow layer. |
|
|
102
|
+
|
|
103
|
+
## Verification expectations
|
|
104
|
+
|
|
105
|
+
| Expectation | Required behavior |
|
|
106
|
+
|---|---|
|
|
107
|
+
| Law compliance | All outputs follow included laws. |
|
|
108
|
+
| Evidence before done | No artifact or runtime success claims without evidence. |
|
|
109
|
+
| Artifact status | Use `Produced`, `Not Produced`, `Verified`, or `Failed` (`Not Run` is reserved exclusively for Runtime/Eval status). |
|
|
110
|
+
| Plain language | Preserve non-Blender-user clarity. |
|
|
111
|
+
|
|
112
|
+
## Release gates
|
|
113
|
+
|
|
114
|
+
Review gates (`Gate 0` through `Gate 8`), `npm run ci`, and deterministic behavioral evaluations must remain green across every skill and pack change; live runtime/artifact claims remain gated on recorded evidence under `docs/evals/`.
|