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,212 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: glb-web-handoff
|
|
3
|
+
description: Prepare truthful GLB web handoff docs for Three.js, R3F, Godot, UE5, and Unity with Meshopt/KTX2 budgets, tone parity, and status caveats.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# glb-web-handoff
|
|
7
|
+
|
|
8
|
+
## Purpose
|
|
9
|
+
Define reliable handoff language and checks for GLB/web scenarios without overclaiming.
|
|
10
|
+
|
|
11
|
+
## Quick start
|
|
12
|
+
- confirm this skill fits your goal
|
|
13
|
+
- provide required inputs first
|
|
14
|
+
- keep runtime claims evidence-bound
|
|
15
|
+
- follow suggested next-skill handoff
|
|
16
|
+
|
|
17
|
+
## When to use
|
|
18
|
+
- when writing the GLB/web handoff summary after upstream validation from `scene-readiness` and evidence classification from `render-export-evidence`
|
|
19
|
+
- when summarizing per-artifact export statuses and web compatibility assumptions/caveats (transform/scale/origin, material/texture portability, loader/extensions, stack, performance)
|
|
20
|
+
- when preparing truthful next checks before passing final wording to `plain-language-response`
|
|
21
|
+
|
|
22
|
+
## When not to use
|
|
23
|
+
<!-- blendops:generated:start exclusions -->
|
|
24
|
+
- to claim GLB or export success without concrete evidence → use `../scene-readiness/SKILL.md` (Delegates out-of-scope requests to scene-readiness)
|
|
25
|
+
- to replace runtime export verification → use `../render-export-evidence/SKILL.md` (Delegates out-of-scope requests to render-export-evidence)
|
|
26
|
+
- to validate upstream scene readiness → use `../scene-readiness/SKILL.md` (use scene-readiness)
|
|
27
|
+
- to classify raw render/export artifact evidence → use `../render-export-evidence/SKILL.md` (use render-export-evidence)
|
|
28
|
+
- to define mobile or file-size performance budgets → use `../mobile-glb-budget/SKILL.md` (use mobile-glb-budget)
|
|
29
|
+
- to define animation playback or rig contracts → use `../glb-animation-handoff/SKILL.md` (use glb-animation-handoff)
|
|
30
|
+
- to write the final user-facing response wording → use `../plain-language-response/SKILL.md` (use plain-language-response)
|
|
31
|
+
<!-- blendops:generated:end exclusions -->
|
|
32
|
+
|
|
33
|
+
## Trigger phrases
|
|
34
|
+
<!-- blendops:generated:start triggers -->
|
|
35
|
+
- "prepare web handoff"
|
|
36
|
+
- "is GLB ready"
|
|
37
|
+
- "summarize export status"
|
|
38
|
+
<!-- blendops:generated:end triggers -->
|
|
39
|
+
|
|
40
|
+
## Prerequisites / readiness
|
|
41
|
+
- upstream readiness output from `scene-readiness` available (or marked unverified)
|
|
42
|
+
- classified artifact evidence state from `render-export-evidence` known
|
|
43
|
+
- runtime mode known (within the 2-path + CLI appendix runtime model)
|
|
44
|
+
|
|
45
|
+
## Input schema
|
|
46
|
+
|
|
47
|
+
### Required inputs
|
|
48
|
+
- per-artifact status evidence from `render-export-evidence` (with provenance to the current run for any pre-existing files)
|
|
49
|
+
- upstream readiness summary from `scene-readiness`
|
|
50
|
+
- handoff target context and known compatibility assumptions
|
|
51
|
+
|
|
52
|
+
### Optional inputs
|
|
53
|
+
- size/performance budget outputs from `mobile-glb-budget`
|
|
54
|
+
- animation handoff notes from `glb-animation-handoff`
|
|
55
|
+
- expected downstream web stack details
|
|
56
|
+
|
|
57
|
+
### Assumptions to confirm
|
|
58
|
+
- transform/scale/origin assumptions
|
|
59
|
+
- material/texture portability assumptions
|
|
60
|
+
- loader/extensions assumptions
|
|
61
|
+
- target web stack assumptions
|
|
62
|
+
- performance assumptions and caveats
|
|
63
|
+
- truth states are downgrade-only (never upgrade):
|
|
64
|
+
- Runtime: `Not Run | Attempted | Produced | Verified | Failed`
|
|
65
|
+
- Artifacts: `Not Run | Not Produced | Produced | Verified | Failed` (default `Not Produced`)
|
|
66
|
+
|
|
67
|
+
## Output schema
|
|
68
|
+
|
|
69
|
+
### Primary output
|
|
70
|
+
- truthful GLB/web handoff summary with explicit Runtime status and per-artifact statuses
|
|
71
|
+
|
|
72
|
+
### Secondary output
|
|
73
|
+
- compatibility assumptions and caveats covering transform/scale/origin, material/texture portability, loader/extensions, stack, and performance
|
|
74
|
+
|
|
75
|
+
### Evidence / caveat output
|
|
76
|
+
- explicit Runtime status (`Not Run | Attempted | Produced | Verified | Failed`) and per-artifact status (`Not Run | Not Produced | Produced | Verified | Failed`, default `Not Produced`), downgrade-only
|
|
77
|
+
- provenance confirmation tying any `Produced` or `Verified` artifact to the current run
|
|
78
|
+
- unresolved risk notes, next checks, and cross-skill handoffs
|
|
79
|
+
|
|
80
|
+
## Required laws
|
|
81
|
+
- ../../laws/evidence-before-done.md
|
|
82
|
+
- ../../laws/official-runtime-only.md
|
|
83
|
+
- ../../laws/non-blender-user-language.md
|
|
84
|
+
- ../../laws/no-arbitrary-python-interface.md
|
|
85
|
+
|
|
86
|
+
## Official runtime boundary
|
|
87
|
+
Never claim GLB or export success without concrete evidence tied to the current run, and never replace runtime export verification. Keep runtime vocabulary strictly within the 2-path (Path 1 Official Blender Lab MCP 5.1+, Path 2 community `mcp-for-blender`) + CLI appendix model. This skill never runs Blender or Python and never upgrades Runtime or Artifact truth states (downgrade-only).
|
|
88
|
+
|
|
89
|
+
## Operating procedure
|
|
90
|
+
1. Enumerate expected handoff artifacts (GLB, preview renders, reports) and check current-run provenance for any pre-existing files.
|
|
91
|
+
2. Inspect the GLB 2.0 binary container with `scripts/inspect-glb.mjs` (`blendops glb-inspect`) and generate/validate the structured handoff manifest (`schemas/glb-web-handoff-manifest.schema.json`) via `scripts/generate-glb-handoff-report.mjs` (`blendops glb-handoff`) across all four validation tiers (Tier 1 Container Structural, Tier 2 Khronos glTF 2.0 Specification, Tier 3 Visual Quality, Tier 4 Live Blender Runtime).
|
|
92
|
+
3. Record Runtime status (`Not Run | Attempted | Produced | Verified | Failed`) and mark each artifact status (`Not Produced | Produced | Verified | Failed`, default `Not Produced`) using `render-export-evidence` without upgrading any state.
|
|
93
|
+
4. Document transform/scale/origin assumptions and caveats (`+Y up, +Z forward, -X right`, `1 unit = 1 meter`, non-identity or negative root scale checks).
|
|
94
|
+
5. Document material/texture portability assumptions and caveats (embedded `bufferView` vs external URI textures, KTX2/WebP transcoders, alpha modes).
|
|
95
|
+
6. Document loader/extensions and target web stack compatibility assumptions (`DRACOLoader`, `MeshoptDecoder`, `KTX2Loader`, Three.js / React Three Fiber integration modules in `docs/examples/glb-web-handoff/README.md`) without inventing unsupported guarantees.
|
|
96
|
+
7. Document performance caveats and uncertainty (incorporating `mobile-glb-budget` if size budgets apply, and `glb-animation-handoff` if animation contracts apply).
|
|
97
|
+
8. Verify compliance with evidence boundaries and upstream `scene-readiness` findings, then hand off to `plain-language-response` for final user-facing wording.
|
|
98
|
+
|
|
99
|
+
## Decision tree
|
|
100
|
+
- If concrete current-run GLB evidence is classified by `render-export-evidence` -> report `Produced` or `Verified` (matching evidence, never upgraded) + full compatibility caveats.
|
|
101
|
+
- If a GLB file exists on disk but lacks provenance to the current run -> do not claim `Produced` or `Verified`; downgrade to `Not Produced` with a provenance caveat.
|
|
102
|
+
- If runtime was not executed -> mark Runtime `Not Run` and artifacts `Not Run` or default `Not Produced`.
|
|
103
|
+
- If runtime was `Attempted` or `Failed` and no valid GLB was exported -> mark artifact `Not Produced` or `Failed` with failure notes and next checks.
|
|
104
|
+
- If size budgets or animation contracts are needed -> route to `mobile-glb-budget` or `glb-animation-handoff` respectively.
|
|
105
|
+
- Once handoff summary is complete -> hand off to `plain-language-response` for final user-facing wording.
|
|
106
|
+
|
|
107
|
+
## Playbooks
|
|
108
|
+
- Playbook A: text-only planning path
|
|
109
|
+
- Playbook B: runtime-ready path with evidence gating
|
|
110
|
+
- Playbook C: blocked runtime path with caveat-first reporting
|
|
111
|
+
|
|
112
|
+
## Mode handling
|
|
113
|
+
|
|
114
|
+
### Text-only mode
|
|
115
|
+
- document handoff expectations, compatibility assumptions, and caveats only
|
|
116
|
+
- mark Runtime `Not Run` and artifacts `Not Run` or `Not Produced` (default `Not Produced`)
|
|
117
|
+
|
|
118
|
+
### Runtime-ready mode
|
|
119
|
+
- report evidence-linked Runtime status (`Not Run | Attempted | Produced | Verified | Failed`) and per-artifact statuses (`Not Run | Not Produced | Produced | Verified | Failed`, default `Not Produced`) with current-run provenance and downgrade-only enforcement
|
|
120
|
+
|
|
121
|
+
### Blocked runtime mode
|
|
122
|
+
- make zero production or verification claims; keep artifacts at `Not Produced`, `Not Run`, or `Failed`
|
|
123
|
+
- provide blocker-driven next checks and compatibility caveats
|
|
124
|
+
|
|
125
|
+
## Validation checklist
|
|
126
|
+
- [ ] Runtime status (`Not Run | Attempted | Produced | Verified | Failed`) explicit
|
|
127
|
+
- [ ] GLB and preview per-artifact statuses (`Not Produced | Produced | Verified | Failed`, default `Not Produced`) explicit
|
|
128
|
+
- [ ] current-run provenance verified for any pre-existing files (synthetic test fixtures remain `Not Produced`)
|
|
129
|
+
- [ ] truth states strictly downgrade-only (never upgraded)
|
|
130
|
+
- [ ] 4-tier validation summary explicit (Container Structural, glTF 2.0 Specification, Visual Quality, Live Runtime)
|
|
131
|
+
- [ ] transform/scale/origin assumptions documented
|
|
132
|
+
- [ ] material/texture portability caveats documented
|
|
133
|
+
- [ ] loader/extensions assumptions documented (`DRACOLoader`, `MeshoptDecoder`, `KTX2Loader`)
|
|
134
|
+
- [ ] target stack assumptions documented (`threejs`, `react-three-fiber`, `model-viewer`, `babylonjs`)
|
|
135
|
+
- [ ] performance caveats documented
|
|
136
|
+
- [ ] no unsupported readiness guarantees or role blur with evidence/quality/budget/animation/response skills
|
|
137
|
+
- [ ] actionable next checks and handoff to `plain-language-response` included
|
|
138
|
+
|
|
139
|
+
## Pass / Warn / Fail rubric
|
|
140
|
+
|
|
141
|
+
| Category | Pass | Warn | Fail |
|
|
142
|
+
|---|---|---|---|
|
|
143
|
+
| Artifact truth | Status matches evidence | Partial evidence | Claims without evidence |
|
|
144
|
+
| Compatibility clarity | Assumptions/caveats complete | Some gaps | Missing assumptions |
|
|
145
|
+
| Web handoff usability | Clear next actions | Partial actionability | Confusing or incomplete |
|
|
146
|
+
| Evidence boundary | No overclaims | Minor ambiguity | Contradictory claims |
|
|
147
|
+
|
|
148
|
+
## Failure handling
|
|
149
|
+
- Missing evidence: mark Runtime `Not Run` (or `Attempted`) and artifacts `Not Produced` (default) or `Not Run`, then route to `render-export-evidence` / list missing checks.
|
|
150
|
+
- Failed export evidence: mark Runtime/artifact `Failed` or `Not Produced` (downgrade-only), record failure reason, and list next checks.
|
|
151
|
+
- Pre-existing file without current-run provenance: refuse `Produced`/`Verified` status, keep at `Not Produced`, and require a fresh verified export run.
|
|
152
|
+
- Unknown compatibility in any of the 5 categories: mark `Warn` with an explicit caveat rather than assuming support.
|
|
153
|
+
|
|
154
|
+
## Troubleshooting
|
|
155
|
+
- Existing files found: verify provenance before claiming produced.
|
|
156
|
+
- Missing scale/origin assumptions: add as blocker.
|
|
157
|
+
- Missing stack assumptions: mark handoff as conditional.
|
|
158
|
+
|
|
159
|
+
## Best practices
|
|
160
|
+
- Always pair every per-artifact status with its matching compatibility caveats.
|
|
161
|
+
- Enforce downgrade-only truth states and verify current-run provenance before accepting any file as `Produced` or `Verified`.
|
|
162
|
+
- Keep handoff notes in plain language and hand off final user-facing phrasing to `plain-language-response`.
|
|
163
|
+
|
|
164
|
+
## Good examples
|
|
165
|
+
"Runtime status: `Not Run`. Artifact statuses: GLB `Not Produced` (default), Preview `Not Produced`. Compatibility assumptions & caveats: transform/scale/origin (1 unit = 1m, Z-up to Y-up conversion unverified), material/texture portability (procedural nodes must be baked before GLB export), loader/extensions (unverified compression/extension support), stack (target web viewer unspecified), performance (draw-call and file-size budget unverified; route to `mobile-glb-budget` if constrained). Next checks: run export via configured runtime path, classify evidence with `render-export-evidence`, and pass summary to `plain-language-response`."
|
|
166
|
+
|
|
167
|
+
## Bad examples
|
|
168
|
+
“GLB is ready for production.” (no artifact proof)
|
|
169
|
+
|
|
170
|
+
## User-facing response template
|
|
171
|
+
- Runtime status (`Not Run | Attempted | Produced | Verified | Failed`)
|
|
172
|
+
- Per-artifact statuses (`Not Run | Not Produced | Produced | Verified | Failed`, default `Not Produced`) with current-run provenance notes
|
|
173
|
+
- Compatibility assumptions and caveats:
|
|
174
|
+
- Transform / scale / origin
|
|
175
|
+
- Material / texture portability
|
|
176
|
+
- Loader / extensions
|
|
177
|
+
- Target stack
|
|
178
|
+
- Performance
|
|
179
|
+
- Unverified risks and next checks
|
|
180
|
+
- Cross-skill handoff (to `plain-language-response` for final user-facing wording)
|
|
181
|
+
|
|
182
|
+
## Anti-patterns
|
|
183
|
+
- skipping required laws or runtime boundary statements
|
|
184
|
+
- claiming runtime/artifact success without evidence
|
|
185
|
+
- using non-official runtime setup paths
|
|
186
|
+
- producing jargon-heavy final output without explanation
|
|
187
|
+
|
|
188
|
+
## Cross-skill handoff
|
|
189
|
+
<!-- blendops:generated:start handoffs -->
|
|
190
|
+
- [upstream_reference] Upstream scene readiness validation → `../scene-readiness/SKILL.md`
|
|
191
|
+
- [upstream_reference] Upstream artifact evidence classification → `../render-export-evidence/SKILL.md`
|
|
192
|
+
- [upstream_reference] Mobile and file-size budget constraints → `../mobile-glb-budget/SKILL.md`
|
|
193
|
+
- [upstream_reference] Animation playback and rig handoff contracts → `../glb-animation-handoff/SKILL.md`
|
|
194
|
+
- [progression] Final user-facing response wording → `../plain-language-response/SKILL.md`
|
|
195
|
+
<!-- blendops:generated:end handoffs -->
|
|
196
|
+
|
|
197
|
+
## Non-goals
|
|
198
|
+
- Generating Python scripts or executing Blender exports
|
|
199
|
+
- Replacing runtime export verification
|
|
200
|
+
- Upgrading Runtime or Artifact truth states or accepting pre-existing files without current-run provenance
|
|
201
|
+
- Classifying raw render/export evidence (`render-export-evidence`) or validating upstream scene quality (`scene-readiness`)
|
|
202
|
+
- Defining size budgets (`mobile-glb-budget`), animation contracts (`glb-animation-handoff`), or final user-facing wording (`plain-language-response`)
|
|
203
|
+
- Making unsupported web stack or loader compatibility guarantees
|
|
204
|
+
|
|
205
|
+
## References
|
|
206
|
+
- https://www.blender.org/lab/mcp-server/
|
|
207
|
+
- https://claude.com/resources/tutorials/using-the-blender-connector-in-claude
|
|
208
|
+
- https://docs.blender.org/manual/en/latest/advanced/command_line/index.html
|
|
209
|
+
- [`../../schemas/glb-web-handoff-manifest.schema.json`](../../schemas/glb-web-handoff-manifest.schema.json)
|
|
210
|
+
- [`../../scripts/inspect-glb.mjs`](../../scripts/inspect-glb.mjs)
|
|
211
|
+
- [`../../scripts/generate-glb-handoff-report.mjs`](../../scripts/generate-glb-handoff-report.mjs)
|
|
212
|
+
- [`../../docs/examples/glb-web-handoff/README.md`](../../docs/examples/glb-web-handoff/README.md)
|
|
@@ -0,0 +1,171 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$schema": "../../schemas/skill-contract.schema.json",
|
|
3
|
+
"id": "glb-web-handoff",
|
|
4
|
+
"version": "1.0.0",
|
|
5
|
+
"category": "evidence-and-handoff",
|
|
6
|
+
"role": "web-glb-delivery-packager",
|
|
7
|
+
"purpose": "Prepare truthful GLB/web handoff output with explicit artifact status, assumptions, and caveats.",
|
|
8
|
+
"capabilityTier": "L0",
|
|
9
|
+
"triggers": [
|
|
10
|
+
"prepare web handoff",
|
|
11
|
+
"is GLB ready",
|
|
12
|
+
"summarize export status"
|
|
13
|
+
],
|
|
14
|
+
"exclusions": [
|
|
15
|
+
{
|
|
16
|
+
"condition": "to claim GLB or export success without concrete evidence",
|
|
17
|
+
"delegateTo": "scene-readiness",
|
|
18
|
+
"reason": "Delegates out-of-scope requests to scene-readiness"
|
|
19
|
+
},
|
|
20
|
+
{
|
|
21
|
+
"condition": "to replace runtime export verification",
|
|
22
|
+
"delegateTo": "render-export-evidence",
|
|
23
|
+
"reason": "Delegates out-of-scope requests to render-export-evidence"
|
|
24
|
+
},
|
|
25
|
+
{
|
|
26
|
+
"condition": "to validate upstream scene readiness",
|
|
27
|
+
"delegateTo": "scene-readiness",
|
|
28
|
+
"reason": "use scene-readiness"
|
|
29
|
+
},
|
|
30
|
+
{
|
|
31
|
+
"condition": "to classify raw render/export artifact evidence",
|
|
32
|
+
"delegateTo": "render-export-evidence",
|
|
33
|
+
"reason": "use render-export-evidence"
|
|
34
|
+
},
|
|
35
|
+
{
|
|
36
|
+
"condition": "to define mobile or file-size performance budgets",
|
|
37
|
+
"delegateTo": "mobile-glb-budget",
|
|
38
|
+
"reason": "use mobile-glb-budget"
|
|
39
|
+
},
|
|
40
|
+
{
|
|
41
|
+
"condition": "to define animation playback or rig contracts",
|
|
42
|
+
"delegateTo": "glb-animation-handoff",
|
|
43
|
+
"reason": "use glb-animation-handoff"
|
|
44
|
+
},
|
|
45
|
+
{
|
|
46
|
+
"condition": "to write the final user-facing response wording",
|
|
47
|
+
"delegateTo": "plain-language-response",
|
|
48
|
+
"reason": "use plain-language-response"
|
|
49
|
+
}
|
|
50
|
+
],
|
|
51
|
+
"inputs": {
|
|
52
|
+
"required": [
|
|
53
|
+
{
|
|
54
|
+
"name": "verified_or_planned_glb_artifact",
|
|
55
|
+
"type": "object",
|
|
56
|
+
"description": "GLB artifact evidence record (from render-export-evidence) or planned export specification"
|
|
57
|
+
},
|
|
58
|
+
{
|
|
59
|
+
"name": "target_web_viewer_stack",
|
|
60
|
+
"type": "string",
|
|
61
|
+
"description": "Target web runtime (Three.js, React Three Fiber, <model-viewer>, Babylon.js)"
|
|
62
|
+
}
|
|
63
|
+
],
|
|
64
|
+
"optional": [
|
|
65
|
+
{
|
|
66
|
+
"name": "animation_and_budget_contracts",
|
|
67
|
+
"type": "object",
|
|
68
|
+
"description": "Optional linked contracts from glb-animation-handoff and mobile-glb-budget"
|
|
69
|
+
}
|
|
70
|
+
]
|
|
71
|
+
},
|
|
72
|
+
"outputs": {
|
|
73
|
+
"primary": [
|
|
74
|
+
"web_glb_delivery_handoff_packet",
|
|
75
|
+
"scale_orientation_and_compression_manifest",
|
|
76
|
+
"viewer_integration_caveats"
|
|
77
|
+
],
|
|
78
|
+
"truthStatePolicy": {
|
|
79
|
+
"runtimeDefault": "Not Run",
|
|
80
|
+
"artifactDefault": "Not Produced",
|
|
81
|
+
"mutationRule": "downgrade_only"
|
|
82
|
+
}
|
|
83
|
+
},
|
|
84
|
+
"handoffs": [
|
|
85
|
+
{
|
|
86
|
+
"target": "scene-readiness",
|
|
87
|
+
"type": "upstream_reference",
|
|
88
|
+
"label": "Upstream scene readiness validation",
|
|
89
|
+
"when": {
|
|
90
|
+
"all": [
|
|
91
|
+
{
|
|
92
|
+
"field": "quality.domain",
|
|
93
|
+
"operator": "equals",
|
|
94
|
+
"value": "holistic"
|
|
95
|
+
},
|
|
96
|
+
{
|
|
97
|
+
"field": "stage.current",
|
|
98
|
+
"operator": "equals",
|
|
99
|
+
"value": "quality_validation"
|
|
100
|
+
}
|
|
101
|
+
]
|
|
102
|
+
}
|
|
103
|
+
},
|
|
104
|
+
{
|
|
105
|
+
"target": "render-export-evidence",
|
|
106
|
+
"type": "upstream_reference",
|
|
107
|
+
"label": "Upstream artifact evidence classification",
|
|
108
|
+
"when": {
|
|
109
|
+
"all": [
|
|
110
|
+
{
|
|
111
|
+
"field": "stage.current",
|
|
112
|
+
"operator": "equals",
|
|
113
|
+
"value": "post_execution_audit"
|
|
114
|
+
}
|
|
115
|
+
]
|
|
116
|
+
}
|
|
117
|
+
},
|
|
118
|
+
{
|
|
119
|
+
"target": "mobile-glb-budget",
|
|
120
|
+
"type": "upstream_reference",
|
|
121
|
+
"label": "Mobile and file-size budget constraints",
|
|
122
|
+
"when": {
|
|
123
|
+
"all": [
|
|
124
|
+
{
|
|
125
|
+
"field": "artifact.type",
|
|
126
|
+
"operator": "equals",
|
|
127
|
+
"value": "glb"
|
|
128
|
+
},
|
|
129
|
+
{
|
|
130
|
+
"field": "budget.pinned",
|
|
131
|
+
"operator": "equals",
|
|
132
|
+
"value": false
|
|
133
|
+
}
|
|
134
|
+
]
|
|
135
|
+
}
|
|
136
|
+
},
|
|
137
|
+
{
|
|
138
|
+
"target": "glb-animation-handoff",
|
|
139
|
+
"type": "upstream_reference",
|
|
140
|
+
"label": "Animation playback and rig handoff contracts",
|
|
141
|
+
"when": {
|
|
142
|
+
"all": [
|
|
143
|
+
{
|
|
144
|
+
"field": "artifact.hasAnimation",
|
|
145
|
+
"operator": "equals",
|
|
146
|
+
"value": true
|
|
147
|
+
},
|
|
148
|
+
{
|
|
149
|
+
"field": "stage.current",
|
|
150
|
+
"operator": "equals",
|
|
151
|
+
"value": "animation_handoff"
|
|
152
|
+
}
|
|
153
|
+
]
|
|
154
|
+
}
|
|
155
|
+
},
|
|
156
|
+
{
|
|
157
|
+
"target": "plain-language-response",
|
|
158
|
+
"type": "progression",
|
|
159
|
+
"label": "Final user-facing response wording",
|
|
160
|
+
"when": {
|
|
161
|
+
"all": [
|
|
162
|
+
{
|
|
163
|
+
"field": "stage.current",
|
|
164
|
+
"operator": "equals",
|
|
165
|
+
"value": "final_communication"
|
|
166
|
+
}
|
|
167
|
+
]
|
|
168
|
+
}
|
|
169
|
+
}
|
|
170
|
+
]
|
|
171
|
+
}
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
# Artifact Status Language
|
|
2
|
+
|
|
3
|
+
## Purpose
|
|
4
|
+
Standardize every artifact truth claim during GLB export, validation, and web handoff so non-Blender stakeholders never mistake a planned file or config for a verified export on disk.
|
|
5
|
+
|
|
6
|
+
## When to use
|
|
7
|
+
- At the end of `glb-web-handoff`, `mobile-glb-budget`, `r3f-component-plan`, `preview-report`, and `pre-handoff-verification`.
|
|
8
|
+
|
|
9
|
+
## Canonical Artifact Truth Matrix
|
|
10
|
+
|
|
11
|
+
| Status Label | Allowed When | Required Companion Evidence |
|
|
12
|
+
|---|---|---|
|
|
13
|
+
| `Artifact status: Not Produced` | Planning-only pass, dry-run compile, blocked runtime, or export step did not write a file on disk | State what blocked output (`Runtime status: Not Run` or `Blocked`) and the exact next export command/path |
|
|
14
|
+
| `Artifact status: Produced` | Export file exists at a concrete disk path with verified byte size `> 0`, but viewer/validator checks have not completed | Exact path + file size (e.g., `exports/hero-shoe.glb`, `2.84 MB`); explicitly state `Validation: Not Run` or `Pending` |
|
|
15
|
+
| `Artifact status: Verified` | File exists on disk **AND** automated inspection (`blendops glb-inspect`, `gltf-validator`) + render/viewer smoke pass with `0` errors | Path, byte size, triangle/material/texture counts, `gltf-validator` error count (`0`), and verified viewer check |
|
|
16
|
+
| `Artifact status: Failed` | Export attempted but wrote `0` bytes, threw Blender glTF exporter error, or failed `gltf-validator` / budget gate | Exact error message + failing metric (e.g. `142k tris exceeds 50k mobile budget`) + concrete fix step |
|
|
17
|
+
|
|
18
|
+
> **Hard Rule**: Never assign `Not Run` to `Artifact status`. `Not Run` applies to **Runtime / Validation status** (`Runtime status: Not Run`), while files on disk default to **`Artifact status: Not Produced`**.
|
|
19
|
+
|
|
20
|
+
## Good vs. Bad Examples
|
|
21
|
+
- **Good**: `"Runtime status: Not Run. Artifact status: Not Produced — no .glb file was written in this planning pass. Planned target: exports/cyberpunk-shoe.glb (<= 5 MB, KTX2/Meshopt optional). Next: execute Path 1/CLI export and run blendops glb-inspect."`
|
|
22
|
+
- **Good**: `"Runtime status: Verified (CLI Blender 5.2.3). Artifact status: Verified — exports/hero.glb (2.41 MB, 31,420 tris, 3 materials, gltf-validator: 0 errors, Three.js Canvas render confirmed)."`
|
|
23
|
+
- **Bad**: `"GLB done and web-ready!"` (missing path, file size, validator result, or fabricated on a planning pass).
|
|
24
|
+
|
|
25
|
+
## Related skill
|
|
26
|
+
[../SKILL.md](../SKILL.md)
|
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
# GLB Handoff Checklist
|
|
2
|
+
|
|
3
|
+
## Purpose
|
|
4
|
+
Define minimum checks before GLB/web handoff claims, pairing `scripts/inspect-glb.mjs` and `scripts/generate-glb-handoff-report.mjs` with `schemas/glb-web-handoff-manifest.schema.json`.
|
|
5
|
+
|
|
6
|
+
## When to use
|
|
7
|
+
In the GLB web handoff reporting stage (`blendops glb-inspect` / `blendops glb-handoff` / `blendops glb-validate-manifest`).
|
|
8
|
+
|
|
9
|
+
## Checklist
|
|
10
|
+
- Runtime status (`Not Run | Attempted | Produced | Verified | Failed`) explicit
|
|
11
|
+
- GLB and preview status (`Not Produced | Produced | Verified | Failed`, default `Not Produced`) explicit
|
|
12
|
+
- 4-tier validation summary explicit (Container Structural, glTF 2.0 Specification, Visual Quality, Live Runtime)
|
|
13
|
+
- Transform, scale (`1 unit = 1m`, `+Y up`), and origin placement assumptions explicit
|
|
14
|
+
- Material, texture storage (`bufferView` vs external URI), and compression decoder (`DRACOLoader`, `MeshoptDecoder`, `KTX2Loader`) caveats explicit
|
|
15
|
+
- Next verification actions explicit
|
|
16
|
+
|
|
17
|
+
- Web compression & budget hints explicit: prefer `EXT_meshopt_compression` + WebP (`q85`) or KTX2/Basis (`--texture-compress ktx2`), or `Draco` when decoding speed allows; target `<= 2–5 MB` per hero GLB (`<= 10–20 MB` scene, `<= 50–100` draw calls on mobile web)
|
|
18
|
+
- Tone-mapping parity documented: match Blender `Khronos PBR Neutral` with Three.js `NeutralToneMapping` + `SRGBColorSpace`
|
|
19
|
+
- Non-web engine hints (if multi-target delivery requested alongside GLB): Godot import suffixes (`-col`, `-colonly`, `-convcolonly`, `-loop`); Unreal FBX/Interchange (`UCX_` collisions, DirectX `-Y` normal, ORM packing); Unity FBX (`Humanoid` root at world origin facing `-Y`)
|
|
20
|
+
|
|
21
|
+
## Good example
|
|
22
|
+
Includes `Runtime status: Not Run` and `Artifact status: Not Produced` (or current-run evidence-backed status) alongside the 4-tier validation summary and decoder setup notes.
|
|
23
|
+
|
|
24
|
+
## Bad example
|
|
25
|
+
Claims handoff complete or marks `Artifact status: Not Run` / `Verified` without artifact evidence.
|
|
26
|
+
|
|
27
|
+
## Related skill
|
|
28
|
+
- [`../SKILL.md`](../SKILL.md)
|
|
29
|
+
- [`../../../schemas/glb-web-handoff-manifest.schema.json`](../../../schemas/glb-web-handoff-manifest.schema.json)
|
|
30
|
+
- [`../../../docs/examples/glb-web-handoff/README.md`](../../../docs/examples/glb-web-handoff/README.md)
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
# Performance Caveats & Honest Budget Framing
|
|
2
|
+
|
|
3
|
+
## Purpose
|
|
4
|
+
Capture realistic web/mobile 3D performance risks and VRAM constraints without guessing or claiming unmeasured FPS targets.
|
|
5
|
+
|
|
6
|
+
## When to use
|
|
7
|
+
Whenever preparing GLB web handoff caveats, reviewing mobile budgets, or auditing scene complexity gaps.
|
|
8
|
+
|
|
9
|
+
## Quantified Caveat Categories
|
|
10
|
+
|
|
11
|
+
| Risk Category | Concrete Metric to Flag | Real User Impact | Corrective Action |
|
|
12
|
+
|---|---|---|---|
|
|
13
|
+
| **Payload Transfer Size** | Raw uncompressed `.glb > 5 MB` (hero) or `> 15 MB` (scene) | Slow initial FCP/LCP on cellular (`4G` takes `4–12s+`) | Apply `EXT_meshopt_compression` / WebP / KTX2 (`mobile-glb-budget`) |
|
|
14
|
+
| **GPU Texture VRAM (`Uncompressed`)** | Uncompressed RGBA GPU footprint = `width × height × 4 bytes × 1.33 mipmaps` (e.g. one `4096²` PNG = `~89 MB` VRAM!) | Mobile Safari / Chrome Android WebGL context loss & crash | Cap mobile hero textures at `1024²` or `2048²` **packed KTX2 (UASTC/ETC1S)** |
|
|
15
|
+
| **Draw Calls & Material Slots** | `> 25–40` distinct materials or unmerged static small parts | CPU JS/WebGL frame stall even at moderate triangle counts | Merge static parts per material (`≤ 8–16` draw calls for hero) |
|
|
16
|
+
| **Transparent Overdraw** | Stacked alpha-blended meshes or full-screen `Transmission` passes | Multiplies WebGL fragment shader cost on mobile GPUs | Use `OPAQUE` or `MASK` cutout where possible; avoid nested transmission |
|
|
17
|
+
| **Runtime Coverage Gap** | Verified only via `gltf-validator` / container header (`Not Run` in browser) | Actual frame time, lighting mood, and shader compile lag remain unknown | Explicitly label `Live browser performance: Not Run` and list target device test next |
|
|
18
|
+
|
|
19
|
+
## Good example
|
|
20
|
+
"GLB container inspected (`2.4 MB`, `18.2k` triangles, `4` materials). Uncompressed `2048²` PNG maps require further KTX2 testing on iOS Safari; browser FPS probe: `Not Run`."
|
|
21
|
+
|
|
22
|
+
## Bad example
|
|
23
|
+
"Runs smoothly at 60 FPS everywhere." (Unmeasured claim with zero device/VRAM evidence.)
|
|
24
|
+
|
|
25
|
+
## Related skill
|
|
26
|
+
- [SKILL.md](../SKILL.md)
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
# Three.js / R3F Handoff Notes
|
|
2
|
+
|
|
3
|
+
## Purpose
|
|
4
|
+
Provide concrete integration conventions and verification boundaries for Three.js (`r155+`) and React Three Fiber (`@react-three/fiber` + `@react-three/drei`) web delivery planning.
|
|
5
|
+
|
|
6
|
+
## When to use
|
|
7
|
+
Whenever a user requests GLB web handoff notes, `<Canvas>` setup defaults, or viewer integration references for Three.js or React Three Fiber.
|
|
8
|
+
|
|
9
|
+
## Integration & Color-Parity Contract
|
|
10
|
+
1. **Coordinate, Scale & Origin**: Document explicit glTF convention (`+Y up, +Z forward, -X right`), metric scale (`1 unit = 1 meter`), and pivot origin (base center `y = 0` after Blender `+Z → +Y` export transform).
|
|
11
|
+
2. **Color-Management Parity**: Match Blender `Khronos PBR Neutral` / `AgX` expectations explicitly using `gl={{ toneMapping: THREE.NeutralToneMapping, toneMappingExposure: 1.0, outputColorSpace: THREE.SRGBColorSpace }}` (`ACESFilmicToneMapping` shifts vivid saturated hues unless intended).
|
|
12
|
+
3. **Canonical Viewer Modules**: Reference [`../../../docs/examples/glb-web-handoff/README.md`](../../../docs/examples/glb-web-handoff/README.md) (`threejs-glb-viewer.mjs` and `r3f-glb-viewer.tsx`) rather than inventing ad-hoc snippet patterns.
|
|
13
|
+
4. **Decoder Pairing Rules**:
|
|
14
|
+
- `EXT_meshopt_compression` → wire `GLTFLoader.setMeshoptDecoder(MeshoptDecoder)` (preferred fast web decompression).
|
|
15
|
+
- `KHR_draco_mesh_compression` → wire `DRACOLoader` with pinned CDN or local `/draco/` WASM path.
|
|
16
|
+
- `KHR_texture_basisu` → wire `KTX2Loader.detectSupport(renderer)` with `/basis/` transcoder path.
|
|
17
|
+
5. **Lifecycle & Disposal Guard**: Preload via `useGLTF.preload(url)` (`drei`) or dispose geometries/materials/textures on unmount so SPA route changes never leak GPU buffers.
|
|
18
|
+
6. **Caveat-First Truthfulness**: Client-side parsing in Three.js or R3F checks **container structure only (`Tier 1/2`)** — it does **not** verify visual fidelity (`Tier 3`) or live Blender runtime (`Tier 4`).
|
|
19
|
+
|
|
20
|
+
## Good example
|
|
21
|
+
Lists scale/origin/toneMapping/decoder assumptions, references `blendops glb-handoff`, and states next verification checks cleanly (`Artifact status: Not Produced` until `.glb` exists).
|
|
22
|
+
|
|
23
|
+
## Bad example
|
|
24
|
+
Claims guaranteed web look-dev parity without matching tone mapping, decoder setup, or visual browser inspection.
|
|
25
|
+
|
|
26
|
+
## Related skill
|
|
27
|
+
- [`../SKILL.md`](../SKILL.md)
|
|
28
|
+
- [`../../../docs/examples/glb-web-handoff/README.md`](../../../docs/examples/glb-web-handoff/README.md)
|
|
@@ -0,0 +1,82 @@
|
|
|
1
|
+
# EVAL — intent-to-3d-brief-writer
|
|
2
|
+
|
|
3
|
+
Status: 1.0.0 text-only baseline
|
|
4
|
+
Scope: produces 8-slot structured brief; no runtime; no artifacts.
|
|
5
|
+
|
|
6
|
+
## Text-only eval prompt
|
|
7
|
+
|
|
8
|
+
Use intent-to-3d-brief-writer to convert a confirmed intent into the 8-slot brief. Echo the brief to the user. Hand off to the relevant planner.
|
|
9
|
+
|
|
10
|
+
## Expected behavior
|
|
11
|
+
|
|
12
|
+
- fills all 8 slots (subject, mood, deliverables, constraints, evidence, acceptance, audience, owner)
|
|
13
|
+
- batches any missing-slot questions in one turn
|
|
14
|
+
- echoes the brief to the user for confirmation
|
|
15
|
+
- lists decisions explicitly deferred to planners
|
|
16
|
+
- runtime status remains `Not Run`; artifact status `Not Produced`
|
|
17
|
+
- hands off to the relevant planner after confirmation
|
|
18
|
+
|
|
19
|
+
## Eval cases
|
|
20
|
+
|
|
21
|
+
| Case | Input | Expected output | Required evidence |
|
|
22
|
+
|---|---|---|---|
|
|
23
|
+
| Fully specified intent | Confirmed intent paragraph covers all 8 slots | Brief written, echoed, handed off | 8-slot markdown, deferred-decisions list |
|
|
24
|
+
| Half-specified intent | 5 of 8 slots present | Batch 3 missing-slot questions; write brief; echo | 8-slot markdown with `Unknown` filled where needed, questions answered |
|
|
25
|
+
| 4+ slots missing | Intent is too vague | Route back to `blender-brainstorming` | explicit re-route message, no brief written yet |
|
|
26
|
+
| Conflicting deliverable + constraint | "GLB for web AND 50MB poly budget" | Flag conflict in slot 4; ask user to resolve | conflict flag, resolution prompt |
|
|
27
|
+
| Mixed audience | Audience: marketing team + tech artist | Two sections (technical + plain-language); user-facing always plain-language | both sections present |
|
|
28
|
+
| User edits brief | After echo, user changes mood | Update brief, re-echo, await second confirmation | versioned brief, second confirmation |
|
|
29
|
+
| Iteration loop request | User wants text-only plan first, runtime later | Brief deliverables = text-only plan; evidence expectations = `Not Run` | brief explicitly text-only |
|
|
30
|
+
|
|
31
|
+
## Expected evidence/status fields
|
|
32
|
+
|
|
33
|
+
| Field | Required content |
|
|
34
|
+
|---|---|
|
|
35
|
+
| Subject | Plain language; no Blender jargon |
|
|
36
|
+
| Mood / style | Tone, references, brand notes if any |
|
|
37
|
+
| Deliverables | Exhaustive list (image / GLB / preview / response / combinations) |
|
|
38
|
+
| Constraints | Performance, scope, time, brand |
|
|
39
|
+
| Evidence expectations | Truth labels acceptable + required evidence fields |
|
|
40
|
+
| Acceptance criteria | Observable, not subjective |
|
|
41
|
+
| Audience | Named (e.g. "marketing team — non-Blender") |
|
|
42
|
+
| Owner | Named (operator / agent / human) |
|
|
43
|
+
| Decisions deferred | Explicit list with target skill |
|
|
44
|
+
| Runtime status | `Not Run` |
|
|
45
|
+
| Artifact status | `Not Produced` |
|
|
46
|
+
|
|
47
|
+
## Pass / Warn / Fail criteria
|
|
48
|
+
|
|
49
|
+
- Pass: all 8 slots filled or marked `Unknown` explicitly, plain language, acceptance criteria observable, brief echoed and confirmed by user
|
|
50
|
+
- Warn: 1-2 slots `Unknown` without follow-up, OR partly subjective acceptance criteria, OR brief written but not echoed
|
|
51
|
+
- Fail: 3+ slots missing without acknowledgment, OR jargon-heavy, OR claimed runtime / artifact production, OR brief invented slots not confirmed
|
|
52
|
+
|
|
53
|
+
## Common failure modes
|
|
54
|
+
|
|
55
|
+
- writing the brief without echoing to user
|
|
56
|
+
- inventing mood / constraint values
|
|
57
|
+
- using Blender jargon ("subsurf scattering", "BSDF", "topology") in the brief
|
|
58
|
+
- letting planners re-negotiate after handoff
|
|
59
|
+
- skipping owner slot (breaks accountability later)
|
|
60
|
+
|
|
61
|
+
## Evidence expectations
|
|
62
|
+
|
|
63
|
+
- 8-slot markdown brief visible
|
|
64
|
+
- echo + confirm cycle visible
|
|
65
|
+
- deferred-decisions list explicit
|
|
66
|
+
- handoff target named with reason
|
|
67
|
+
|
|
68
|
+
## Sample passing response outline
|
|
69
|
+
|
|
70
|
+
- TL;DR: <one line>
|
|
71
|
+
- Brief (8 slots in markdown)
|
|
72
|
+
- Decisions deferred: <list with target skill>
|
|
73
|
+
- Confirm or edit prompt
|
|
74
|
+
- After confirmation, handoff: `product-hero-scene-planner`
|
|
75
|
+
|
|
76
|
+
## Sample failing response outline
|
|
77
|
+
|
|
78
|
+
- Brief written without echo
|
|
79
|
+
- Subject slot has jargon
|
|
80
|
+
- 4 slots missing, no acknowledgment
|
|
81
|
+
- Skipped owner slot
|
|
82
|
+
- Claimed "runtime ready" when status is Not Run
|