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,73 @@
|
|
|
1
|
+
<!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/stage-gates/SKILL.md and skills/stage-gates/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
|
|
2
|
+
# stage-gates
|
|
3
|
+
|
|
4
|
+
Purpose: Define explicit per-stage gates and acceptance checklists before any modeling, render, or export work — work only proceeds gate by gate.
|
|
5
|
+
|
|
6
|
+
Enforce a checklist-driven discipline where every stage of a Blender recipe (brief → asset → scene → render → export → handoff) has a written acceptance gate. Work does not advance until the previous stage's gate is checked off. Inspired by Anthropic Superpowers `/test-driven-development` analog: gate first, work second.
|
|
7
|
+
|
|
8
|
+
Metadata: Contract `v1.0.0` | Category `process-discipline` | Role `stage-gate-checklist-enforcer` | Tier `L0` | Runtime default `Not Run` | Artifact default `Not Produced` | Mutation `downgrade_only`
|
|
9
|
+
|
|
10
|
+
## When to use & trigger cues
|
|
11
|
+
- complex multi-stage recipe (4+ distinct stages) requiring per-stage gate enforcement
|
|
12
|
+
- when work must be locked behind explicit `Pending | Pass | Fail | Blocked` stage gates before advancing
|
|
13
|
+
- when the user wants verifiable proof that each stage passes its checks before starting the next stage
|
|
14
|
+
- before any runtime work begins, to lock concrete checks, required evidence, and failure exits per stage
|
|
15
|
+
- Trigger phrases: "let's do this step by step", "what's done before we move on", "checklist for this work", "I want to make sure each stage is solid"
|
|
16
|
+
|
|
17
|
+
## When not to use (delegation boundaries)
|
|
18
|
+
- single-step requests → use `blender-brainstorming` (`references/skill-blender-brainstorming.md`; Delegates out-of-scope requests to blender-brainstorming)
|
|
19
|
+
- pure exploratory brainstorming → use `blender-brainstorming` (`references/skill-blender-brainstorming.md`; use blender-brainstorming)
|
|
20
|
+
- decomposing a brief into stages → use `blender-recipe-decomposer` (`references/skill-blender-recipe-decomposer.md`; use blender-recipe-decomposer)
|
|
21
|
+
- writing measurable acceptance criteria rows from scratch → use `acceptance-criteria-builder` (`references/skill-acceptance-criteria-builder.md`; use acceptance-criteria-builder)
|
|
22
|
+
- pinning the overall done/stop condition → use `done-criteria` (`references/skill-done-criteria.md`; use done-criteria)
|
|
23
|
+
- guarding against mid-flight scope creep → use `scope-guard` (`references/skill-scope-guard.md`; use scope-guard)
|
|
24
|
+
- selecting which skill runs next across the workflow → use `workflow-stage-router` (`references/skill-workflow-stage-router.md`; use workflow-stage-router)
|
|
25
|
+
- fixing repeated stage failures or broken renders → use `blender-troubleshooting` (`references/skill-blender-troubleshooting.md`; use blender-troubleshooting)
|
|
26
|
+
- executing the final 7-point handoff gate → use `pre-handoff-verification` (`references/skill-pre-handoff-verification.md`; use pre-handoff-verification)
|
|
27
|
+
|
|
28
|
+
## Input & output contract
|
|
29
|
+
- Required input `active_workflow_stages` (`array`): Ordered stages of the selected BlendOps recipe or custom workflow
|
|
30
|
+
- Required input `locked_acceptance_criteria` (`object`): Measurable acceptance rows from acceptance-criteria-builder
|
|
31
|
+
- Optional input `current_stage_status` (`string`): Current stage progress and completed gate checks
|
|
32
|
+
- Output contract: `stage_gate_checklists`, `entry_and_exit_preconditions`, `gate_failure_routing_rules` (Runtime status: `Not Run`, Artifact status: `Not Produced`, `downgrade_only`).
|
|
33
|
+
|
|
34
|
+
## Quick-start steps
|
|
35
|
+
1. list the stages of the user's recipe
|
|
36
|
+
2. write the gate per stage (specific, checkable conditions)
|
|
37
|
+
3. run the gate after each stage; do not proceed if it fails
|
|
38
|
+
4. record the gate result + evidence per stage
|
|
39
|
+
|
|
40
|
+
## Cross-skill handoffs
|
|
41
|
+
- [upstream_reference] Brainstorming → `blender-brainstorming` (`references/skill-blender-brainstorming.md`) — `when.all: [goal.clarity equals "ambiguous_or_mixed"]`
|
|
42
|
+
- [upstream_reference] Brief authoring → `intent-to-3d-brief-writer` (`references/skill-intent-to-3d-brief-writer.md`) — `when.all: [goal.clarity equals "clear"; brief.locked equals false]`
|
|
43
|
+
- [upstream_reference] Recipe stage decomposition → `blender-recipe-decomposer` (`references/skill-blender-recipe-decomposer.md`) — `when.all: [fit.multiDeliverableDetected equals true]`
|
|
44
|
+
- [upstream_reference] Measurable acceptance rows → `acceptance-criteria-builder` (`references/skill-acceptance-criteria-builder.md`) — `when.all: [brief.locked equals true; stage.current equals "acceptance_criteria"]`
|
|
45
|
+
- [upstream_reference] Overall done condition → `done-criteria` (`references/skill-done-criteria.md`) — `when.all: [brief.locked equals true; stage.current equals "stop_condition"]`
|
|
46
|
+
- [progression] Scope creep protection → `scope-guard` (`references/skill-scope-guard.md`) — `when.all: [scope.driftDetected equals true]`
|
|
47
|
+
- [progression] Next-skill routing across stages → `workflow-stage-router` (`references/skill-workflow-stage-router.md`) — `when.all: [preflight.passed equals true; inventory.exists equals true]`
|
|
48
|
+
- [progression] Asset discovery → `asset-discovery` (`references/skill-asset-discovery.md`) — `when.all: [brief.locked equals true; assets.discoveryComplete equals false]`
|
|
49
|
+
- [progression] Scene planners (camera-composition) → `camera-composition` (`references/skill-camera-composition.md`) — `when.all: [brief.locked equals true; stage.current equals "camera_planning"]`
|
|
50
|
+
- [progression] Scene planners (lighting-material-plan) → `lighting-material-plan` (`references/skill-lighting-material-plan.md`) — `when.all: [brief.locked equals true; stage.current equals "lookdev_planning"]`
|
|
51
|
+
- [alternative] Scene planners (character-portrait) → `character-portrait` (`references/skill-character-portrait.md`) — `when.all: [brief.locked equals true; recipe.domain equals "character_portrait"]`
|
|
52
|
+
- [alternative] Scene planners (environment-shot) → `environment-shot` (`references/skill-environment-shot.md`) — `when.all: [brief.locked equals true; recipe.domain equals "environment_shot"]`
|
|
53
|
+
- [alternative] Scene planners (interior-scene) → `interior-scene` (`references/skill-interior-scene.md`) — `when.all: [brief.locked equals true; recipe.domain equals "interior_archviz"]`
|
|
54
|
+
- [alternative] Scene planners (product-grid-scene-planner) → `product-grid-scene-planner` (`references/skill-product-grid-scene-planner.md`) — `when.all: [brief.locked equals true; recipe.domain equals "product_grid"]`
|
|
55
|
+
- [alternative] Scene planners (product-hero-scene-planner) → `product-hero-scene-planner` (`references/skill-product-hero-scene-planner.md`) — `when.all: [brief.locked equals true; recipe.domain equals "product_hero"]`
|
|
56
|
+
- [progression] Quality validators (scene-readiness) → `scene-readiness` (`references/skill-scene-readiness.md`) — `when.all: [quality.domain equals "holistic"; stage.current equals "quality_validation"]`
|
|
57
|
+
- [progression] Quality validators (composition-quality-checker) → `composition-quality-checker` (`references/skill-composition-quality-checker.md`) — `when.all: [quality.domain equals "composition"; quality.verdict equals "not_run"]`
|
|
58
|
+
- [progression] Quality validators (lighting-quality-checker) → `lighting-quality-checker` (`references/skill-lighting-quality-checker.md`) — `when.all: [quality.domain equals "lighting"; quality.verdict equals "not_run"]`
|
|
59
|
+
- [progression] Quality validators (material-quality-checker) → `material-quality-checker` (`references/skill-material-quality-checker.md`) — `when.all: [quality.domain equals "material"; quality.verdict equals "not_run"]`
|
|
60
|
+
- [progression] Quality validators (polycount-budget-checker) → `polycount-budget-checker` (`references/skill-polycount-budget-checker.md`) — `when.all: [quality.domain equals "polycount"; budget.verdict equals "Not Run"]`
|
|
61
|
+
- [fallback] Repeated gate failures → `blender-troubleshooting` (`references/skill-blender-troubleshooting.md`) — `when.all: [runtime.errorDetected equals true]`
|
|
62
|
+
- [progression] Final 7-point gate → `pre-handoff-verification` (`references/skill-pre-handoff-verification.md`) — `when.all: [stage.current equals "final_verification"]`
|
|
63
|
+
|
|
64
|
+
## Safety boundaries & non-goals
|
|
65
|
+
- Runtime boundary: Process / discipline skill — does not run Blender. Gates are written and evaluated against produced artifacts (per `evidence-before-done.md`). Gate verdicts are honest labels, not motivation.
|
|
66
|
+
- Run Blender or execute Python.
|
|
67
|
+
- Decompose recipes into stages (`blender-recipe-decomposer`).
|
|
68
|
+
- Write measurable acceptance criteria rows (`acceptance-criteria-builder`).
|
|
69
|
+
- Pin the overall done/stop condition (`done-criteria`).
|
|
70
|
+
- Guard against scope creep (`scope-guard`).
|
|
71
|
+
- Pick next skills across the workflow (`workflow-stage-router`).
|
|
72
|
+
- Diagnose repeated technical failures (`blender-troubleshooting`).
|
|
73
|
+
- Replace the final 7-point handoff gate (`pre-handoff-verification`).
|
|
@@ -0,0 +1,49 @@
|
|
|
1
|
+
<!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/workflow-stage-router/SKILL.md and skills/workflow-stage-router/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
|
|
2
|
+
# workflow-stage-router
|
|
3
|
+
|
|
4
|
+
Purpose: Given current artifacts and intent, name the next BlendOps skill or workflow stage and preconditions to advance.
|
|
5
|
+
|
|
6
|
+
Reduce skill-choice paralysis by mapping **current state → next narrow skill** across BlendOps workflows while preserving evidence and runtime boundaries.
|
|
7
|
+
|
|
8
|
+
Metadata: Contract `v1.0.0` | Category `routing-and-governance` | Role `mid-workflow-stage-router` | Tier `L0` | Runtime default `Not Run` | Artifact default `Not Produced` | Mutation `downgrade_only`
|
|
9
|
+
Routing precedence: group `entry-and-stage-routing`, rank `4` | activationGate: `goalClarity="clear"`, `recipeSelected=true`, `preflightPassed=true`, `hasStageOrArtifactInventory=true`
|
|
10
|
+
|
|
11
|
+
## When to use & trigger cues
|
|
12
|
+
- user asks "what skill next" after partial progress
|
|
13
|
+
- agent risks loading too many skills at once
|
|
14
|
+
- resume after interruption
|
|
15
|
+
- Trigger phrases: "where are we in the workflow", "what's next", "resume from here", "next skill"
|
|
16
|
+
|
|
17
|
+
## When not to use (delegation boundaries)
|
|
18
|
+
- Initial goal is vague or entry point is unknown → use `blendops-help` (`references/skill-blendops-help.md`; Triages ambiguous entry requests at precedence Rank 1)
|
|
19
|
+
- Goal is clear but no recipe or pack has been chosen yet → use `recipe-fit-assessor` (`references/skill-recipe-fit-assessor.md`; Selects the fitting recipe/pack at precedence Rank 2)
|
|
20
|
+
- Pack is selected and brief exists, but pack preflight has not completed yet → use `pack-prerequisite-checker` (`references/skill-pack-prerequisite-checker.md`; Executes preflight readiness verification at precedence Rank 3 before stage routing)
|
|
21
|
+
- Active MCP runtime bridge conflict on port 9876 → use `bridge-conflicts` (`references/skill-bridge-conflicts.md`; Resolves port and dual add-on conflicts before advancing)
|
|
22
|
+
- Final stakeholder-facing wording and plain-language summary → use `plain-language-response` (`references/skill-plain-language-response.md`; Formats validated workflow outputs for non-Blender users)
|
|
23
|
+
|
|
24
|
+
## Input & output contract
|
|
25
|
+
- Required input `current_artifact_inventory` (`artifact_inventory`): Determines current milestone stage and downgrade-only truth labels
|
|
26
|
+
- Required input `active_intent` (`string`): Prevents routing to the wrong domain branch
|
|
27
|
+
- Optional input `target_pack_or_recipe` (`string`): Narrows milestone track
|
|
28
|
+
- Output contract: `current_stage_name`, `single_immediate_next_skill`, `preconditions_checklist` (Runtime status: `Not Run`, Artifact status: `Not Produced`, `downgrade_only`).
|
|
29
|
+
|
|
30
|
+
## Quick-start steps
|
|
31
|
+
1. capture what exists now (brief, plan, renders, GLB, evidence logs)
|
|
32
|
+
2. compare against `skills/workflow-stage-router/references/milestone-model.md`
|
|
33
|
+
3. emit route via `skills/workflow-stage-router/references/routing-decision-tree.md`
|
|
34
|
+
4. fill `skills/workflow-stage-router/references/stage-handoff-template.md`
|
|
35
|
+
|
|
36
|
+
## Cross-skill handoffs
|
|
37
|
+
- [upstream_reference] Pack entry preflight gate → `pack-prerequisite-checker` (`references/skill-pack-prerequisite-checker.md`) — `when.all: [preflight.passed equals false]`
|
|
38
|
+
- [conditional] Runtime readiness check → `runtime-readiness` (`references/skill-runtime-readiness.md`) — `when.all: [runtime.status equals "Not Run"; stage.requiresRuntime equals true]`
|
|
39
|
+
- [fallback] Active MCP bridge conflict on port 9876 → `bridge-conflicts` (`references/skill-bridge-conflicts.md`) — `when.all: [runtime.conflictDetected equals true]`
|
|
40
|
+
- [boundary_delegation] Mid-workflow scope expansion or unapproved deliverable addition → `scope-guard` (`references/skill-scope-guard.md`) — `when.all: [scope.driftDetected equals true]`
|
|
41
|
+
- [progression] Evidence updates for render or export outputs → `render-export-evidence` (`references/skill-render-export-evidence.md`) — `when.all: [stage.current equals "post_execution_audit"]`
|
|
42
|
+
- [fallback] Failed gate / blocked mode exit / final gate → `pre-handoff-verification` (`references/skill-pre-handoff-verification.md`) — `when.any: [gate.status equals "failed"; runtime.mode equals "blocked"; stage.current equals "final_verification"]`
|
|
43
|
+
|
|
44
|
+
## Safety boundaries & non-goals
|
|
45
|
+
- Runtime boundary: Routing only — no Python and no Blender execution (`execute_blender_code` is never invoked here). If the next step requires runtime selection or configuration, route to `runtime-path-picker`, `runtime-setup`, `runtime-readiness`, `path-one-host-outline`, or `cli-appendix-job-outline` with these locked boundaries:
|
|
46
|
+
- Initial entry triage when the user's goal is unclear (use `blendops-help`).
|
|
47
|
+
- Selecting a recipe/pack (`recipe-fit-assessor`) or running initial pack preflight (`pack-prerequisite-checker`).
|
|
48
|
+
- Executing domain scene planning, running Blender or Python, or verifying artifact files directly.
|
|
49
|
+
- Writing final stakeholder-facing delivery copy (use `plain-language-response` after verification).
|
package/docs/README.md
ADDED
|
@@ -0,0 +1,276 @@
|
|
|
1
|
+
# 📚 BlendOps Documentation Hub
|
|
2
|
+
|
|
3
|
+
The single index for everything in this repo. Bookmark this page.
|
|
4
|
+
|
|
5
|
+
> [!NOTE]
|
|
6
|
+
> BlendOps is **v1.0.0 (Production)**. The public npm CLI package `blendops@1.0.0` is published, and the GitHub Agent Skills source is listed on skills.sh. No official marketplace/plugin listing is claimed. In-repo live Blender runtime evidence remains partial (Path 1 read-only smoke only; mutation/render/export `Not Run` / `Not Produced`).
|
|
7
|
+
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
## 🚦 Status dashboard
|
|
11
|
+
|
|
12
|
+
| Area | Status | Meaning |
|
|
13
|
+
|---|---|---|
|
|
14
|
+
| Product release | v1.0.0 (Production) | Canonical workflow specs, knowledge/recipe catalogs, CLI, and CI verification suites are released. |
|
|
15
|
+
| Skill / law / pack collection | v1.0.0 | **48** canonical portable skills, 4 laws, 1 pack (`product-hero-v0`). Canonical index: [`../skills/README.md`](../skills/README.md); public GitHub source is [listed on skills.sh](https://www.skills.sh/ThanhNguyxnOrg/blendops). |
|
|
16
|
+
| Runtime path model | Active (2-path + CLI appendix) | Path 1 (Lab MCP, hosted from Anthropic Connector or manual MCP); Path 2 (community `mcp-for-blender`); CLI fallback (documented upstream as first-class Blender CLI; no in-repo evidence file yet). |
|
|
17
|
+
| Path 1 read-only smoke | Pass / Available | 2026-04-29 record (likely Anthropic Connector host). |
|
|
18
|
+
| Path 2 user-reported verified | Yes (2026-05-08) | No formal eval file yet. |
|
|
19
|
+
| CLI fallback | Not Run | **Documented upstream** as a first-class Blender CLI surface; no in-repo evidence file yet. |
|
|
20
|
+
| Full runtime manual eval (any path) | Not Run | Mutation/render/export not attempted. |
|
|
21
|
+
| Runtime artifacts | Not Produced | No fresh preview/render/GLB. |
|
|
22
|
+
| Release tag (`v1.0.0`) | Ready | Skills layer (48 skills + 151 hardened references), catalogs, CLI (`35+` targets), and full verification suite are complete. |
|
|
23
|
+
| npm CLI package | Published (`blendops@1.0.0`, `latest`) | [Public npm package](https://www.npmjs.com/package/blendops); the CLI entrypoint and transactional project installer ship in the package. |
|
|
24
|
+
| Distribution metadata sync | Automated | ThanhNguyxnAgent checks npm registry + skills.sh on source changes and weekly; see `docs/audits/current/distribution-metadata.json` (created by the first successful live sync). |
|
|
25
|
+
| Knowledge & Recipe Catalog | Implemented & Verified (`90/90` bilingual retrieval evals) | **30** `knowledge.*` records across **11** 3D domains, **10** `recipe.*` blueprints, **20** `source.*` citations, deterministic `catalog-search` / `catalog-resolve` / `plan-compile` CLI, and 48-skill / 151-reference architecture audit in [`knowledge-and-recipe-catalog.md`](./knowledge-and-recipe-catalog.md) and [`audits/skill-architecture-audit.md`](./audits/skill-architecture-audit.md). |
|
|
26
|
+
| GLB Web Handoff & Viewer Integration | Implemented (`Not Run` / `Not Produced` for live Blender exports) | `schemas/glb-web-handoff-manifest.schema.json`, `scripts/inspect-glb.mjs`, `scripts/generate-glb-handoff-report.mjs`, CLI `glb-inspect` / `glb-handoff` / `glb-validate-manifest`, and Three.js + R3F examples in [`examples/glb-web-handoff/README.md`](./examples/glb-web-handoff/README.md). |
|
|
27
|
+
| Repository architecture & file inventory | Verified (`npm run arch:check`) | Canonical source, generated artifact, historical record, documentation, runtime/test, distribution, and config classification in [`architecture.md`](./architecture.md) and [`audits/current/repository-inventory.json`](./audits/current/repository-inventory.json). |
|
|
28
|
+
|
|
29
|
+
---
|
|
30
|
+
|
|
31
|
+
## 🚀 Start here (recommended order)
|
|
32
|
+
|
|
33
|
+
1. [`start-here.md`](./start-here.md) — friendly first-read orientation.
|
|
34
|
+
2. [`product-direction.md`](./product-direction.md) — what BlendOps is and isn't.
|
|
35
|
+
3. [`runtime-stack-strategy.md`](./runtime-stack-strategy.md) — the canonical 2-path + CLI appendix runtime model with corrected attribution history.
|
|
36
|
+
4. [`external-runtime-setup.md`](./external-runtime-setup.md) — per-path Blender + MCP setup walkthrough.
|
|
37
|
+
5. [`ai-agent-quickstart.md`](./ai-agent-quickstart.md) — the prompt to paste into any AI agent.
|
|
38
|
+
6. [`ai-agent-install-flow.md`](./ai-agent-install-flow.md) — universal install/prep flow (Mode A/B/C).
|
|
39
|
+
|
|
40
|
+
> [!TIP]
|
|
41
|
+
> If you only have 5 minutes: read [`start-here.md`](./start-here.md). If you only need runtime setup: read [`external-runtime-setup.md`](./external-runtime-setup.md).
|
|
42
|
+
|
|
43
|
+
---
|
|
44
|
+
|
|
45
|
+
## 🧭 Navigation by job
|
|
46
|
+
|
|
47
|
+
| Job | Start with | Then read |
|
|
48
|
+
|---|---|---|
|
|
49
|
+
| Understand the product | [`product-direction.md`](./product-direction.md) | [`architecture.md`](./architecture.md), [`reference-runtime.md`](./reference-runtime.md) |
|
|
50
|
+
| Set up Blender runtime | [`external-runtime-setup.md`](./external-runtime-setup.md) | [`runtime-stack-strategy.md`](./runtime-stack-strategy.md), [`reference-runtime.md`](./reference-runtime.md), [`unofficial-runtime-bridges.md`](./unofficial-runtime-bridges.md), [`../laws/official-runtime-only.md`](../laws/official-runtime-only.md) |
|
|
51
|
+
| Review workflow behavior | [`workflow-contract.md`](./workflow-contract.md) | [`first-user-journey.md`](./first-user-journey.md), [`safety-model.md`](./safety-model.md) |
|
|
52
|
+
| Search 3D domain knowledge & canonical recipes | [`knowledge-and-recipe-catalog.md`](./knowledge-and-recipe-catalog.md) | [`../registry/knowledge-catalog.json`](../registry/knowledge-catalog.json), [`../registry/recipe-catalog.json`](../registry/recipe-catalog.json), [`audits/skill-architecture-audit.md`](./audits/skill-architecture-audit.md) |
|
|
53
|
+
| Install BlendOps into a tool | [`ai-agent-quickstart.md`](./ai-agent-quickstart.md) | [`ai-agent-install-flow.md`](./ai-agent-install-flow.md), [`install-scopes.md`](./install-scopes.md), [`multi-agent-install-strategy.md`](./multi-agent-install-strategy.md), [`adapters/README.md`](./adapters/README.md), [`install/README.md`](./install/README.md) |
|
|
54
|
+
| Inspect a GLB & integrate into Three.js / React Three Fiber | [`examples/glb-web-handoff/README.md`](./examples/glb-web-handoff/README.md) | [`../skills/glb-web-handoff/SKILL.md`](../skills/glb-web-handoff/SKILL.md), [`../schemas/glb-web-handoff-manifest.schema.json`](../schemas/glb-web-handoff-manifest.schema.json) |
|
|
55
|
+
| Check eval evidence & repository audit | [`evals/README.md`](./evals/README.md) | [`audits/current/README.md`](./audits/current/README.md), [`audits/current/repository-inventory.json`](./audits/current/repository-inventory.json), [`release-readiness.md`](./release-readiness.md) |
|
|
56
|
+
| Review pack content | [`../packs/README.md`](../packs/README.md) | [`../skills/README.md`](../skills/README.md), [`workflows/README.md`](./workflows/README.md), [`recipes/README.md`](./recipes/README.md) |
|
|
57
|
+
|
|
58
|
+
---
|
|
59
|
+
|
|
60
|
+
## 🧩 Core specs
|
|
61
|
+
|
|
62
|
+
| Area | Doc |
|
|
63
|
+
|---|---|
|
|
64
|
+
| Product direction | [`product-direction.md`](./product-direction.md) |
|
|
65
|
+
| Architecture | [`architecture.md`](./architecture.md) |
|
|
66
|
+
| Skill system | [`skill-system.md`](./skill-system.md) |
|
|
67
|
+
| Knowledge & recipe catalog | [`knowledge-and-recipe-catalog.md`](./knowledge-and-recipe-catalog.md) |
|
|
68
|
+
| 48-skill & 151-reference architecture audit | [`audits/skill-architecture-audit.md`](./audits/skill-architecture-audit.md) |
|
|
69
|
+
| Workflow contract | [`workflow-contract.md`](./workflow-contract.md) |
|
|
70
|
+
| Safety model | [`safety-model.md`](./safety-model.md) |
|
|
71
|
+
| First user journey | [`first-user-journey.md`](./first-user-journey.md) |
|
|
72
|
+
| Golden path (cyberpunk shoe) | [`golden-path-cyberpunk-shoe.md`](./golden-path-cyberpunk-shoe.md) |
|
|
73
|
+
|
|
74
|
+
---
|
|
75
|
+
|
|
76
|
+
## 🧭 Runtime (2-path + CLI appendix model)
|
|
77
|
+
|
|
78
|
+
| Area | Doc |
|
|
79
|
+
|---|---|
|
|
80
|
+
| Path strategy + corrected attribution history | [`runtime-stack-strategy.md`](./runtime-stack-strategy.md) |
|
|
81
|
+
| External setup walkthrough | [`external-runtime-setup.md`](./external-runtime-setup.md) |
|
|
82
|
+
| Runtime boundary summary | [`reference-runtime.md`](./reference-runtime.md) |
|
|
83
|
+
| Path 2 caveats (community `mcp-for-blender`) | [`unofficial-runtime-bridges.md`](./unofficial-runtime-bridges.md) |
|
|
84
|
+
| Blender version compatibility matrix (`3.6 LTS`, `4.2 LTS`, `5.1+`) | [`blender-version-compatibility.md`](./blender-version-compatibility.md) |
|
|
85
|
+
| Claude app/Desktop setup notes | [`claude-app-setup.md`](./claude-app-setup.md) |
|
|
86
|
+
|
|
87
|
+
---
|
|
88
|
+
|
|
89
|
+
## 📦 Install + adoption
|
|
90
|
+
|
|
91
|
+
| Area | Doc |
|
|
92
|
+
|---|---|
|
|
93
|
+
| AI agent quickstart (paste-this-prompt) | [`ai-agent-quickstart.md`](./ai-agent-quickstart.md) |
|
|
94
|
+
| AI agent install flow (Mode A/B/C) | [`ai-agent-install-flow.md`](./ai-agent-install-flow.md) |
|
|
95
|
+
| Install scopes (project-local / tool-native / generic-root / user-global / docs-only) | [`install-scopes.md`](./install-scopes.md) |
|
|
96
|
+
| Per-target install index | [`install/README.md`](./install/README.md) |
|
|
97
|
+
| Multi-agent install strategy | [`multi-agent-install-strategy.md`](./multi-agent-install-strategy.md) |
|
|
98
|
+
| Distribution strategy | [`distribution-strategy.md`](./distribution-strategy.md) |
|
|
99
|
+
| Adapter index | [`adapters/README.md`](./adapters/README.md) |
|
|
100
|
+
| Adapter registry (promotion ladder) | [`adapter-registry.md`](./adapter-registry.md) |
|
|
101
|
+
| Capability profile schema | [`capability-profile.md`](./capability-profile.md) |
|
|
102
|
+
| Local installer & CLI spec | [`install/installer-spec.md`](./install/installer-spec.md) |
|
|
103
|
+
| Bundle: canonical portable skill package | [`../bundles/skill-package/README.md`](../bundles/skill-package/README.md) |
|
|
104
|
+
| Bundle: Claude Desktop manual import | [`../bundles/claude-desktop-manual/README.md`](../bundles/claude-desktop-manual/README.md) |
|
|
105
|
+
| Bundle: generic project-local fallback | [`../bundles/generic-project-local/README.md`](../bundles/generic-project-local/README.md) |
|
|
106
|
+
| Example: agent install prompts | [`examples/agent-install-prompt.md`](./examples/agent-install-prompt.md) |
|
|
107
|
+
| Example: `BLENDOPS.md` root template | [`examples/blendops-root-entrypoint.md`](./examples/blendops-root-entrypoint.md) |
|
|
108
|
+
| Example: Claude app project instructions | [`examples/claude-app-project-instructions.md`](./examples/claude-app-project-instructions.md) |
|
|
109
|
+
| Example: GLB web handoff & Three.js / R3F viewer integration | [`examples/glb-web-handoff/README.md`](./examples/glb-web-handoff/README.md) |
|
|
110
|
+
|
|
111
|
+
---
|
|
112
|
+
|
|
113
|
+
## 📂 Per-target install docs (26 targets total)
|
|
114
|
+
|
|
115
|
+
3 consumer types: **chat UI** (Claude Desktop), **coding agents** (21 — Claude Code through Amazon Q Developer), **local LLM runners** (3 — Ollama / LM Studio / Open WebUI). Plus a generic project-local fallback.
|
|
116
|
+
|
|
117
|
+
### 1) Chat UI with Skills upload
|
|
118
|
+
|
|
119
|
+
| Target | Doc | Selected mode | Confidence |
|
|
120
|
+
|---|---|---|---|
|
|
121
|
+
| Claude Desktop / Claude.ai | [`install/claude-desktop.md`](./install/claude-desktop.md) | multiple Skills ZIP preparation | linked-only / manual |
|
|
122
|
+
|
|
123
|
+
### 2) Coding agents (project-local install + can host MCP for Blender)
|
|
124
|
+
|
|
125
|
+
All 21 accept BlendOps via project-local files and can host MCP for Blender via Path 1 host (b) Lab MCP or Path 2 community `mcp-for-blender`. They differ in MCP config syntax and native-skill-loader maturity.
|
|
126
|
+
|
|
127
|
+
| Target | Doc | Selected mode | Confidence |
|
|
128
|
+
|---|---|---|---|
|
|
129
|
+
| Claude Code | [`install/claude-code.md`](./install/claude-code.md) | project-local install | verified-read for project-local adapter |
|
|
130
|
+
| OpenCode | [`install/opencode.md`](./install/opencode.md) | project-local install | linked-only |
|
|
131
|
+
| Cursor | [`install/cursor.md`](./install/cursor.md) | project-local install | linked-only |
|
|
132
|
+
| Codex CLI/App | [`install/codex.md`](./install/codex.md) | project-local install | linked-only |
|
|
133
|
+
| Gemini CLI | [`install/gemini.md`](./install/gemini.md) | project-local install | not researched |
|
|
134
|
+
| Antigravity (Google) | [`install/antigravity.md`](./install/antigravity.md) | project-local install | linked-only |
|
|
135
|
+
| GitHub Copilot | [`install/github-copilot.md`](./install/github-copilot.md) | project-local install | linked-only / generic |
|
|
136
|
+
| Cline (VS Code) | [`install/cline.md`](./install/cline.md) | project-local install | linked-only |
|
|
137
|
+
| Roo Code (VS Code) | [`install/roo-code.md`](./install/roo-code.md) | project-local install | linked-only |
|
|
138
|
+
| Blackbox AI (VS Code) | [`install/blackbox-ai.md`](./install/blackbox-ai.md) | project-local install | linked-only |
|
|
139
|
+
| Continue.dev | [`install/continue.md`](./install/continue.md) | project-local install | linked-only |
|
|
140
|
+
| Zed editor | [`install/zed.md`](./install/zed.md) | project-local install | linked-only |
|
|
141
|
+
| Windsurf (Codeium) | [`install/windsurf.md`](./install/windsurf.md) | project-local install | linked-only |
|
|
142
|
+
| Trae (ByteDance) | [`install/trae.md`](./install/trae.md) | project-local install | linked-only |
|
|
143
|
+
| Augment Code | [`install/augment-code.md`](./install/augment-code.md) | project-local install | linked-only |
|
|
144
|
+
| goose (Block) | [`install/goose.md`](./install/goose.md) | docs-only + Standard IO extension | linked-only — has upstream Blender tutorial |
|
|
145
|
+
| OpenHands | [`install/openhands.md`](./install/openhands.md) | project-local install | linked-only |
|
|
146
|
+
| JetBrains Junie / AI Assistant | [`install/jetbrains-junie.md`](./install/jetbrains-junie.md) | project-local install | linked-only |
|
|
147
|
+
| Sourcegraph Cody | [`install/sourcegraph-cody.md`](./install/sourcegraph-cody.md) | project-local install | linked-only |
|
|
148
|
+
| Aider (terminal) | [`install/aider.md`](./install/aider.md) | project-local install | linked-only |
|
|
149
|
+
| Amazon Q Developer CLI | [`install/amazon-q-developer.md`](./install/amazon-q-developer.md) | project-local install | linked-only |
|
|
150
|
+
|
|
151
|
+
### 3) Local LLM runners (docs-only; runner hosts MCP for Blender)
|
|
152
|
+
|
|
153
|
+
| Target | Doc | Selected mode | Confidence |
|
|
154
|
+
|---|---|---|---|
|
|
155
|
+
| Ollama | [`install/ollama.md`](./install/ollama.md) | docs-only + `~/.ollama/mcp-servers.json` (experimental) | linked-only / experimental |
|
|
156
|
+
| LM Studio | [`install/lm-studio.md`](./install/lm-studio.md) | docs-only + `mcp.json` (Cursor-compatible) | linked-only |
|
|
157
|
+
| Open WebUI | [`install/open-webui.md`](./install/open-webui.md) | docs-only + Streamable HTTP MCP | linked-only |
|
|
158
|
+
|
|
159
|
+
### Generic / future
|
|
160
|
+
|
|
161
|
+
| Target | Doc | Selected mode | Confidence |
|
|
162
|
+
|---|---|---|---|
|
|
163
|
+
| Generic project | [`install/generic-project.md`](./install/generic-project.md) | project-local install fallback | verified-read fallback |
|
|
164
|
+
| Local installer & CLI spec | [`install/installer-spec.md`](./install/installer-spec.md) | local CLI & tarball (`bin/blendops.mjs`, `scripts/install-skills.mjs`) | Public-release ready; initial npm stage pending approval |
|
|
165
|
+
|
|
166
|
+
---
|
|
167
|
+
|
|
168
|
+
## ⚖️ Laws
|
|
169
|
+
|
|
170
|
+
| Law | Doc |
|
|
171
|
+
|---|---|
|
|
172
|
+
| Index | [`../laws/README.md`](../laws/README.md) |
|
|
173
|
+
| Official runtime only | [`../laws/official-runtime-only.md`](../laws/official-runtime-only.md) |
|
|
174
|
+
| No arbitrary Python interface | [`../laws/no-arbitrary-python-interface.md`](../laws/no-arbitrary-python-interface.md) |
|
|
175
|
+
| Evidence before done | [`../laws/evidence-before-done.md`](../laws/evidence-before-done.md) |
|
|
176
|
+
| Non-Blender-user language | [`../laws/non-blender-user-language.md`](../laws/non-blender-user-language.md) |
|
|
177
|
+
|
|
178
|
+
---
|
|
179
|
+
|
|
180
|
+
## 🛠️ Skills (48 portable skills — canonical index)
|
|
181
|
+
|
|
182
|
+
The grouped inventory, depth status, eval links, and references live in [`../skills/README.md`](../skills/README.md). Baseline + expansion batches cover planning, readiness, evidence, web 3D handoff, focused quality validators, domain scene planners, process discipline, asset/sourcing, color/format/output decisions, recipe/pack operations, and runtime path discipline.
|
|
183
|
+
|
|
184
|
+
| Skill | Doc | Group |
|
|
185
|
+
|---|---|---|
|
|
186
|
+
| **Full inventory (48)** | [`../skills/README.md`](../skills/README.md) | Index |
|
|
187
|
+
|
|
188
|
+
Legacy quick links below cover only the **baseline 16**; the [`skills/README.md`](../skills/README.md) index lists all **48** skills by batch.
|
|
189
|
+
|
|
190
|
+
---
|
|
191
|
+
|
|
192
|
+
### Baseline 16 (historic quick links)
|
|
193
|
+
|
|
194
|
+
| Skill | Doc | Group |
|
|
195
|
+
|---|---|---|
|
|
196
|
+
| Index + how to add a new skill | [`../skills/README.md`](../skills/README.md) | — |
|
|
197
|
+
| `blendops-help` (router) | [`../skills/blendops-help/SKILL.md`](../skills/blendops-help/SKILL.md) | Help |
|
|
198
|
+
| `blender-brainstorming` (Superpowers `/brainstorming` analog) | [`../skills/blender-brainstorming/SKILL.md`](../skills/blender-brainstorming/SKILL.md) | Process |
|
|
199
|
+
| `intent-to-3d-brief-writer` (BMad analysis-phase analog) | [`../skills/intent-to-3d-brief-writer/SKILL.md`](../skills/intent-to-3d-brief-writer/SKILL.md) | Process |
|
|
200
|
+
| `asset-discovery` | [`../skills/asset-discovery/SKILL.md`](../skills/asset-discovery/SKILL.md) | Process |
|
|
201
|
+
| `runtime-setup` | [`../skills/runtime-setup/SKILL.md`](../skills/runtime-setup/SKILL.md) | Runtime |
|
|
202
|
+
| `runtime-readiness` | [`../skills/runtime-readiness/SKILL.md`](../skills/runtime-readiness/SKILL.md) | Runtime |
|
|
203
|
+
| `bridge-conflicts` (Single-bridge constraint) | [`../skills/bridge-conflicts/SKILL.md`](../skills/bridge-conflicts/SKILL.md) | Runtime |
|
|
204
|
+
| `product-hero-scene-planner` | [`../skills/product-hero-scene-planner/SKILL.md`](../skills/product-hero-scene-planner/SKILL.md) | Planning |
|
|
205
|
+
| `camera-composition` | [`../skills/camera-composition/SKILL.md`](../skills/camera-composition/SKILL.md) | Planning |
|
|
206
|
+
| `lighting-material-plan` | [`../skills/lighting-material-plan/SKILL.md`](../skills/lighting-material-plan/SKILL.md) | Planning |
|
|
207
|
+
| `scene-readiness` | [`../skills/scene-readiness/SKILL.md`](../skills/scene-readiness/SKILL.md) | Quality |
|
|
208
|
+
| `blender-troubleshooting` (Superpowers `/systematic-debugging` analog) | [`../skills/blender-troubleshooting/SKILL.md`](../skills/blender-troubleshooting/SKILL.md) | Quality |
|
|
209
|
+
| `render-export-evidence` | [`../skills/render-export-evidence/SKILL.md`](../skills/render-export-evidence/SKILL.md) | Evidence |
|
|
210
|
+
| `pre-handoff-verification` (Superpowers `/verification-before-completion` analog) | [`../skills/pre-handoff-verification/SKILL.md`](../skills/pre-handoff-verification/SKILL.md) | Evidence |
|
|
211
|
+
| `glb-web-handoff` | [`../skills/glb-web-handoff/SKILL.md`](../skills/glb-web-handoff/SKILL.md) | Handoff |
|
|
212
|
+
| `plain-language-response` | [`../skills/plain-language-response/SKILL.md`](../skills/plain-language-response/SKILL.md) | Handoff |
|
|
213
|
+
|
|
214
|
+
---
|
|
215
|
+
|
|
216
|
+
## 📦 Packs
|
|
217
|
+
|
|
218
|
+
| Pack | Doc |
|
|
219
|
+
|---|---|
|
|
220
|
+
| Index | [`../packs/README.md`](../packs/README.md) |
|
|
221
|
+
| `product-hero-v0` | [`../packs/product-hero-v0/PACK.md`](../packs/product-hero-v0/PACK.md) |
|
|
222
|
+
|
|
223
|
+
---
|
|
224
|
+
|
|
225
|
+
## 🔁 Workflows + recipes
|
|
226
|
+
|
|
227
|
+
| Area | Doc |
|
|
228
|
+
|---|---|
|
|
229
|
+
| Workflows index | [`workflows/README.md`](./workflows/README.md) |
|
|
230
|
+
| **Full non-Blender-user workflow** (canonical **baseline 16** chain; extend with `workflow-stage-router` + [`skills/README.md`](../skills/README.md) for all 48) | [`workflows/full-non-blender-user-workflow.md`](./workflows/full-non-blender-user-workflow.md) |
|
|
231
|
+
| Product hero workflow (narrower subset, 5 stages) | [`workflows/product-hero-workflow.md`](./workflows/product-hero-workflow.md) |
|
|
232
|
+
| Recipes index | [`recipes/README.md`](./recipes/README.md) |
|
|
233
|
+
| Cyberpunk shoe hero recipe | [`recipes/cyberpunk-shoe-hero.md`](./recipes/cyberpunk-shoe-hero.md) |
|
|
234
|
+
|
|
235
|
+
---
|
|
236
|
+
|
|
237
|
+
## 🧪 Evals + readiness
|
|
238
|
+
|
|
239
|
+
| Area | Doc | Status |
|
|
240
|
+
|---|---|---|
|
|
241
|
+
| Evals index | [`evals/README.md`](./evals/README.md) | Active eval index |
|
|
242
|
+
| Path 1 read-only smoke test (likely Anthropic Connector host) | [`evals/blender-connector-read-only-smoke-test.md`](./evals/blender-connector-read-only-smoke-test.md) | Pass / Available |
|
|
243
|
+
| Cyberpunk shoe v0 text-only eval | [`evals/cyberpunk-shoe-hero-v0-text-eval.md`](./evals/cyberpunk-shoe-hero-v0-text-eval.md) | Executed / Text-only |
|
|
244
|
+
| Cyberpunk shoe v0 manual eval protocol | [`evals/cyberpunk-shoe-hero-v0-manual-eval.md`](./evals/cyberpunk-shoe-hero-v0-manual-eval.md) | Protocol / Not yet executed |
|
|
245
|
+
| Cyberpunk shoe v0 runtime eval | [`evals/cyberpunk-shoe-hero-v0-runtime-eval.md`](./evals/cyberpunk-shoe-hero-v0-runtime-eval.md) | Historical / Blocked |
|
|
246
|
+
| Manual install beta v0 | [`evals/manual-install-beta-v0.md`](./evals/manual-install-beta-v0.md) | Executed / Dry-run / Warn |
|
|
247
|
+
| Adapter install v0 dry-run | [`evals/adapter-install-v0-dry-run.md`](./evals/adapter-install-v0-dry-run.md) | Executed / Dry-run |
|
|
248
|
+
| Skill package upload-readiness v0 | [`evals/skill-package-upload-readiness-v0.md`](./evals/skill-package-upload-readiness-v0.md) | Executed / Text-only / No upload / Warn |
|
|
249
|
+
| Official runtime verification criteria | [`evals/official-runtime-verification-criteria.md`](./evals/official-runtime-verification-criteria.md) | Prepared |
|
|
250
|
+
| Runtime availability checklist | [`evals/runtime-availability-checklist.md`](./evals/runtime-availability-checklist.md) | Prepared |
|
|
251
|
+
| Official runtime manual eval packet | [`evals/official-runtime-manual-eval-packet.md`](./evals/official-runtime-manual-eval-packet.md) | Prepared |
|
|
252
|
+
| Release readiness status | [`release-readiness.md`](./release-readiness.md) | v1.0.0 (Production) |
|
|
253
|
+
|
|
254
|
+
---
|
|
255
|
+
|
|
256
|
+
## 🧪 Skill reviews + reports
|
|
257
|
+
|
|
258
|
+
| Area | Doc |
|
|
259
|
+
|---|---|
|
|
260
|
+
| Index | [`../skill-reviews/README.md`](../skill-reviews/README.md) |
|
|
261
|
+
| Review gates | [`../skill-reviews/review-gates.md`](../skill-reviews/review-gates.md) |
|
|
262
|
+
| Acceptance criteria | [`../skill-reviews/acceptance-criteria.md`](../skill-reviews/acceptance-criteria.md) |
|
|
263
|
+
| Skill template | [`../skill-reviews/blendops-skill-template.md`](../skill-reviews/blendops-skill-template.md) |
|
|
264
|
+
| Depth standard | [`../skill-reviews/depth-standard.md`](../skill-reviews/depth-standard.md) |
|
|
265
|
+
| v0 depth audit report | [`../skill-reviews/reports/v0-skill-depth-audit.md`](../skill-reviews/reports/v0-skill-depth-audit.md) |
|
|
266
|
+
| v0 skill gate review report | [`../skill-reviews/reports/v0-skill-gate-review.md`](../skill-reviews/reports/v0-skill-gate-review.md) |
|
|
267
|
+
|
|
268
|
+
---
|
|
269
|
+
|
|
270
|
+
## ⚠️ Non-claims preserved
|
|
271
|
+
|
|
272
|
+
- BlendOps does not install Blender, configure the Anthropic Blender Connector, configure the Blender Lab MCP add-on, configure the community `mcp-for-blender` stack, or run Blender.
|
|
273
|
+
- Read-only smoke evidence is not mutation/render/export evidence.
|
|
274
|
+
- CLI fallback is **documented upstream** as a first-class Blender CLI surface; no in-repo evidence file yet.
|
|
275
|
+
- No official marketplace/plugin listing is claimed. The npm CLI and skills.sh Agent Skills source are publicly available; Blender runtime execution and generated artifacts remain separately evidence-gated.
|
|
276
|
+
- See [`release-readiness.md`](./release-readiness.md) for the full readiness state.
|
|
@@ -0,0 +1,174 @@
|
|
|
1
|
+
# GLB Web Handoff & Viewer Integration Examples
|
|
2
|
+
|
|
3
|
+
> **Truth-State Boundary:** These integration modules and CLI tools inspect existing `.glb` files and generate deterministic web handoff manifests, HTML/Markdown reports, and viewer integration code. They do **not** run Blender, do **not** export models from a `.blend` scene, and do **not** upgrade `Runtime status: Not Run` or `Artifact status: Not Produced` without a real runtime evidence record.
|
|
4
|
+
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
## What is in this folder
|
|
8
|
+
|
|
9
|
+
| File | Stack | Purpose |
|
|
10
|
+
|---|---|---|
|
|
11
|
+
| [`./threejs-glb-viewer.mjs`](./threejs-glb-viewer.mjs) | Vanilla Three.js (`r150+`) | Reusable ESM controller + pure helpers for manifest normalization, `GLTFLoader` decoder wiring (`DRACOLoader`, `MeshoptDecoder`, `KTX2Loader`), bounding-box camera framing, animation clip inspection, and scene graph memory disposal. |
|
|
12
|
+
| [`./r3f-glb-viewer.tsx`](./r3f-glb-viewer.tsx) | React Three Fiber (`@react-three/fiber` + `@react-three/drei`) | Reusable TypeScript component (`BlendOpsGlbModel`, `BlendOpsGlbViewerCanvas`, `GlbViewerErrorBoundary`) with `useGLTF`, `useAnimations`, `<Suspense>`, imperative ref handle, and unmount cache control. |
|
|
13
|
+
|
|
14
|
+
Related repository artifacts:
|
|
15
|
+
- Handoff manifest JSON Schema: [`../../../schemas/glb-web-handoff-manifest.schema.json`](../../../schemas/glb-web-handoff-manifest.schema.json)
|
|
16
|
+
- GLB 2.0 binary & structural inspector: [`../../../scripts/inspect-glb.mjs`](../../../scripts/inspect-glb.mjs)
|
|
17
|
+
- Web handoff report & manifest generator: [`../../../scripts/generate-glb-handoff-report.mjs`](../../../scripts/generate-glb-handoff-report.mjs)
|
|
18
|
+
- GLB web handoff skill: [`../../../skills/glb-web-handoff/SKILL.md`](../../../skills/glb-web-handoff/SKILL.md)
|
|
19
|
+
- React Three Fiber component planner skill: [`../../../skills/r3f-component-plan/SKILL.md`](../../../skills/r3f-component-plan/SKILL.md)
|
|
20
|
+
- Workflow contract: [`../../workflow-contract.md`](../../workflow-contract.md)
|
|
21
|
+
- Golden-path reference: [`../../golden-path-cyberpunk-shoe.md`](../../golden-path-cyberpunk-shoe.md)
|
|
22
|
+
|
|
23
|
+
---
|
|
24
|
+
|
|
25
|
+
## 1. Quick CLI workflow
|
|
26
|
+
|
|
27
|
+
Before dropping a `.glb` into a web application, run the BlendOps GLB inspection and handoff report commands:
|
|
28
|
+
|
|
29
|
+
```bash
|
|
30
|
+
# 1. Inspect GLB 2.0 binary container, scene hierarchy, meshes, materials, textures, animations, and 4 validation tiers
|
|
31
|
+
npx blendops glb-inspect ./path/to/model.glb
|
|
32
|
+
|
|
33
|
+
# 2. Generate a complete web handoff package (glb-handoff-manifest.json, glb-handoff-report.md, glb-handoff-report.html)
|
|
34
|
+
npx blendops glb-handoff ./path/to/model.glb --out-dir ./glb-handoff-out --viewer react-three-fiber
|
|
35
|
+
|
|
36
|
+
# 3. Validate an existing handoff manifest against schemas/glb-web-handoff-manifest.schema.json + semantic truth rules
|
|
37
|
+
npx blendops glb-validate-manifest ./glb-handoff-out/glb-handoff-manifest.json
|
|
38
|
+
```
|
|
39
|
+
|
|
40
|
+
When testing with synthetic fixtures inside automated tests, pass `--synthetic` so the generated manifest records `provenance: "synthetic_fixture"` and keeps `Artifact status: Not Produced`:
|
|
41
|
+
|
|
42
|
+
```bash
|
|
43
|
+
npx blendops glb-handoff ./fixture.glb --out-dir ./tmp-report --synthetic
|
|
44
|
+
```
|
|
45
|
+
|
|
46
|
+
---
|
|
47
|
+
|
|
48
|
+
## 2. Four-Tier Validation Model
|
|
49
|
+
|
|
50
|
+
Every BlendOps GLB inspection and handoff report separates verification into four explicit tiers so structural container checks are never mistaken for visual or live Blender runtime verification:
|
|
51
|
+
|
|
52
|
+
| Tier | Name | What it verifies | Default status on local `.glb` inspection |
|
|
53
|
+
|---|---|---|---|
|
|
54
|
+
| **Tier 1** | Container & Structural (`inspect-glb.mjs`) | 12-byte GLB header, chunk alignment, JSON/BIN bounds, bufferViews, accessors, node hierarchy (no cycles/multi-parents), declared extensions, and URI traversal safety. | `Pass` or `Fail` |
|
|
55
|
+
| **Tier 2** | Full glTF 2.0 Specification (`gltf-validator`) | Complete Khronos glTF 2.0 schema and accessor payload validation when `--khronos` is enabled and `gltf-validator` is installed. | `Skipped` (or `Pass` / `Warn` / `Fail` with `--khronos`) |
|
|
56
|
+
| **Tier 3** | Visual & Aesthetic Quality | Lighting balance, silhouette clarity, UV seam visibility, and PBR material response in the target viewport. | `Not Evaluated` |
|
|
57
|
+
| **Tier 4** | Live Blender Runtime Execution | Whether a live Blender session (Path 1 Blender Lab MCP in Blender 5.1+, Path 2 community `mcp-for-blender`, or CLI appendix) exported the asset with a recorded eval packet. | `Not Run` |
|
|
58
|
+
|
|
59
|
+
---
|
|
60
|
+
|
|
61
|
+
## 3. Using the Vanilla Three.js Viewer (`threejs-glb-viewer.mjs`)
|
|
62
|
+
|
|
63
|
+
### Dependencies in your web project
|
|
64
|
+
|
|
65
|
+
```bash
|
|
66
|
+
npm install three
|
|
67
|
+
```
|
|
68
|
+
|
|
69
|
+
### Example usage
|
|
70
|
+
|
|
71
|
+
```js
|
|
72
|
+
import { createThreeGlbViewer } from './threejs-glb-viewer.mjs';
|
|
73
|
+
import manifest from './glb-handoff-out/glb-handoff-manifest.json' with { type: 'json' };
|
|
74
|
+
|
|
75
|
+
const container = document.getElementById('viewer-root');
|
|
76
|
+
|
|
77
|
+
const viewer = await createThreeGlbViewer({
|
|
78
|
+
container,
|
|
79
|
+
manifest,
|
|
80
|
+
assetUrl: '/models/product-hero.glb',
|
|
81
|
+
decoderPaths: {
|
|
82
|
+
dracoGltfPath: '/decoders/draco/gltf/',
|
|
83
|
+
basisTranscoderPath: '/decoders/basis/',
|
|
84
|
+
},
|
|
85
|
+
onProgress: ({ ratio }) => {
|
|
86
|
+
if (ratio !== null) {
|
|
87
|
+
console.log(`Loading GLB: ${(ratio * 100).toFixed(1)}%`);
|
|
88
|
+
}
|
|
89
|
+
},
|
|
90
|
+
onLoad: ({ animations, framing }) => {
|
|
91
|
+
console.log('Loaded clips:', animations);
|
|
92
|
+
console.log('Camera framing:', framing);
|
|
93
|
+
},
|
|
94
|
+
onError: (err) => {
|
|
95
|
+
console.error('GLB load failed:', err);
|
|
96
|
+
},
|
|
97
|
+
});
|
|
98
|
+
|
|
99
|
+
await viewer.loadAsset();
|
|
100
|
+
|
|
101
|
+
// Drive the render loop
|
|
102
|
+
let lastTime = performance.now();
|
|
103
|
+
function animate(now) {
|
|
104
|
+
const dt = (now - lastTime) / 1000;
|
|
105
|
+
lastTime = now;
|
|
106
|
+
viewer.stepFrame(dt);
|
|
107
|
+
requestAnimationFrame(animate);
|
|
108
|
+
}
|
|
109
|
+
requestAnimationFrame(animate);
|
|
110
|
+
|
|
111
|
+
window.addEventListener('resize', () => viewer.resize());
|
|
112
|
+
```
|
|
113
|
+
|
|
114
|
+
---
|
|
115
|
+
|
|
116
|
+
## 4. Using the React Three Fiber Component (`r3f-glb-viewer.tsx`)
|
|
117
|
+
|
|
118
|
+
### Dependencies in your React project
|
|
119
|
+
|
|
120
|
+
```bash
|
|
121
|
+
npm install three @types/three @react-three/fiber @react-three/drei
|
|
122
|
+
```
|
|
123
|
+
|
|
124
|
+
### Example usage
|
|
125
|
+
|
|
126
|
+
```tsx
|
|
127
|
+
import React, { useRef } from 'react';
|
|
128
|
+
import {
|
|
129
|
+
BlendOpsGlbViewerCanvas,
|
|
130
|
+
type BlendOpsGlbModelHandle,
|
|
131
|
+
} from './r3f-glb-viewer';
|
|
132
|
+
|
|
133
|
+
export function ProductHeroPreview() {
|
|
134
|
+
const modelRef = useRef<BlendOpsGlbModelHandle | null>(null);
|
|
135
|
+
|
|
136
|
+
return (
|
|
137
|
+
<div>
|
|
138
|
+
<BlendOpsGlbViewerCanvas
|
|
139
|
+
ref={modelRef}
|
|
140
|
+
url="/models/product-hero.glb"
|
|
141
|
+
environmentPreset="city"
|
|
142
|
+
autoFitBounds={true}
|
|
143
|
+
dracoDecoderPath="/decoders/draco/gltf/"
|
|
144
|
+
enableMeshopt={false}
|
|
145
|
+
onLoaded={({ clipNames }) => {
|
|
146
|
+
console.log('Available animation clips:', clipNames);
|
|
147
|
+
}}
|
|
148
|
+
/>
|
|
149
|
+
<div style={{ display: 'flex', gap: '8px', marginTop: '8px' }}>
|
|
150
|
+
<button type="button" onClick={() => modelRef.current?.playClip('Turntable')}>
|
|
151
|
+
Play Turntable
|
|
152
|
+
</button>
|
|
153
|
+
<button type="button" onClick={() => modelRef.current?.stopAllClips()}>
|
|
154
|
+
Stop Clips
|
|
155
|
+
</button>
|
|
156
|
+
</div>
|
|
157
|
+
</div>
|
|
158
|
+
);
|
|
159
|
+
}
|
|
160
|
+
```
|
|
161
|
+
|
|
162
|
+
---
|
|
163
|
+
|
|
164
|
+
## 5. Decoder & Transform Reference
|
|
165
|
+
|
|
166
|
+
1. **Coordinate System & Units:**
|
|
167
|
+
- glTF 2.0 uses `+Y up, +Z forward, -X right` with `1 unit = 1 meter`.
|
|
168
|
+
- Blender's internal `-Y forward, +Z up` axes are converted automatically when the Blender glTF 2.0 exporter's `+Y Up` option is enabled.
|
|
169
|
+
- If `spatial.hasNonIdentityRootScale` is `true` in `glb-handoff-manifest.json`, apply transforms (`Ctrl+A -> All Transforms`) in Blender before final delivery so physics colliders and `<Bounds>` framing behave predictably.
|
|
170
|
+
- If `spatial.hasNegativeScale` is `true`, mesh face winding may invert in WebGL (`gl.BACK` culling), causing inside-out surfaces.
|
|
171
|
+
2. **Compression Decoders:**
|
|
172
|
+
- `compression.draco: true` (`KHR_draco_mesh_compression`) requires `DRACOLoader` with WASM/JS decoder files hosted at `dracoGltfPath`.
|
|
173
|
+
- `compression.meshopt: true` (`EXT_meshopt_compression`) requires `MeshoptDecoder` attached via `loader.setMeshoptDecoder(MeshoptDecoder)`.
|
|
174
|
+
- `compression.ktx2BasisU: true` (`KHR_texture_basisu`) requires `KTX2Loader` initialized with `ktx2Loader.detectSupport(renderer)` before `loader.load()`.
|