blendops 0.0.0-stage → 1.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +62 -0
- package/LICENSE +21 -0
- package/README.md +189 -2
- package/bin/blendops.mjs +4 -0
- package/bundles/claude-desktop-manual/BLENDOPS_SINGLE_FILE.md +78 -0
- package/bundles/claude-desktop-manual/IMPORT_STEPS.md +43 -0
- package/bundles/claude-desktop-manual/INSTALL_REPORT_TEMPLATE.md +13 -0
- package/bundles/claude-desktop-manual/README.md +70 -0
- package/bundles/claude-desktop-manual/SKILL.md +62 -0
- package/bundles/claude-desktop-manual/manifest.json +278 -0
- package/bundles/claude-desktop-manual/references/evidence-rules.md +13 -0
- package/bundles/claude-desktop-manual/references/install-boundary.md +13 -0
- package/bundles/claude-desktop-manual/references/laws/evidence-before-done.md +14 -0
- package/bundles/claude-desktop-manual/references/laws/no-arbitrary-python-interface.md +12 -0
- package/bundles/claude-desktop-manual/references/laws/non-blender-user-language.md +13 -0
- package/bundles/claude-desktop-manual/references/laws/official-runtime-only.md +20 -0
- package/bundles/claude-desktop-manual/references/packs/product-hero-v0.md +30 -0
- package/bundles/claude-desktop-manual/references/runtime-stacks.md +13 -0
- package/bundles/claude-desktop-manual/references/skill-map.md +36 -0
- package/bundles/claude-desktop-manual/references/skills/acceptance-criteria-builder.md +69 -0
- package/bundles/claude-desktop-manual/references/skills/asset-discovery.md +73 -0
- package/bundles/claude-desktop-manual/references/skills/asset-fallback-strategy.md +66 -0
- package/bundles/claude-desktop-manual/references/skills/asset-library-plan.md +69 -0
- package/bundles/claude-desktop-manual/references/skills/asset-license-checker.md +69 -0
- package/bundles/claude-desktop-manual/references/skills/asset-style-check.md +69 -0
- package/bundles/claude-desktop-manual/references/skills/blender-brainstorming.md +62 -0
- package/bundles/claude-desktop-manual/references/skills/blender-recipe-decomposer.md +66 -0
- package/bundles/claude-desktop-manual/references/skills/blender-troubleshooting.md +78 -0
- package/bundles/claude-desktop-manual/references/skills/blendops-help.md +82 -0
- package/bundles/claude-desktop-manual/references/skills/bridge-conflicts.md +68 -0
- package/bundles/claude-desktop-manual/references/skills/camera-composition.md +65 -0
- package/bundles/claude-desktop-manual/references/skills/character-portrait.md +68 -0
- package/bundles/claude-desktop-manual/references/skills/cli-appendix-job-outline.md +62 -0
- package/bundles/claude-desktop-manual/references/skills/color-management-decision.md +68 -0
- package/bundles/claude-desktop-manual/references/skills/composition-quality-checker.md +71 -0
- package/bundles/claude-desktop-manual/references/skills/cycles-vs-eevee-decision.md +65 -0
- package/bundles/claude-desktop-manual/references/skills/done-criteria.md +70 -0
- package/bundles/claude-desktop-manual/references/skills/environment-shot.md +65 -0
- package/bundles/claude-desktop-manual/references/skills/glb-animation-handoff.md +69 -0
- package/bundles/claude-desktop-manual/references/skills/glb-web-handoff.md +68 -0
- package/bundles/claude-desktop-manual/references/skills/intent-to-3d-brief-writer.md +68 -0
- package/bundles/claude-desktop-manual/references/skills/interior-scene.md +73 -0
- package/bundles/claude-desktop-manual/references/skills/lighting-material-plan.md +65 -0
- package/bundles/claude-desktop-manual/references/skills/lighting-quality-checker.md +70 -0
- package/bundles/claude-desktop-manual/references/skills/material-quality-checker.md +71 -0
- package/bundles/claude-desktop-manual/references/skills/mobile-glb-budget.md +73 -0
- package/bundles/claude-desktop-manual/references/skills/output-format-decision.md +63 -0
- package/bundles/claude-desktop-manual/references/skills/pack-prerequisite-checker.md +74 -0
- package/bundles/claude-desktop-manual/references/skills/path-one-host-outline.md +66 -0
- package/bundles/claude-desktop-manual/references/skills/plain-language-response.md +70 -0
- package/bundles/claude-desktop-manual/references/skills/polycount-budget-checker.md +71 -0
- package/bundles/claude-desktop-manual/references/skills/pre-handoff-verification.md +76 -0
- package/bundles/claude-desktop-manual/references/skills/preview-report.md +62 -0
- package/bundles/claude-desktop-manual/references/skills/product-grid-scene-planner.md +72 -0
- package/bundles/claude-desktop-manual/references/skills/product-hero-scene-planner.md +68 -0
- package/bundles/claude-desktop-manual/references/skills/r3f-component-plan.md +66 -0
- package/bundles/claude-desktop-manual/references/skills/recipe-fit-assessor.md +75 -0
- package/bundles/claude-desktop-manual/references/skills/render-export-evidence.md +70 -0
- package/bundles/claude-desktop-manual/references/skills/resolution-aspect-decision.md +65 -0
- package/bundles/claude-desktop-manual/references/skills/runtime-attempt-report.md +67 -0
- package/bundles/claude-desktop-manual/references/skills/runtime-path-picker.md +67 -0
- package/bundles/claude-desktop-manual/references/skills/runtime-readiness.md +63 -0
- package/bundles/claude-desktop-manual/references/skills/runtime-setup.md +63 -0
- package/bundles/claude-desktop-manual/references/skills/scene-readiness.md +65 -0
- package/bundles/claude-desktop-manual/references/skills/scope-guard.md +62 -0
- package/bundles/claude-desktop-manual/references/skills/stage-gates.md +91 -0
- package/bundles/claude-desktop-manual/references/skills/workflow-stage-router.md +67 -0
- package/bundles/generic-project-local/BLENDOPS.md +71 -0
- package/bundles/generic-project-local/INSTALL_REPORT_TEMPLATE.md +52 -0
- package/bundles/generic-project-local/README.md +72 -0
- package/bundles/generic-project-local/ROLLBACK.md +66 -0
- package/bundles/generic-project-local/manifest.json +66 -0
- package/bundles/skill-package/README.md +54 -0
- package/bundles/skill-package/blendops/LICENSE.txt +21 -0
- package/bundles/skill-package/blendops/SKILL.md +50 -0
- package/bundles/skill-package/blendops/agents/README.md +61 -0
- package/bundles/skill-package/blendops/agents/openai.yaml +4 -0
- package/bundles/skill-package/blendops/references/evidence-rules.md +17 -0
- package/bundles/skill-package/blendops/references/install-boundary.md +13 -0
- package/bundles/skill-package/blendops/references/law-evidence-before-done.md +12 -0
- package/bundles/skill-package/blendops/references/law-no-arbitrary-python-interface.md +7 -0
- package/bundles/skill-package/blendops/references/law-non-blender-user-language.md +8 -0
- package/bundles/skill-package/blendops/references/law-official-runtime-only.md +9 -0
- package/bundles/skill-package/blendops/references/pack-product-hero-v0.md +21 -0
- package/bundles/skill-package/blendops/references/runtime-stacks.md +13 -0
- package/bundles/skill-package/blendops/references/skill-acceptance-criteria-builder.md +51 -0
- package/bundles/skill-package/blendops/references/skill-asset-discovery.md +54 -0
- package/bundles/skill-package/blendops/references/skill-asset-fallback-strategy.md +48 -0
- package/bundles/skill-package/blendops/references/skill-asset-library-plan.md +51 -0
- package/bundles/skill-package/blendops/references/skill-asset-license-checker.md +51 -0
- package/bundles/skill-package/blendops/references/skill-asset-style-check.md +52 -0
- package/bundles/skill-package/blendops/references/skill-blender-brainstorming.md +43 -0
- package/bundles/skill-package/blendops/references/skill-blender-recipe-decomposer.md +48 -0
- package/bundles/skill-package/blendops/references/skill-blender-troubleshooting.md +59 -0
- package/bundles/skill-package/blendops/references/skill-blendops-help.md +62 -0
- package/bundles/skill-package/blendops/references/skill-bridge-conflicts.md +48 -0
- package/bundles/skill-package/blendops/references/skill-camera-composition.md +48 -0
- package/bundles/skill-package/blendops/references/skill-character-portrait.md +50 -0
- package/bundles/skill-package/blendops/references/skill-cli-appendix-job-outline.md +44 -0
- package/bundles/skill-package/blendops/references/skill-color-management-decision.md +50 -0
- package/bundles/skill-package/blendops/references/skill-composition-quality-checker.md +53 -0
- package/bundles/skill-package/blendops/references/skill-cycles-vs-eevee-decision.md +47 -0
- package/bundles/skill-package/blendops/references/skill-done-criteria.md +53 -0
- package/bundles/skill-package/blendops/references/skill-environment-shot.md +47 -0
- package/bundles/skill-package/blendops/references/skill-glb-animation-handoff.md +51 -0
- package/bundles/skill-package/blendops/references/skill-glb-web-handoff.md +51 -0
- package/bundles/skill-package/blendops/references/skill-intent-to-3d-brief-writer.md +50 -0
- package/bundles/skill-package/blendops/references/skill-interior-scene.md +54 -0
- package/bundles/skill-package/blendops/references/skill-lighting-material-plan.md +48 -0
- package/bundles/skill-package/blendops/references/skill-lighting-quality-checker.md +52 -0
- package/bundles/skill-package/blendops/references/skill-map.md +32 -0
- package/bundles/skill-package/blendops/references/skill-material-quality-checker.md +53 -0
- package/bundles/skill-package/blendops/references/skill-mobile-glb-budget.md +55 -0
- package/bundles/skill-package/blendops/references/skill-output-format-decision.md +46 -0
- package/bundles/skill-package/blendops/references/skill-pack-prerequisite-checker.md +56 -0
- package/bundles/skill-package/blendops/references/skill-path-one-host-outline.md +48 -0
- package/bundles/skill-package/blendops/references/skill-plain-language-response.md +53 -0
- package/bundles/skill-package/blendops/references/skill-polycount-budget-checker.md +53 -0
- package/bundles/skill-package/blendops/references/skill-pre-handoff-verification.md +57 -0
- package/bundles/skill-package/blendops/references/skill-preview-report.md +45 -0
- package/bundles/skill-package/blendops/references/skill-product-grid-scene-planner.md +54 -0
- package/bundles/skill-package/blendops/references/skill-product-hero-scene-planner.md +51 -0
- package/bundles/skill-package/blendops/references/skill-r3f-component-plan.md +48 -0
- package/bundles/skill-package/blendops/references/skill-recipe-fit-assessor.md +57 -0
- package/bundles/skill-package/blendops/references/skill-render-export-evidence.md +51 -0
- package/bundles/skill-package/blendops/references/skill-resolution-aspect-decision.md +48 -0
- package/bundles/skill-package/blendops/references/skill-runtime-attempt-report.md +49 -0
- package/bundles/skill-package/blendops/references/skill-runtime-path-picker.md +49 -0
- package/bundles/skill-package/blendops/references/skill-runtime-readiness.md +45 -0
- package/bundles/skill-package/blendops/references/skill-runtime-setup.md +45 -0
- package/bundles/skill-package/blendops/references/skill-scene-readiness.md +48 -0
- package/bundles/skill-package/blendops/references/skill-scope-guard.md +44 -0
- package/bundles/skill-package/blendops/references/skill-stage-gates.md +73 -0
- package/bundles/skill-package/blendops/references/skill-workflow-stage-router.md +49 -0
- package/docs/examples/glb-web-handoff/README.md +174 -0
- package/docs/examples/glb-web-handoff/r3f-glb-viewer.tsx +320 -0
- package/docs/examples/glb-web-handoff/threejs-glb-viewer.mjs +709 -0
- package/docs/knowledge-and-recipe-catalog.md +236 -0
- package/docs/recipes/README.md +27 -0
- package/docs/recipes/cyberpunk-shoe-hero.md +97 -0
- package/docs/workflows/README.md +14 -0
- package/docs/workflows/full-non-blender-user-workflow.md +210 -0
- package/docs/workflows/product-hero-workflow.md +92 -0
- package/laws/README.md +32 -0
- package/laws/evidence-before-done.md +37 -0
- package/laws/no-arbitrary-python-interface.md +32 -0
- package/laws/non-blender-user-language.md +32 -0
- package/laws/official-runtime-only.md +78 -0
- package/package.json +99 -4
- package/packs/README.md +11 -0
- package/packs/product-hero-v0/PACK.md +114 -0
- package/registry/catalog-index.json +21344 -0
- package/registry/compatibility-matrix.json +533 -0
- package/registry/contract-context-fields.json +391 -0
- package/registry/knowledge-catalog.json +4648 -0
- package/registry/knowledge-sources.json +438 -0
- package/registry/recipe-catalog.json +2565 -0
- package/registry/runtime-capability-policy.json +525 -0
- package/registry/runtime-operations.json +4468 -0
- package/registry/skills.json +10231 -0
- package/registry/workflow-graph.json +7390 -0
- package/schemas/adapter-compatibility-matrix.schema.json +166 -0
- package/schemas/contract-context-fields.schema.json +147 -0
- package/schemas/execution-plan.schema.json +325 -0
- package/schemas/glb-web-handoff-manifest.schema.json +744 -0
- package/schemas/knowledge-record.schema.json +460 -0
- package/schemas/knowledge-source-registry.schema.json +268 -0
- package/schemas/operation-execution-ledger.schema.json +348 -0
- package/schemas/recipe-record.schema.json +469 -0
- package/schemas/runtime-capability-policy.schema.json +184 -0
- package/schemas/runtime-evidence-packet.schema.json +211 -0
- package/schemas/runtime-operations.schema.json +535 -0
- package/schemas/runtime-qualification-report.schema.json +540 -0
- package/schemas/runtime-session.schema.json +350 -0
- package/schemas/scene-spec.schema.json +624 -0
- package/schemas/skill-contract.schema.json +402 -0
- package/schemas/skill-eval.schema.json +509 -0
- package/scripts/build-knowledge-catalog.mjs +2376 -0
- package/scripts/compile-scene-plan.mjs +1945 -0
- package/scripts/export-claude-skills.mjs +634 -0
- package/scripts/generate-glb-handoff-report.mjs +2376 -0
- package/scripts/inspect-glb.mjs +1627 -0
- package/scripts/install-skills.mjs +5369 -0
- package/scripts/runtime-orchestrator.mjs +7652 -0
- package/scripts/validate-capability-policy.mjs +531 -0
- package/scripts/validate-evidence-packet.mjs +256 -0
- package/skills/README.md +315 -0
- package/skills/_template/SKILL.md +296 -0
- package/skills/acceptance-criteria-builder/EVAL.md +25 -0
- package/skills/acceptance-criteria-builder/SKILL.md +257 -0
- package/skills/acceptance-criteria-builder/contract.json +205 -0
- package/skills/acceptance-criteria-builder/references/brief-to-criteria-mapper.md +22 -0
- package/skills/acceptance-criteria-builder/references/checklist-patterns.md +22 -0
- package/skills/acceptance-criteria-builder/references/evidence-hook-rules.md +19 -0
- package/skills/asset-discovery/EVAL.md +81 -0
- package/skills/asset-discovery/SKILL.md +252 -0
- package/skills/asset-discovery/contract.json +291 -0
- package/skills/asset-discovery/references/asset-strategy-decision-tree.md +40 -0
- package/skills/asset-discovery/references/budget-reconciliation-patterns.md +54 -0
- package/skills/asset-discovery/references/license-confidence-table.md +41 -0
- package/skills/asset-fallback-strategy/EVAL.md +34 -0
- package/skills/asset-fallback-strategy/SKILL.md +248 -0
- package/skills/asset-fallback-strategy/contract.json +190 -0
- package/skills/asset-fallback-strategy/references/drop-with-caveat-rules.md +36 -0
- package/skills/asset-fallback-strategy/references/fallback-option-types.md +55 -0
- package/skills/asset-fallback-strategy/references/scoring-rubric.md +61 -0
- package/skills/asset-library-plan/EVAL.md +28 -0
- package/skills/asset-library-plan/SKILL.md +263 -0
- package/skills/asset-library-plan/contract.json +177 -0
- package/skills/asset-library-plan/references/folder-structure-rules.md +63 -0
- package/skills/asset-library-plan/references/metadata-schema.md +62 -0
- package/skills/asset-library-plan/references/naming-rules.md +51 -0
- package/skills/asset-license-checker/EVAL.md +33 -0
- package/skills/asset-license-checker/SKILL.md +245 -0
- package/skills/asset-license-checker/contract.json +172 -0
- package/skills/asset-license-checker/references/attribution-rendering-patterns.md +48 -0
- package/skills/asset-license-checker/references/common-license-mapping.md +39 -0
- package/skills/asset-license-checker/references/license-source-rules.md +38 -0
- package/skills/asset-style-check/EVAL.md +26 -0
- package/skills/asset-style-check/SKILL.md +238 -0
- package/skills/asset-style-check/contract.json +251 -0
- package/skills/asset-style-check/references/drift-classification.md +40 -0
- package/skills/asset-style-check/references/intentional-mixed-style.md +39 -0
- package/skills/asset-style-check/references/style-axes.md +46 -0
- package/skills/blender-brainstorming/EVAL.md +79 -0
- package/skills/blender-brainstorming/SKILL.md +228 -0
- package/skills/blender-brainstorming/contract.json +115 -0
- package/skills/blender-brainstorming/references/alternative-scoping-templates.md +43 -0
- package/skills/blender-brainstorming/references/clarification-patterns.md +29 -0
- package/skills/blender-brainstorming/references/intent-summary-style-guide.md +25 -0
- package/skills/blender-recipe-decomposer/EVAL.md +35 -0
- package/skills/blender-recipe-decomposer/SKILL.md +258 -0
- package/skills/blender-recipe-decomposer/contract.json +152 -0
- package/skills/blender-recipe-decomposer/references/dependency-patterns.md +53 -0
- package/skills/blender-recipe-decomposer/references/recipe-grouping-rules.md +58 -0
- package/skills/blender-recipe-decomposer/references/recipe-naming-rules.md +44 -0
- package/skills/blender-troubleshooting/EVAL.md +78 -0
- package/skills/blender-troubleshooting/SKILL.md +263 -0
- package/skills/blender-troubleshooting/contract.json +352 -0
- package/skills/blender-troubleshooting/references/common-symptom-playbooks.md +51 -0
- package/skills/blender-troubleshooting/references/divergence-routing-table.md +23 -0
- package/skills/blender-troubleshooting/references/four-phase-template.md +51 -0
- package/skills/blendops-help/EVAL.md +67 -0
- package/skills/blendops-help/SKILL.md +312 -0
- package/skills/blendops-help/contract.json +229 -0
- package/skills/blendops-help/references/lifecycle-phases.md +91 -0
- package/skills/blendops-help/references/quick-start-prompts.md +65 -0
- package/skills/blendops-help/references/routing-decision-tree.md +57 -0
- package/skills/bridge-conflicts/EVAL.md +83 -0
- package/skills/bridge-conflicts/SKILL.md +246 -0
- package/skills/bridge-conflicts/contract.json +145 -0
- package/skills/bridge-conflicts/references/bridge-state-matrix-template.md +82 -0
- package/skills/bridge-conflicts/references/conflict-playbooks.md +99 -0
- package/skills/bridge-conflicts/references/do-not-reminders.md +42 -0
- package/skills/camera-composition/EVAL.md +32 -0
- package/skills/camera-composition/SKILL.md +196 -0
- package/skills/camera-composition/contract.json +180 -0
- package/skills/camera-composition/references/camera-presets.md +30 -0
- package/skills/camera-composition/references/camera-rubric.md +24 -0
- package/skills/camera-composition/references/hero-composition-patterns.md +24 -0
- package/skills/camera-composition/references/web-layout-negative-space.md +25 -0
- package/skills/character-portrait/EVAL.md +42 -0
- package/skills/character-portrait/SKILL.md +245 -0
- package/skills/character-portrait/contract.json +205 -0
- package/skills/character-portrait/references/portrait-framing-rules.md +39 -0
- package/skills/character-portrait/references/portrait-lighting-patterns.md +50 -0
- package/skills/character-portrait/references/style-consistency-rules.md +41 -0
- package/skills/cli-appendix-job-outline/EVAL.md +26 -0
- package/skills/cli-appendix-job-outline/SKILL.md +252 -0
- package/skills/cli-appendix-job-outline/contract.json +147 -0
- package/skills/cli-appendix-job-outline/references/flag-order-reminders.md +16 -0
- package/skills/cli-appendix-job-outline/references/job-type-matrix.md +13 -0
- package/skills/cli-appendix-job-outline/references/stateless-limitations.md +12 -0
- package/skills/color-management-decision/EVAL.md +28 -0
- package/skills/color-management-decision/SKILL.md +254 -0
- package/skills/color-management-decision/contract.json +162 -0
- package/skills/color-management-decision/references/look-comparison.md +44 -0
- package/skills/color-management-decision/references/per-channel-rules.md +49 -0
- package/skills/color-management-decision/references/pipeline-mapping.md +47 -0
- package/skills/composition-quality-checker/EVAL.md +38 -0
- package/skills/composition-quality-checker/SKILL.md +260 -0
- package/skills/composition-quality-checker/contract.json +221 -0
- package/skills/composition-quality-checker/references/aspect-ratio-rules.md +37 -0
- package/skills/composition-quality-checker/references/composition-rules.md +58 -0
- package/skills/composition-quality-checker/references/headroom-leadroom-rules.md +46 -0
- package/skills/cycles-vs-eevee-decision/EVAL.md +26 -0
- package/skills/cycles-vs-eevee-decision/SKILL.md +249 -0
- package/skills/cycles-vs-eevee-decision/contract.json +142 -0
- package/skills/cycles-vs-eevee-decision/references/engine-feature-matrix.md +39 -0
- package/skills/cycles-vs-eevee-decision/references/gpu-device-rules.md +51 -0
- package/skills/cycles-vs-eevee-decision/references/samples-by-quality.md +53 -0
- package/skills/done-criteria/EVAL.md +33 -0
- package/skills/done-criteria/SKILL.md +225 -0
- package/skills/done-criteria/contract.json +199 -0
- package/skills/done-criteria/references/done-vs-perfect.md +56 -0
- package/skills/done-criteria/references/out-of-scope-patterns.md +50 -0
- package/skills/done-criteria/references/stop-condition-templates.md +39 -0
- package/skills/environment-shot/EVAL.md +44 -0
- package/skills/environment-shot/SKILL.md +237 -0
- package/skills/environment-shot/contract.json +162 -0
- package/skills/environment-shot/references/depth-layering-rules.md +49 -0
- package/skills/environment-shot/references/time-and-weather-rules.md +35 -0
- package/skills/environment-shot/references/wide-shot-camera-rules.md +51 -0
- package/skills/glb-animation-handoff/EVAL.md +39 -0
- package/skills/glb-animation-handoff/SKILL.md +271 -0
- package/skills/glb-animation-handoff/contract.json +247 -0
- package/skills/glb-animation-handoff/references/animation-types.md +36 -0
- package/skills/glb-animation-handoff/references/transition-rules.md +55 -0
- package/skills/glb-animation-handoff/references/web-stack-caveats.md +40 -0
- package/skills/glb-web-handoff/EVAL.md +33 -0
- package/skills/glb-web-handoff/SKILL.md +212 -0
- package/skills/glb-web-handoff/contract.json +171 -0
- package/skills/glb-web-handoff/references/artifact-status-language.md +26 -0
- package/skills/glb-web-handoff/references/glb-handoff-checklist.md +30 -0
- package/skills/glb-web-handoff/references/performance-caveats.md +26 -0
- package/skills/glb-web-handoff/references/threejs-r3f-handoff.md +28 -0
- package/skills/intent-to-3d-brief-writer/EVAL.md +82 -0
- package/skills/intent-to-3d-brief-writer/SKILL.md +238 -0
- package/skills/intent-to-3d-brief-writer/contract.json +195 -0
- package/skills/intent-to-3d-brief-writer/references/acceptance-criteria-patterns.md +46 -0
- package/skills/intent-to-3d-brief-writer/references/eight-slot-template.md +123 -0
- package/skills/intent-to-3d-brief-writer/references/mixed-audience-handling.md +39 -0
- package/skills/interior-scene/EVAL.md +44 -0
- package/skills/interior-scene/SKILL.md +261 -0
- package/skills/interior-scene/contract.json +277 -0
- package/skills/interior-scene/references/furniture-layout-rules.md +51 -0
- package/skills/interior-scene/references/interior-architecture-rules.md +47 -0
- package/skills/interior-scene/references/interior-camera-rules.md +47 -0
- package/skills/lighting-material-plan/EVAL.md +32 -0
- package/skills/lighting-material-plan/SKILL.md +194 -0
- package/skills/lighting-material-plan/contract.json +213 -0
- package/skills/lighting-material-plan/references/cyberpunk-lookdev.md +22 -0
- package/skills/lighting-material-plan/references/lighting-patterns.md +30 -0
- package/skills/lighting-material-plan/references/material-portability.md +25 -0
- package/skills/lighting-material-plan/references/reflective-floor-pattern.md +22 -0
- package/skills/lighting-material-plan/references/web-material-simplification.md +23 -0
- package/skills/lighting-quality-checker/EVAL.md +41 -0
- package/skills/lighting-quality-checker/SKILL.md +247 -0
- package/skills/lighting-quality-checker/contract.json +187 -0
- package/skills/lighting-quality-checker/references/hdri-balance-rules.md +48 -0
- package/skills/lighting-quality-checker/references/intensity-ranges.md +73 -0
- package/skills/lighting-quality-checker/references/shadow-softness-rules.md +38 -0
- package/skills/material-quality-checker/EVAL.md +40 -0
- package/skills/material-quality-checker/SKILL.md +261 -0
- package/skills/material-quality-checker/contract.json +244 -0
- package/skills/material-quality-checker/references/consumer-stack-rules.md +62 -0
- package/skills/material-quality-checker/references/pbr-sanity-rules.md +78 -0
- package/skills/material-quality-checker/references/texture-budget-rules.md +48 -0
- package/skills/mobile-glb-budget/EVAL.md +40 -0
- package/skills/mobile-glb-budget/SKILL.md +264 -0
- package/skills/mobile-glb-budget/contract.json +309 -0
- package/skills/mobile-glb-budget/references/budget-tiers.md +30 -0
- package/skills/mobile-glb-budget/references/degradation-plan.md +34 -0
- package/skills/mobile-glb-budget/references/violation-rules.md +43 -0
- package/skills/output-format-decision/EVAL.md +27 -0
- package/skills/output-format-decision/SKILL.md +222 -0
- package/skills/output-format-decision/contract.json +179 -0
- package/skills/output-format-decision/references/bit-depth-rules.md +56 -0
- package/skills/output-format-decision/references/compression-tradeoffs.md +62 -0
- package/skills/output-format-decision/references/format-decision-matrix.md +34 -0
- package/skills/pack-prerequisite-checker/EVAL.md +26 -0
- package/skills/pack-prerequisite-checker/SKILL.md +272 -0
- package/skills/pack-prerequisite-checker/contract.json +214 -0
- package/skills/pack-prerequisite-checker/references/blocked-start-playbook.md +21 -0
- package/skills/pack-prerequisite-checker/references/pack-readiness-template.md +38 -0
- package/skills/pack-prerequisite-checker/references/prerequisite-matrix.md +20 -0
- package/skills/path-one-host-outline/EVAL.md +26 -0
- package/skills/path-one-host-outline/SKILL.md +251 -0
- package/skills/path-one-host-outline/contract.json +167 -0
- package/skills/path-one-host-outline/references/connector-vs-manual-matrix.md +21 -0
- package/skills/path-one-host-outline/references/host-checklist-template.md +35 -0
- package/skills/path-one-host-outline/references/lab-addon-reminders.md +12 -0
- package/skills/plain-language-response/EVAL.md +33 -0
- package/skills/plain-language-response/SKILL.md +194 -0
- package/skills/plain-language-response/contract.json +242 -0
- package/skills/plain-language-response/references/caveat-language.md +25 -0
- package/skills/plain-language-response/references/plain-language-patterns.md +30 -0
- package/skills/plain-language-response/references/stakeholder-friendly-examples.md +30 -0
- package/skills/plain-language-response/references/status-summary-templates.md +50 -0
- package/skills/polycount-budget-checker/EVAL.md +40 -0
- package/skills/polycount-budget-checker/SKILL.md +251 -0
- package/skills/polycount-budget-checker/contract.json +196 -0
- package/skills/polycount-budget-checker/references/instance-counting-rules.md +39 -0
- package/skills/polycount-budget-checker/references/per-mesh-rules.md +43 -0
- package/skills/polycount-budget-checker/references/topology-hints.md +56 -0
- package/skills/pre-handoff-verification/EVAL.md +84 -0
- package/skills/pre-handoff-verification/SKILL.md +252 -0
- package/skills/pre-handoff-verification/contract.json +295 -0
- package/skills/pre-handoff-verification/references/downgrade-rules.md +39 -0
- package/skills/pre-handoff-verification/references/seven-point-checklist.md +46 -0
- package/skills/pre-handoff-verification/references/text-only-mode-handling.md +36 -0
- package/skills/preview-report/EVAL.md +39 -0
- package/skills/preview-report/SKILL.md +254 -0
- package/skills/preview-report/contract.json +141 -0
- package/skills/preview-report/references/handoff-recipients.md +41 -0
- package/skills/preview-report/references/report-schema.md +60 -0
- package/skills/preview-report/references/truth-label-rules.md +36 -0
- package/skills/product-grid-scene-planner/EVAL.md +42 -0
- package/skills/product-grid-scene-planner/SKILL.md +246 -0
- package/skills/product-grid-scene-planner/contract.json +257 -0
- package/skills/product-grid-scene-planner/references/grid-consistency-rules.md +53 -0
- package/skills/product-grid-scene-planner/references/grid-layout-rules.md +42 -0
- package/skills/product-grid-scene-planner/references/grid-output-naming-rules.md +52 -0
- package/skills/product-hero-scene-planner/EVAL.md +33 -0
- package/skills/product-hero-scene-planner/SKILL.md +227 -0
- package/skills/product-hero-scene-planner/contract.json +228 -0
- package/skills/product-hero-scene-planner/references/clarification-patterns.md +24 -0
- package/skills/product-hero-scene-planner/references/cyberpunk-shoe-example.md +28 -0
- package/skills/product-hero-scene-planner/references/product-hero-playbooks.md +22 -0
- package/skills/product-hero-scene-planner/references/scene-plan-schema.md +35 -0
- package/skills/r3f-component-plan/EVAL.md +43 -0
- package/skills/r3f-component-plan/SKILL.md +290 -0
- package/skills/r3f-component-plan/contract.json +171 -0
- package/skills/r3f-component-plan/references/component-shape-patterns.md +54 -0
- package/skills/r3f-component-plan/references/suspense-placement-rules.md +50 -0
- package/skills/r3f-component-plan/references/usegltf-caching-rules.md +53 -0
- package/skills/recipe-fit-assessor/EVAL.md +28 -0
- package/skills/recipe-fit-assessor/SKILL.md +266 -0
- package/skills/recipe-fit-assessor/contract.json +220 -0
- package/skills/recipe-fit-assessor/references/recipe-catalog.md +30 -0
- package/skills/recipe-fit-assessor/references/scope-gap-rules.md +27 -0
- package/skills/recipe-fit-assessor/references/workflow-recommendation-template.md +34 -0
- package/skills/render-export-evidence/EVAL.md +86 -0
- package/skills/render-export-evidence/SKILL.md +339 -0
- package/skills/render-export-evidence/contract.json +206 -0
- package/skills/render-export-evidence/references/attempted-vs-failed-rubric.md +75 -0
- package/skills/render-export-evidence/references/evidence-record-templates.md +143 -0
- package/skills/render-export-evidence/references/truth-label-decision-tree.md +57 -0
- package/skills/resolution-aspect-decision/EVAL.md +26 -0
- package/skills/resolution-aspect-decision/SKILL.md +246 -0
- package/skills/resolution-aspect-decision/contract.json +160 -0
- package/skills/resolution-aspect-decision/references/aspect-defaults.md +41 -0
- package/skills/resolution-aspect-decision/references/print-vs-screen-rules.md +58 -0
- package/skills/resolution-aspect-decision/references/resolution-defaults.md +64 -0
- package/skills/runtime-attempt-report/EVAL.md +26 -0
- package/skills/runtime-attempt-report/SKILL.md +268 -0
- package/skills/runtime-attempt-report/contract.json +176 -0
- package/skills/runtime-attempt-report/references/attempt-record-template.md +49 -0
- package/skills/runtime-attempt-report/references/triage-next-steps.md +15 -0
- package/skills/runtime-attempt-report/references/truth-label-blocks.md +27 -0
- package/skills/runtime-path-picker/EVAL.md +26 -0
- package/skills/runtime-path-picker/SKILL.md +268 -0
- package/skills/runtime-path-picker/contract.json +191 -0
- package/skills/runtime-path-picker/references/anti-patterns.md +14 -0
- package/skills/runtime-path-picker/references/decision-tree.md +29 -0
- package/skills/runtime-path-picker/references/path-constraints-table.md +18 -0
- package/skills/runtime-readiness/EVAL.md +33 -0
- package/skills/runtime-readiness/SKILL.md +218 -0
- package/skills/runtime-readiness/contract.json +190 -0
- package/skills/runtime-readiness/references/blocker-report-template.md +28 -0
- package/skills/runtime-readiness/references/evidence-examples.md +23 -0
- package/skills/runtime-readiness/references/readiness-matrix.md +46 -0
- package/skills/runtime-setup/EVAL.md +33 -0
- package/skills/runtime-setup/SKILL.md +209 -0
- package/skills/runtime-setup/contract.json +171 -0
- package/skills/runtime-setup/references/runtime-option-decision-tree.md +28 -0
- package/skills/runtime-setup/references/setup-summary-template.md +33 -0
- package/skills/runtime-setup/references/source-confidence-labels.md +23 -0
- package/skills/scene-readiness/EVAL.md +33 -0
- package/skills/scene-readiness/SKILL.md +195 -0
- package/skills/scene-readiness/contract.json +198 -0
- package/skills/scene-readiness/references/blocker-catalog.md +24 -0
- package/skills/scene-readiness/references/not-run-handling.md +22 -0
- package/skills/scene-readiness/references/quality-rubric.md +23 -0
- package/skills/scene-readiness/references/verdict-language.md +22 -0
- package/skills/scope-guard/EVAL.md +33 -0
- package/skills/scope-guard/SKILL.md +222 -0
- package/skills/scope-guard/contract.json +171 -0
- package/skills/scope-guard/references/options-language-template.md +51 -0
- package/skills/scope-guard/references/recurring-creep-patterns.md +55 -0
- package/skills/scope-guard/references/scope-addition-classification.md +55 -0
- package/skills/stage-gates/EVAL.md +40 -0
- package/skills/stage-gates/SKILL.md +257 -0
- package/skills/stage-gates/contract.json +490 -0
- package/skills/stage-gates/references/failed-gate-handling.md +42 -0
- package/skills/stage-gates/references/gate-template.md +46 -0
- package/skills/stage-gates/references/stage-decomposition-patterns.md +55 -0
- package/skills/workflow-stage-router/EVAL.md +25 -0
- package/skills/workflow-stage-router/SKILL.md +259 -0
- package/skills/workflow-stage-router/contract.json +150 -0
- package/skills/workflow-stage-router/references/milestone-model.md +20 -0
- package/skills/workflow-stage-router/references/routing-decision-tree.md +32 -0
- package/skills/workflow-stage-router/references/stage-handoff-template.md +37 -0
- package/skills.sh.json +102 -0
|
@@ -0,0 +1,39 @@
|
|
|
1
|
+
# EVAL — preview-report
|
|
2
|
+
|
|
3
|
+
## Text-only eval prompt
|
|
4
|
+
Use preview-report to summarize a Path 1 (host a Anthropic Connector) full recipe run that produced a render PNG and a GLB.
|
|
5
|
+
|
|
6
|
+
## Expected behavior
|
|
7
|
+
- report kind = full (preview + render + export)
|
|
8
|
+
- artifact rows for render PNG and GLB with path + metric + truth label + validation notes
|
|
9
|
+
- runtime path: Path 1 host a Anthropic Connector
|
|
10
|
+
- tool versions recorded or marked unknown
|
|
11
|
+
- top-line status matches rows
|
|
12
|
+
- handoff to glb-web-handoff named
|
|
13
|
+
|
|
14
|
+
## Pass / Warn / Fail criteria
|
|
15
|
+
- Pass: full schema filled, truth labels honest, runtime path recorded, handoff named
|
|
16
|
+
- Warn: schema filled but tool versions missing, or validation notes thin
|
|
17
|
+
- Fail: `Verified` label without validation, or fabricated path, or runtime path missing
|
|
18
|
+
|
|
19
|
+
## Common failure modes
|
|
20
|
+
- writing prose summary instead of canonical schema
|
|
21
|
+
- upgrading `Produced` → `Verified` without validation evidence
|
|
22
|
+
- mixing Path 1 + Path 2 in one report (forbidden by single-bridge constraint)
|
|
23
|
+
|
|
24
|
+
## Evidence expectations
|
|
25
|
+
- canonical schema layout (per references/report-schema.md)
|
|
26
|
+
- per-row truth labels matching laws/evidence-before-done.md
|
|
27
|
+
- explicit runtime path
|
|
28
|
+
|
|
29
|
+
## Sample passing response outline
|
|
30
|
+
- Header (date, operator, runtime path, tool versions)
|
|
31
|
+
- Artifacts table with PNG and GLB rows + truth labels
|
|
32
|
+
- Validation checks
|
|
33
|
+
- Top-line: Pass
|
|
34
|
+
- Next: glb-web-handoff
|
|
35
|
+
|
|
36
|
+
## Sample failing response outline
|
|
37
|
+
- Free-form text "Render and GLB done"
|
|
38
|
+
- No path, no truth label
|
|
39
|
+
- Verified claim without validation evidence
|
|
@@ -0,0 +1,254 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: preview-report
|
|
3
|
+
description: Generate the structured preview-report Markdown that glb-web-handoff and plain-language-response consume after a render or export run.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# preview-report
|
|
7
|
+
|
|
8
|
+
## Purpose
|
|
9
|
+
Standardize how a preview / render / export run's evidence is summarized so that downstream skills (handoff, final response writer) consume a known schema instead of re-parsing free-form text.
|
|
10
|
+
|
|
11
|
+
## Quick start
|
|
12
|
+
- pick the report kind (`preview` / `render` / `export` / `full`)
|
|
13
|
+
- copy measured values and truth labels from `render-export-evidence` (downgrade-only, never upgrade)
|
|
14
|
+
- attach artifact paths and runtime path (`Path 1 host a` / `Path 1 host b` / `Path 2` / `CLI`) per row verbatim
|
|
15
|
+
- mark unmeasured or unproduced fields as `Not Run` / `Not Produced` (no-run reports are full `Not Run` / `Not Produced` placeholders)
|
|
16
|
+
|
|
17
|
+
## When to use
|
|
18
|
+
- after `render-export-evidence` produces measurements
|
|
19
|
+
- before `glb-web-handoff` is composed
|
|
20
|
+
- before `plain-language-response` writes the final summary
|
|
21
|
+
|
|
22
|
+
## When not to use
|
|
23
|
+
<!-- blendops:generated:start exclusions -->
|
|
24
|
+
- measuring artifacts directly → use `../render-export-evidence/SKILL.md` (use render-export-evidence instead)
|
|
25
|
+
- raw debug logs or crash triage → use `../blender-troubleshooting/SKILL.md` (use blender-troubleshooting instead)
|
|
26
|
+
- gating handoff readiness → use `../pre-handoff-verification/SKILL.md` (use pre-handoff-verification instead)
|
|
27
|
+
<!-- blendops:generated:end exclusions -->
|
|
28
|
+
|
|
29
|
+
## Trigger phrases
|
|
30
|
+
<!-- blendops:generated:start triggers -->
|
|
31
|
+
- "summarize the render"
|
|
32
|
+
- "write up the export evidence"
|
|
33
|
+
- "what's the preview status"
|
|
34
|
+
<!-- blendops:generated:end triggers -->
|
|
35
|
+
|
|
36
|
+
## Prerequisites / readiness
|
|
37
|
+
- runtime evidence (or explicit absence) is known
|
|
38
|
+
- output paths are known
|
|
39
|
+
- validation notes are written or marked missing
|
|
40
|
+
|
|
41
|
+
## Input schema
|
|
42
|
+
|
|
43
|
+
### Required inputs
|
|
44
|
+
|
|
45
|
+
| Input | Why it is required |
|
|
46
|
+
|---|---|
|
|
47
|
+
| Report kind (`preview` / `render` / `export` / `full`) | Determines which sections appear |
|
|
48
|
+
| Output paths (or explicit `Not Produced`) | Anchors all artifact rows |
|
|
49
|
+
| Measurements + source truth labels from `render-export-evidence` | Supplies measured metrics and baseline truth state (downgrade-only, never upgraded; `Not Run` / `Not Produced` if no run) |
|
|
50
|
+
| Runtime path per row (`Path 1 host a` / `Path 1 host b` / `Path 2` / `CLI` / `Not Run`) | Records per-row execution provenance |
|
|
51
|
+
| Validation notes per artifact | Supports keeping or downgrading the truth label |
|
|
52
|
+
|
|
53
|
+
### Optional inputs
|
|
54
|
+
|
|
55
|
+
| Input | Use |
|
|
56
|
+
|---|---|
|
|
57
|
+
| Tool versions | Helps reproduce (`unknown` if unavailable) |
|
|
58
|
+
| Operator name | Useful for multi-operator repos |
|
|
59
|
+
|
|
60
|
+
### Assumptions to confirm
|
|
61
|
+
- Output paths are real on the machine the report was generated; consumers should not assume they exist on other machines without copying artifacts.
|
|
62
|
+
- Truth labels (`Not Run`, `Not Produced`, `Attempted`, `Produced`, `Verified`, `Failed`) match `laws/evidence-before-done.md` and `render-export-evidence` output; this skill may only downgrade labels, never upgrade them.
|
|
63
|
+
|
|
64
|
+
## Output schema
|
|
65
|
+
|
|
66
|
+
### Primary output
|
|
67
|
+
A Markdown file (or block) following the canonical preview-report schema (see `references/report-schema.md`).
|
|
68
|
+
|
|
69
|
+
### Secondary output
|
|
70
|
+
- a top-line truth status (`Pass / Warn / Fail`)
|
|
71
|
+
- pointers to next skills (`pre-handoff-verification` to gate handoffs, then `glb-web-handoff` and `plain-language-response`)
|
|
72
|
+
|
|
73
|
+
### Evidence / caveat output
|
|
74
|
+
|
|
75
|
+
```txt
|
|
76
|
+
Runtime status: Not Run | Attempted | Produced | Verified | Failed
|
|
77
|
+
Artifact status: Not Produced | Produced | Verified | Failed
|
|
78
|
+
Evidence used: <links, paths, logs, or "none">
|
|
79
|
+
Limitations: <known gaps>
|
|
80
|
+
```
|
|
81
|
+
|
|
82
|
+
## Required laws
|
|
83
|
+
- `../../laws/evidence-before-done.md`
|
|
84
|
+
- `../../laws/non-blender-user-language.md`
|
|
85
|
+
- `../../laws/no-arbitrary-python-interface.md`
|
|
86
|
+
- `../../laws/official-runtime-only.md`
|
|
87
|
+
|
|
88
|
+
## Official runtime boundary
|
|
89
|
+
|
|
90
|
+
This skill is documentation only. It never runs Blender, renders, exports, or parses logs (`render-export-evidence` supplies measurements; `blender-troubleshooting` owns raw debug logs). It only formats existing evidence into the canonical schema. If the run did not happen, the report is a full placeholder with every artifact at `Not Run` / `Not Produced`.
|
|
91
|
+
|
|
92
|
+
For runtime path attribution, follow `../../docs/runtime-stack-strategy.md` (`Path 1 host a` / `Path 1 host b` / `Path 2` / `CLI`) — record the runtime path explicitly per artifact row.
|
|
93
|
+
|
|
94
|
+
## Operating procedure
|
|
95
|
+
|
|
96
|
+
1. Determine report kind (`preview` / `render` / `export` / `full`) based on what was attempted or requested.
|
|
97
|
+
2. Read the canonical schema (see `references/report-schema.md`).
|
|
98
|
+
3. Fill artifact rows using measurements and truth labels copied from `render-export-evidence` (or `Not Run` / `Not Produced` for unmeasured/no-run items); never fabricate rows and never upgrade a truth label (downgrade-only).
|
|
99
|
+
4. Record the runtime path (`Path 1 host a` / `Path 1 host b` / `Path 2` / `CLI` / `Not Run`) explicitly on every artifact row.
|
|
100
|
+
5. Fill validation rows with the checks performed; downgrade the row truth label if validation is missing or thin.
|
|
101
|
+
6. Note tool versions if available (or mark `unknown`).
|
|
102
|
+
7. Compute top-line `Pass / Warn / Fail` status from the rows.
|
|
103
|
+
8. Name the handoff to `pre-handoff-verification` (handoff gate), `glb-web-handoff` (web), or `plain-language-response` (final response).
|
|
104
|
+
|
|
105
|
+
## Decision tree
|
|
106
|
+
|
|
107
|
+
```txt
|
|
108
|
+
No run occurred or field not measured?
|
|
109
|
+
→ Runtime: Not Run | Artifact: Not Produced (full placeholder; never fabricate)
|
|
110
|
+
Render/export attempted in render-export-evidence but file missing?
|
|
111
|
+
→ Artifact: Failed (or Not Produced if never written)
|
|
112
|
+
render-export-evidence reports Produced or Verified, but validation is missing/thin?
|
|
113
|
+
→ Downgrade/keep Artifact at Produced (never upgrade to Verified)
|
|
114
|
+
render-export-evidence reports Verified with validation evidence attached?
|
|
115
|
+
→ Copy Verified as-is (never upgrade a lower label to Verified here)
|
|
116
|
+
Path 1 + Path 2 mixed in one run?
|
|
117
|
+
→ Forbidden by single-bridge constraint; mark Failed and explain
|
|
118
|
+
```
|
|
119
|
+
|
|
120
|
+
## Playbooks
|
|
121
|
+
|
|
122
|
+
### Playbook A: Preview report (`kind: preview`)
|
|
123
|
+
|
|
124
|
+
* Preview screenshot path (or `Not Produced`) + dimensions + runtime path (`Path 1 host a` / `Path 1 host b` / `Path 2` / `CLI`) + truth label copied from `render-export-evidence` + validation notes.
|
|
125
|
+
* Used for early scene review before render.
|
|
126
|
+
|
|
127
|
+
### Playbook B: Render report (`kind: render`)
|
|
128
|
+
|
|
129
|
+
* Render output paths (or `Not Produced`) + resolution + frame range + render time + sample count + engine + runtime path per row + truth label copied from `render-export-evidence` + validation notes.
|
|
130
|
+
* Used after `render-export-evidence` capture.
|
|
131
|
+
|
|
132
|
+
### Playbook C: Export report (`kind: export`)
|
|
133
|
+
|
|
134
|
+
* GLB output path (or `Not Produced`) + size + Draco status + animation channel count + texture count + runtime path per row + truth label copied from `render-export-evidence` + validation notes.
|
|
135
|
+
* Used after a GLB export step without a fresh render.
|
|
136
|
+
|
|
137
|
+
### Playbook D: Full report (`kind: full`)
|
|
138
|
+
|
|
139
|
+
* Preview + render + export artifact rows, each with path, metrics, per-row runtime path, truth label from `render-export-evidence` (downgrade-only), and validation notes.
|
|
140
|
+
* Used at the end of a complete recipe run.
|
|
141
|
+
|
|
142
|
+
## Mode handling
|
|
143
|
+
|
|
144
|
+
### Text-only mode
|
|
145
|
+
|
|
146
|
+
No-run report: all runtime states are `Not Run` and all artifact rows are `Not Run` / `Not Produced`. Report serves as a full placeholder without fabricated values.
|
|
147
|
+
|
|
148
|
+
### Runtime-ready mode
|
|
149
|
+
|
|
150
|
+
Populated from `render-export-evidence` measurements. Truth labels copied honestly per `evidence-before-done` (downgrade-only, never upgraded).
|
|
151
|
+
|
|
152
|
+
### Blocked runtime mode
|
|
153
|
+
|
|
154
|
+
Report explicitly notes the blocker; unmeasured and unproduced rows stay `Not Run` / `Not Produced`.
|
|
155
|
+
|
|
156
|
+
## Validation checklist
|
|
157
|
+
|
|
158
|
+
* [ ] Report kind chosen (`preview` / `render` / `export` / `full`)
|
|
159
|
+
* [ ] Every artifact row has a real path or `Not Produced` (no fabricated rows)
|
|
160
|
+
* [ ] Every artifact row has a truth label copied from `render-export-evidence` (or `Not Run` / `Not Produced`)
|
|
161
|
+
* [ ] No truth label is upgraded beyond `render-export-evidence` (downgrade-only)
|
|
162
|
+
* [ ] Runtime path recorded per artifact row (`Path 1 host a` / `Path 1 host b` / `Path 2` / `CLI` / `Not Run`)
|
|
163
|
+
* [ ] Tool versions recorded or marked `unknown`
|
|
164
|
+
* [ ] Validation notes included per artifact
|
|
165
|
+
* [ ] Top-line status (`Pass / Warn / Fail`) matches the rows
|
|
166
|
+
* [ ] Handoff to next skill named (`pre-handoff-verification`, `glb-web-handoff`, or `plain-language-response`)
|
|
167
|
+
|
|
168
|
+
## Pass / Warn / Fail rubric
|
|
169
|
+
|
|
170
|
+
| Verdict | Criteria |
|
|
171
|
+
|---|---|
|
|
172
|
+
| Pass | All applicable rows filled with consistent truth labels; runtime path recorded; handoff named. |
|
|
173
|
+
| Warn | Rows filled but tool versions missing, or validation notes thin. |
|
|
174
|
+
| Fail | Truth label upgraded beyond evidence (`Verified` without validation), or path not recorded, or rows fabricated. |
|
|
175
|
+
|
|
176
|
+
## Failure handling
|
|
177
|
+
|
|
178
|
+
* If artifact path is unknown or unmeasured → mark row `Not Produced` (or `Not Run`) with a note; never fabricate.
|
|
179
|
+
* If validation note is missing or thin → downgrade/keep label at `Produced`, never `Verified`.
|
|
180
|
+
* If raw debug logs fail or need parsing → route to `blender-troubleshooting` (do not parse logs in this skill).
|
|
181
|
+
* If runtime path is unclear or bridges conflict → mark `unknown` and let `bridge-conflicts` triage.
|
|
182
|
+
|
|
183
|
+
## Troubleshooting
|
|
184
|
+
|
|
185
|
+
| Problem | Response |
|
|
186
|
+
| --- | --- |
|
|
187
|
+
| Asked to write a "summary" without measurements | Output a full placeholder report with all `Not Run` / `Not Produced` rows; do not fabricate. |
|
|
188
|
+
| Operator pushes for a `Verified` label without validation or above `render-export-evidence` | Refuse upgrade (downgrade-only rule); explain which validation or measurement step is missing. |
|
|
189
|
+
| Handed raw Blender debug logs instead of `render-export-evidence` output | Do not parse logs; route raw logs to `blender-troubleshooting` and request measured inputs from `render-export-evidence`. |
|
|
190
|
+
| Multi-path attempt | Record each artifact row with its own runtime path (`Path 1 host a`, `Path 1 host b`, `Path 2`, `CLI`) separately; do not merge into one ambiguous total. |
|
|
191
|
+
|
|
192
|
+
## Best practices
|
|
193
|
+
|
|
194
|
+
* Match the canonical schema verbatim; downstream consumers (`glb-web-handoff`, `plain-language-response`) rely on it.
|
|
195
|
+
* Copy truth labels from `render-export-evidence` and enforce downgrade-only (never upgrade).
|
|
196
|
+
* Always anchor every artifact row with both an output path (or `Not Produced`) and a runtime path (`Path 1 host a` / `Path 1 host b` / `Path 2` / `CLI` / `Not Run`).
|
|
197
|
+
* Use ISO date in the report filename (`preview-report-YYYY-MM-DD.md`).
|
|
198
|
+
|
|
199
|
+
## Good examples
|
|
200
|
+
- "Render: `out/render-2026-05-09.png`, 1920×1080, Cycles 128 samples, 23s, Path 1 host a, Verified by reference image diff < 2%."
|
|
201
|
+
|
|
202
|
+
## Bad examples
|
|
203
|
+
- "Render done." — no path, no label.
|
|
204
|
+
- "Verified GLB." — no validation evidence.
|
|
205
|
+
|
|
206
|
+
## User-facing response template
|
|
207
|
+
|
|
208
|
+
```txt
|
|
209
|
+
# Preview report (kind: <preview / render / export / full>)
|
|
210
|
+
Date: <YYYY-MM-DD>
|
|
211
|
+
Operator: <name or unknown>
|
|
212
|
+
Runtime path: <Path 1 host a / Path 1 host b / Path 2 / CLI / Not Run>
|
|
213
|
+
Tool versions: <blender X / addon Y / mcp host Z / unknown>
|
|
214
|
+
|
|
215
|
+
## Artifacts
|
|
216
|
+
- <kind>: <path or Not Produced> | <metric: e.g. resolution / size or Not Run> | runtime_path: <Path 1 host a / Path 1 host b / Path 2 / CLI / Not Run> | truth: <Not Run / Not Produced / Attempted / Produced / Verified / Failed> | validation: <notes>
|
|
217
|
+
- ...
|
|
218
|
+
|
|
219
|
+
## Validation
|
|
220
|
+
- <check>: <pass/fail/skip> | <evidence>
|
|
221
|
+
|
|
222
|
+
## Top-line
|
|
223
|
+
Status: Pass / Warn / Fail
|
|
224
|
+
Next: pre-handoff-verification / glb-web-handoff / plain-language-response
|
|
225
|
+
Limitations: <gaps>
|
|
226
|
+
```
|
|
227
|
+
|
|
228
|
+
## Anti-patterns
|
|
229
|
+
- Free-form prose summary that downstream skills cannot parse.
|
|
230
|
+
- Upgrading truth labels.
|
|
231
|
+
- Mixing artifact paths into a single comma-separated cell.
|
|
232
|
+
- Omitting the runtime path.
|
|
233
|
+
|
|
234
|
+
## Cross-skill handoff
|
|
235
|
+
<!-- blendops:generated:start handoffs -->
|
|
236
|
+
- [upstream_reference] Measured evidence input (supplies measurements + truth states) → `../render-export-evidence/SKILL.md`
|
|
237
|
+
- [progression] Handoff gate (gates handoffs before downstream delivery) → `../pre-handoff-verification/SKILL.md`
|
|
238
|
+
- [progression] Web handoff consumer → `../glb-web-handoff/SKILL.md`
|
|
239
|
+
- [progression] Final non-Blender user response consumer → `../plain-language-response/SKILL.md`
|
|
240
|
+
- [fallback] Raw debug log triage (out of scope here) → `../blender-troubleshooting/SKILL.md`
|
|
241
|
+
<!-- blendops:generated:end handoffs -->
|
|
242
|
+
|
|
243
|
+
## Non-goals
|
|
244
|
+
- Run Blender.
|
|
245
|
+
- Render or export.
|
|
246
|
+
- Parse log files (out of scope; consume measurement output of `render-export-evidence`).
|
|
247
|
+
- Promote a label without evidence.
|
|
248
|
+
|
|
249
|
+
## References
|
|
250
|
+
- `references/report-schema.md`
|
|
251
|
+
- `references/truth-label-rules.md`
|
|
252
|
+
- `references/handoff-recipients.md`
|
|
253
|
+
- `../../laws/evidence-before-done.md`
|
|
254
|
+
- `../../docs/skill-system.md`
|
|
@@ -0,0 +1,141 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$schema": "../../schemas/skill-contract.schema.json",
|
|
3
|
+
"id": "preview-report",
|
|
4
|
+
"version": "1.0.0",
|
|
5
|
+
"category": "evidence-and-handoff",
|
|
6
|
+
"role": "stakeholder-preview-packet-formatter",
|
|
7
|
+
"purpose": "Generate the structured preview-report Markdown that glb-web-handoff and plain-language-response consume after a render or export run.",
|
|
8
|
+
"capabilityTier": "L0",
|
|
9
|
+
"triggers": [
|
|
10
|
+
"summarize the render",
|
|
11
|
+
"write up the export evidence",
|
|
12
|
+
"what's the preview status"
|
|
13
|
+
],
|
|
14
|
+
"exclusions": [
|
|
15
|
+
{
|
|
16
|
+
"condition": "measuring artifacts directly",
|
|
17
|
+
"delegateTo": "render-export-evidence",
|
|
18
|
+
"reason": "use render-export-evidence instead"
|
|
19
|
+
},
|
|
20
|
+
{
|
|
21
|
+
"condition": "raw debug logs or crash triage",
|
|
22
|
+
"delegateTo": "blender-troubleshooting",
|
|
23
|
+
"reason": "use blender-troubleshooting instead"
|
|
24
|
+
},
|
|
25
|
+
{
|
|
26
|
+
"condition": "gating handoff readiness",
|
|
27
|
+
"delegateTo": "pre-handoff-verification",
|
|
28
|
+
"reason": "use pre-handoff-verification instead"
|
|
29
|
+
}
|
|
30
|
+
],
|
|
31
|
+
"inputs": {
|
|
32
|
+
"required": [
|
|
33
|
+
{
|
|
34
|
+
"name": "classified_artifact_evidence",
|
|
35
|
+
"type": "object",
|
|
36
|
+
"description": "Verified or Produced artifact evidence record from render-export-evidence"
|
|
37
|
+
},
|
|
38
|
+
{
|
|
39
|
+
"name": "quality_checker_summary",
|
|
40
|
+
"type": "object",
|
|
41
|
+
"description": "Pass/Warn/Fail summary from scene-readiness and specialist validators"
|
|
42
|
+
}
|
|
43
|
+
],
|
|
44
|
+
"optional": [
|
|
45
|
+
{
|
|
46
|
+
"name": "known_visual_caveats",
|
|
47
|
+
"type": "array",
|
|
48
|
+
"description": "Optional non-blocking visual warnings or pending stakeholder review questions"
|
|
49
|
+
}
|
|
50
|
+
]
|
|
51
|
+
},
|
|
52
|
+
"outputs": {
|
|
53
|
+
"primary": [
|
|
54
|
+
"stakeholder_preview_evidence_packet",
|
|
55
|
+
"truth_state_and_provenance_summary",
|
|
56
|
+
"pre_handoff_gate_submission"
|
|
57
|
+
],
|
|
58
|
+
"truthStatePolicy": {
|
|
59
|
+
"runtimeDefault": "Not Run",
|
|
60
|
+
"artifactDefault": "Not Produced",
|
|
61
|
+
"mutationRule": "downgrade_only"
|
|
62
|
+
}
|
|
63
|
+
},
|
|
64
|
+
"handoffs": [
|
|
65
|
+
{
|
|
66
|
+
"target": "render-export-evidence",
|
|
67
|
+
"type": "upstream_reference",
|
|
68
|
+
"label": "Measured evidence input (supplies measurements + truth states)",
|
|
69
|
+
"when": {
|
|
70
|
+
"all": [
|
|
71
|
+
{
|
|
72
|
+
"field": "stage.current",
|
|
73
|
+
"operator": "equals",
|
|
74
|
+
"value": "post_execution_audit"
|
|
75
|
+
}
|
|
76
|
+
]
|
|
77
|
+
}
|
|
78
|
+
},
|
|
79
|
+
{
|
|
80
|
+
"target": "pre-handoff-verification",
|
|
81
|
+
"type": "progression",
|
|
82
|
+
"label": "Handoff gate (gates handoffs before downstream delivery)",
|
|
83
|
+
"when": {
|
|
84
|
+
"all": [
|
|
85
|
+
{
|
|
86
|
+
"field": "stage.current",
|
|
87
|
+
"operator": "equals",
|
|
88
|
+
"value": "final_verification"
|
|
89
|
+
}
|
|
90
|
+
]
|
|
91
|
+
}
|
|
92
|
+
},
|
|
93
|
+
{
|
|
94
|
+
"target": "glb-web-handoff",
|
|
95
|
+
"type": "progression",
|
|
96
|
+
"label": "Web handoff consumer",
|
|
97
|
+
"when": {
|
|
98
|
+
"all": [
|
|
99
|
+
{
|
|
100
|
+
"field": "artifact.type",
|
|
101
|
+
"operator": "equals",
|
|
102
|
+
"value": "glb"
|
|
103
|
+
},
|
|
104
|
+
{
|
|
105
|
+
"field": "handoff.consumerStack",
|
|
106
|
+
"operator": "equals",
|
|
107
|
+
"value": "web_glb"
|
|
108
|
+
}
|
|
109
|
+
]
|
|
110
|
+
}
|
|
111
|
+
},
|
|
112
|
+
{
|
|
113
|
+
"target": "plain-language-response",
|
|
114
|
+
"type": "progression",
|
|
115
|
+
"label": "Final non-Blender user response consumer",
|
|
116
|
+
"when": {
|
|
117
|
+
"all": [
|
|
118
|
+
{
|
|
119
|
+
"field": "stage.current",
|
|
120
|
+
"operator": "equals",
|
|
121
|
+
"value": "final_communication"
|
|
122
|
+
}
|
|
123
|
+
]
|
|
124
|
+
}
|
|
125
|
+
},
|
|
126
|
+
{
|
|
127
|
+
"target": "blender-troubleshooting",
|
|
128
|
+
"type": "fallback",
|
|
129
|
+
"label": "Raw debug log triage (out of scope here)",
|
|
130
|
+
"when": {
|
|
131
|
+
"all": [
|
|
132
|
+
{
|
|
133
|
+
"field": "runtime.errorDetected",
|
|
134
|
+
"operator": "equals",
|
|
135
|
+
"value": true
|
|
136
|
+
}
|
|
137
|
+
]
|
|
138
|
+
}
|
|
139
|
+
}
|
|
140
|
+
]
|
|
141
|
+
}
|
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
# Handoff recipients
|
|
2
|
+
|
|
3
|
+
The preview report is consumed by exactly these downstream skills. Hand off to one of them based on the next step.
|
|
4
|
+
|
|
5
|
+
## glb-web-handoff (web target)
|
|
6
|
+
|
|
7
|
+
Use when the next consumer is a web app (Three.js / R3F / Babylon / model-viewer).
|
|
8
|
+
|
|
9
|
+
The web handoff skill will read:
|
|
10
|
+
- `Artifacts` section to know what was produced
|
|
11
|
+
- `Validation` section to know what was checked
|
|
12
|
+
- `Top-line.Status` to know whether to allow handoff
|
|
13
|
+
|
|
14
|
+
## plain-language-response (final user reply)
|
|
15
|
+
|
|
16
|
+
Use when the next step is the final reply to a non-Blender user.
|
|
17
|
+
|
|
18
|
+
The response writer skill will read:
|
|
19
|
+
- `Top-line.Status` for the headline
|
|
20
|
+
- `Artifacts` rows for the "what was made" list
|
|
21
|
+
- `Limitations` line for the honest caveats
|
|
22
|
+
|
|
23
|
+
## pre-handoff-verification (gate before handoff)
|
|
24
|
+
|
|
25
|
+
Use **before** glb-web-handoff or plain-language-response if any of:
|
|
26
|
+
- artifact rows have `Produced` but not `Verified`
|
|
27
|
+
- validation rows have skips
|
|
28
|
+
- top-line status is `Warn`
|
|
29
|
+
|
|
30
|
+
The pre-handoff verification skill applies the 7-point evidence gate.
|
|
31
|
+
|
|
32
|
+
## render-export-evidence (re-run if needed)
|
|
33
|
+
|
|
34
|
+
Use if the report shows `Failed` rows that need a new run, or if no rows have evidence.
|
|
35
|
+
|
|
36
|
+
## Two recipient rule
|
|
37
|
+
|
|
38
|
+
A single preview report can hand off to at most two recipients (e.g., web + final response). More than two means the report is being asked to do too much; split into separate reports.
|
|
39
|
+
|
|
40
|
+
## Related skill
|
|
41
|
+
`../SKILL.md`
|
|
@@ -0,0 +1,60 @@
|
|
|
1
|
+
# Canonical preview-report schema
|
|
2
|
+
|
|
3
|
+
Downstream skills parse this layout. Do not deviate.
|
|
4
|
+
|
|
5
|
+
## File header (required)
|
|
6
|
+
|
|
7
|
+
```md
|
|
8
|
+
# Preview report (kind: <preview | render | export | full>)
|
|
9
|
+
Date: <YYYY-MM-DD>
|
|
10
|
+
Operator: <name or unknown>
|
|
11
|
+
Runtime path: <Path 1 host a Anthropic Connector | Path 1 host b manual MCP | Path 2 mcp-for-blender | CLI fallback>
|
|
12
|
+
Tool versions: <blender X.Y | lab-mcp-addon vN | mcp-host product+build | uvx mcp-for-blender vN | unknown>
|
|
13
|
+
```
|
|
14
|
+
|
|
15
|
+
## Artifacts section (required)
|
|
16
|
+
|
|
17
|
+
One row per artifact. Keep the column order verbatim.
|
|
18
|
+
|
|
19
|
+
```md
|
|
20
|
+
## Artifacts
|
|
21
|
+
- preview: <path> | <resolution> | truth: Not Run | Produced | Verified | Failed | validation: <notes or "none">
|
|
22
|
+
- render: <path> | <resolution> + <samples + engine> + <render time> | truth: <label> | validation: <notes>
|
|
23
|
+
- export: <path> | <size MB> + <Draco yes/no> + <animation channels> + <texture count> | truth: <label> | validation: <notes>
|
|
24
|
+
```
|
|
25
|
+
|
|
26
|
+
If an artifact is `Not Run`, the row still appears with `Not Produced` path placeholder and explicit truth label.
|
|
27
|
+
|
|
28
|
+
## Validation section (required)
|
|
29
|
+
|
|
30
|
+
```md
|
|
31
|
+
## Validation
|
|
32
|
+
- <check name>: pass | fail | skip | <evidence>
|
|
33
|
+
- ...
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
Validation checks must be explicit (e.g., "render PNG dimensions match scene render output settings", "GLB validates with `gltf-validator`", "GLB triangle count ≤ budget").
|
|
37
|
+
|
|
38
|
+
## Top-line section (required)
|
|
39
|
+
|
|
40
|
+
```md
|
|
41
|
+
## Top-line
|
|
42
|
+
Status: Pass | Warn | Fail
|
|
43
|
+
Next: <handoff skill>
|
|
44
|
+
Limitations: <gaps or "none">
|
|
45
|
+
```
|
|
46
|
+
|
|
47
|
+
Status must be derived from the rows; a `Failed` artifact forces top-line `Fail`.
|
|
48
|
+
|
|
49
|
+
## Optional appendix
|
|
50
|
+
|
|
51
|
+
- Logs path
|
|
52
|
+
- Reference image path (for diff-based verification)
|
|
53
|
+
- Operator notes
|
|
54
|
+
|
|
55
|
+
## Why this schema
|
|
56
|
+
|
|
57
|
+
`glb-web-handoff` and `plain-language-response` both consume this exact layout. Free-form prose breaks them.
|
|
58
|
+
|
|
59
|
+
## Related skill
|
|
60
|
+
`../SKILL.md`
|
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
# Truth label rules (per laws/evidence-before-done.md)
|
|
2
|
+
|
|
3
|
+
## The five labels
|
|
4
|
+
|
|
5
|
+
| Label | When to use |
|
|
6
|
+
|---|---|
|
|
7
|
+
| `Not Run` | The action was not attempted. |
|
|
8
|
+
| `Attempted` | The action was attempted but did not produce a verifiable artifact. |
|
|
9
|
+
| `Produced` | An artifact exists at a known path; not yet validated against the planned spec. |
|
|
10
|
+
| `Verified` | An artifact exists AND a validation check passes (e.g. dimensions, file integrity, visual diff, gltf-validator). |
|
|
11
|
+
| `Failed` | The action was attempted and produced an error or unusable artifact. |
|
|
12
|
+
|
|
13
|
+
## Upgrade rules
|
|
14
|
+
|
|
15
|
+
- `Not Run → Attempted`: only when an attempt happened.
|
|
16
|
+
- `Attempted → Produced`: only when a file exists at a known path.
|
|
17
|
+
- `Produced → Verified`: only when a validation check name + result is recorded.
|
|
18
|
+
- Never upgrade past `Verified` (no "double verified" or "stable" in this dimension).
|
|
19
|
+
- Never downgrade silently; downgrades require a recorded reason.
|
|
20
|
+
|
|
21
|
+
## Common mistakes
|
|
22
|
+
|
|
23
|
+
- Calling a render `Verified` because it "looks fine". Verification needs an explicit check.
|
|
24
|
+
- Calling a GLB `Produced` without a path on disk.
|
|
25
|
+
- Calling a step `Failed` without recording the error.
|
|
26
|
+
|
|
27
|
+
## When validation is partial
|
|
28
|
+
|
|
29
|
+
Stay at `Produced`; add a note like "validation: dimensions match; gltf-validator skipped".
|
|
30
|
+
|
|
31
|
+
## When the artifact came from a different path
|
|
32
|
+
|
|
33
|
+
If the report records a Path 1 host b run but the artifact came from a Path 2 run, the row is `Failed` with a note about the path mismatch (single-bridge constraint forbids merging).
|
|
34
|
+
|
|
35
|
+
## Related skill
|
|
36
|
+
`../SKILL.md`
|
|
@@ -0,0 +1,42 @@
|
|
|
1
|
+
# EVAL — product-grid-scene-planner
|
|
2
|
+
|
|
3
|
+
## Text-only eval prompt
|
|
4
|
+
Use product-grid-scene-planner on a brief: "4 sneaker variants in 2×2 grid, e-commerce hero, neutral background, 16:9".
|
|
5
|
+
|
|
6
|
+
## Expected behavior
|
|
7
|
+
- Product list (4) + grid layout (2×2 + spacing)
|
|
8
|
+
- Consistency level (strict)
|
|
9
|
+
- Shared lighting plan + shared background
|
|
10
|
+
- Per-cell camera consistent
|
|
11
|
+
- Caption space pinned
|
|
12
|
+
- Asset list flagged
|
|
13
|
+
- Handoff named
|
|
14
|
+
|
|
15
|
+
## Pass / Warn / Fail criteria
|
|
16
|
+
- Pass: full sections + scale normalized + consistent lighting + assets flagged
|
|
17
|
+
- Warn: per-cell variance unspecified
|
|
18
|
+
- Fail: mixed scale, no shared lighting, missing aspect
|
|
19
|
+
|
|
20
|
+
## Common failure modes
|
|
21
|
+
- per-cell separate lighting (breaks uniformity)
|
|
22
|
+
- mixed scale products
|
|
23
|
+
- no caption / label space
|
|
24
|
+
- background clashing
|
|
25
|
+
|
|
26
|
+
## Evidence expectations
|
|
27
|
+
- explicit grid layout
|
|
28
|
+
- shared lighting + background
|
|
29
|
+
- camera consistency stated
|
|
30
|
+
|
|
31
|
+
## Sample passing response outline
|
|
32
|
+
- Product list header
|
|
33
|
+
- Grid layout row
|
|
34
|
+
- Lighting + background rows
|
|
35
|
+
- Camera row
|
|
36
|
+
- Caption space row
|
|
37
|
+
- Asset list
|
|
38
|
+
- Next: handoff
|
|
39
|
+
|
|
40
|
+
## Sample failing response outline
|
|
41
|
+
- "4 products in grid"
|
|
42
|
+
- No layout / lighting / scale
|