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,252 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: cli-appendix-job-outline
|
|
3
|
+
description: Plan headless blender --background export or render jobs when MCP chat control is a poor fit; cite upstream Blender CLI docs only.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# cli-appendix-job-outline
|
|
7
|
+
|
|
8
|
+
## Purpose
|
|
9
|
+
|
|
10
|
+
Structure **CLI fallback appendix** jobs (batch render, batch export, scripted scene setup) using Blender's documented command-line interface — without presenting arbitrary Python as the user-facing product surface.
|
|
11
|
+
|
|
12
|
+
## Quick start
|
|
13
|
+
|
|
14
|
+
- classify job type via `references/job-type-matrix.md`
|
|
15
|
+
- capture ordering cautions `references/flag-order-reminders.md`
|
|
16
|
+
- state limitations `references/stateless-limitations.md`
|
|
17
|
+
- point user to upstream CLI manual for exact flags
|
|
18
|
+
|
|
19
|
+
## When to use
|
|
20
|
+
|
|
21
|
+
- CI / render farm / repeatable exports
|
|
22
|
+
- MCP unavailable or disallowed by policy
|
|
23
|
+
- deterministic batch operations vs exploratory modeling
|
|
24
|
+
|
|
25
|
+
## When not to use
|
|
26
|
+
<!-- blendops:generated:start exclusions -->
|
|
27
|
+
- interactive viewport iteration primary goal → use `../runtime-path-picker/SKILL.md` (Delegates out-of-scope requests to runtime-path-picker)
|
|
28
|
+
- user expects Connector chat loop → use `../path-one-host-outline/SKILL.md` (Delegates out-of-scope requests to path-one-host-outline)
|
|
29
|
+
<!-- blendops:generated:end exclusions -->
|
|
30
|
+
|
|
31
|
+
## Trigger phrases
|
|
32
|
+
<!-- blendops:generated:start triggers -->
|
|
33
|
+
- "headless blender"
|
|
34
|
+
- "batch render CLI"
|
|
35
|
+
- "blender --background"
|
|
36
|
+
- "render farm outline"
|
|
37
|
+
<!-- blendops:generated:end triggers -->
|
|
38
|
+
|
|
39
|
+
## Prerequisites / readiness
|
|
40
|
+
|
|
41
|
+
- user accepts stateless job model
|
|
42
|
+
- Blender executable accessible to shell running job
|
|
43
|
+
|
|
44
|
+
## Input schema
|
|
45
|
+
|
|
46
|
+
### Required inputs
|
|
47
|
+
|
|
48
|
+
| Input | Why it is required |
|
|
49
|
+
|---|---|
|
|
50
|
+
| Job intent (batch render vs batch export vs scripted job) | Chooses matrix row (routeMCP vs CLI selection to `runtime-path-picker` first) |
|
|
51
|
+
| Output artifact expectations | Drives validation hooks (route format selection to `output-format-decision`) |
|
|
52
|
+
|
|
53
|
+
### Optional inputs
|
|
54
|
+
|
|
55
|
+
| Input | Use |
|
|
56
|
+
|---|---|
|
|
57
|
+
| GPU availability | Device flags category note |
|
|
58
|
+
| Mixture of Windows/Linux paths | Quote escaping caution |
|
|
59
|
+
|
|
60
|
+
## Output schema
|
|
61
|
+
|
|
62
|
+
### Primary output
|
|
63
|
+
|
|
64
|
+
- Phased job outline: startup, load, process, save
|
|
65
|
+
- Flag categories to look up in the upstream Blender manual (plain language only; no copy-paste Python dumps, no execution)
|
|
66
|
+
- Validation and logging hooks (stdout tail, expected output paths)
|
|
67
|
+
|
|
68
|
+
### Evidence / caveat output
|
|
69
|
+
|
|
70
|
+
```txt
|
|
71
|
+
Runtime status: Not Run | Attempted | Produced | Verified | Failed
|
|
72
|
+
Artifact status: Not Produced | Produced | Verified | Failed (default: Not Produced)
|
|
73
|
+
Rule: Downgrade-only, never upgrade. Outlining a job never executes Blender (Runtime remains Not Run; Artifact remains Not Produced).
|
|
74
|
+
Blockers: <separate line>
|
|
75
|
+
Evidence used: <none during outlining; route actual CLI logs/outputs to render-export-evidence>
|
|
76
|
+
Limitations: Stateless execution, no interactive viewport
|
|
77
|
+
```
|
|
78
|
+
|
|
79
|
+
## Required laws
|
|
80
|
+
|
|
81
|
+
- `../../laws/evidence-before-done.md`
|
|
82
|
+
- `../../laws/non-blender-user-language.md`
|
|
83
|
+
- `../../laws/no-arbitrary-python-interface.md`
|
|
84
|
+
- `../../laws/official-runtime-only.md`
|
|
85
|
+
|
|
86
|
+
## Official runtime boundary
|
|
87
|
+
|
|
88
|
+
Planning outline only — BlendOps never executes Blender and never presents arbitrary Python as the product surface. This CLI workflow is an **appendix only**, never a peer path without an eval record, and BlendOps has **no in-repo CLI evidence file yet**. Point users to the upstream Blender manual for exact CLI flags.
|
|
89
|
+
|
|
90
|
+
## Operating procedure
|
|
91
|
+
|
|
92
|
+
1. Verify `runtime-path-picker` confirmed MCP is ill-fit; if interactive MCP is needed, hand off to `path-one-host-outline`.
|
|
93
|
+
2. Verify target formats are settled via `output-format-decision`.
|
|
94
|
+
3. Select the job-type matrix row and outline phases (`blender --background` startup, load, process, save), flag categories, and validation/logging hooks in plain language without Python dumps.
|
|
95
|
+
4. Direct the user to verify exact flags against the upstream Blender manual.
|
|
96
|
+
5. Keep truth states at `Not Run` (Runtime) and `Not Produced` (Artifact); hand off actual CLI execution logs and outputs to `render-export-evidence`.
|
|
97
|
+
|
|
98
|
+
## Decision tree
|
|
99
|
+
|
|
100
|
+
```txt
|
|
101
|
+
Does the user need interactive viewport look-dev or live chat steering?
|
|
102
|
+
Yes → do NOT use CLI appendix; route to runtime-path-picker or path-one-host-outline
|
|
103
|
+
No → continue
|
|
104
|
+
Has MCP vs CLI path selection already been decided?
|
|
105
|
+
No → route to runtime-path-picker first to confirm CLI appendix fits constraints
|
|
106
|
+
Yes → continue
|
|
107
|
+
Are target output formats and resolutions settled?
|
|
108
|
+
No → route to output-format-decision / resolution-aspect-decision before outlining batch stages
|
|
109
|
+
Yes → continue
|
|
110
|
+
Which batch job pattern applies (`references/job-type-matrix.md`)?
|
|
111
|
+
Batch still render → outline startup, .blend load, engine/camera/output flag categories, and render log hooks
|
|
112
|
+
Batch GLB export → outline startup, .blend load, collection visibility/export check categories, and GLB size/validator hooks
|
|
113
|
+
Scripted scene hygiene / prep → outline factory-startup caution, `--python` ordering reminder, and file diff/hash hooks
|
|
114
|
+
Did the operator already run the CLI job and produce logs or files?
|
|
115
|
+
Yes → route logs to runtime-attempt-report and output files to render-export-evidence
|
|
116
|
+
No → emit planning outline with Runtime status: Not Run and Artifact status: Not Produced
|
|
117
|
+
```
|
|
118
|
+
|
|
119
|
+
## Playbooks
|
|
120
|
+
|
|
121
|
+
### Playbook A: CI or render-farm headless still render outline
|
|
122
|
+
|
|
123
|
+
- Select the **Batch still render** row from `references/job-type-matrix.md`.
|
|
124
|
+
- Structure the 4 phases (background startup, scene file load, render execution flags category, output verification hooks) and attach flag-ordering cautions from `references/flag-order-reminders.md`.
|
|
125
|
+
- Direct the operator to the upstream Blender CLI manual for exact version-matched flags and keep `Runtime status: Not Run` and `Artifact status: Not Produced`.
|
|
126
|
+
|
|
127
|
+
### Playbook B: Nightly headless GLB batch export outline
|
|
128
|
+
|
|
129
|
+
- Select the **Batch GLB export** row from `references/job-type-matrix.md` after confirming format rules via `output-format-decision`.
|
|
130
|
+
- Highlight stateless limitations (`references/stateless-limitations.md`), extension/add-on enablement differences under factory startup profiles, and argument-separator (`--`) cautions.
|
|
131
|
+
- Specify downstream evidence hooks for `render-export-evidence` and `glb-web-handoff`.
|
|
132
|
+
|
|
133
|
+
### Playbook C: Restricted IT environment where MCP ports are blocked
|
|
134
|
+
|
|
135
|
+
- Acknowledge the policy blocker on a separate `Blockers:` line when MCP bridges (port `9876`) are disallowed.
|
|
136
|
+
- Frame the `blender --background` workflow strictly as the **CLI fallback appendix** (documented upstream as a first-class Blender CLI surface, with no in-repo BlendOps eval record yet).
|
|
137
|
+
- Provide the phased job outline and logging hooks without pasting executable Python scripts.
|
|
138
|
+
|
|
139
|
+
## Mode handling
|
|
140
|
+
|
|
141
|
+
### Text-only mode
|
|
142
|
+
|
|
143
|
+
Provide the phased CLI job outline, flag categories, and stateless limitations. Runtime is `Not Run`; Artifact is `Not Produced`.
|
|
144
|
+
|
|
145
|
+
### Runtime-ready mode
|
|
146
|
+
|
|
147
|
+
Specify validation and logging hooks (where logs and output files should land), then hand off post-run verification to `render-export-evidence` and `runtime-attempt-report`. Outlining never upgrades truth states.
|
|
148
|
+
|
|
149
|
+
### Blocked runtime mode
|
|
150
|
+
|
|
151
|
+
Outline the intended phased job structure and record blockers on a separate line with Runtime `Not Run` and Artifact `Not Produced`.
|
|
152
|
+
|
|
153
|
+
## Validation checklist
|
|
154
|
+
|
|
155
|
+
* [ ] Framed strictly as an appendix, never a peer path without an eval record
|
|
156
|
+
* [ ] Stateless, no-viewport limitations acknowledged
|
|
157
|
+
* [ ] Upstream Blender CLI manual cited for exact flags
|
|
158
|
+
* [ ] No copy-paste Python dumps and no implication that BlendOps executes Blender
|
|
159
|
+
* [ ] Truth states respect downgrade-only rule (default `Not Produced` for artifacts; outlining never runs anything)
|
|
160
|
+
* [ ] Role boundaries preserved with `runtime-path-picker`, `output-format-decision`, and `render-export-evidence`
|
|
161
|
+
|
|
162
|
+
## Pass / Warn / Fail rubric
|
|
163
|
+
|
|
164
|
+
| Verdict | Criteria |
|
|
165
|
+
|---|---|
|
|
166
|
+
| Pass | Coherent phased outline + flag categories + validation/logging hooks + accurate downgrade-only truth states |
|
|
167
|
+
| Warn | GPU or OS path environment uncertain — dual-branch caution noted |
|
|
168
|
+
| Fail | Includes copy-paste Python dumps, treats CLI as a peer path, blurs roles with path/format/evidence skills, or upgrades truth states without verified evidence |
|
|
169
|
+
|
|
170
|
+
## Failure handling
|
|
171
|
+
|
|
172
|
+
- If the user asks for a copy-paste Python script or raw `bpy` batch code, refuse the code dump per `laws/no-arbitrary-python-interface.md` and provide a plain-language phased job outline plus upstream manual pointers instead.
|
|
173
|
+
- If the user wants live interactive viewport adjustments through the CLI appendix, stop and route back to `runtime-path-picker` or `path-one-host-outline`.
|
|
174
|
+
- If a prior CLI run failed silently (for example, flags placed after the scene filename were ignored before load), keep `Runtime status: Failed` (or `Attempted`), keep `Artifact status: Not Produced`, and route the log capture to `runtime-attempt-report`.
|
|
175
|
+
- Never promote the CLI fallback appendix to a peer MCP runtime path when no in-repo CLI evaluation record exists under `docs/evals/`.
|
|
176
|
+
|
|
177
|
+
## Troubleshooting
|
|
178
|
+
|
|
179
|
+
| Symptom | Cause | Safe resolution |
|
|
180
|
+
|---|---|---|
|
|
181
|
+
| CLI job renders default cube or wrong settings | Flag order error in `blender --background` (settings placed after render trigger or scene file) | Review `references/flag-order-reminders.md` and verify exact flag ordering in the upstream Blender command-line manual for the installed Blender version. |
|
|
182
|
+
| Custom script arguments disappear in headless run | Missing `--` argument separator after `--python` script path | Note the argument-separator check prompt from `references/flag-order-reminders.md` and consult upstream CLI docs. |
|
|
183
|
+
| Export add-on or GPU device missing on CI runner | Factory startup or headless runner profile differs from artist workstation | Flag the environment gap under `Limitations` (`references/stateless-limitations.md`) and require stdout/stderr device capture in `runtime-attempt-report`. |
|
|
184
|
+
|
|
185
|
+
## Best practices
|
|
186
|
+
|
|
187
|
+
- Always label `blender --background` workflows as the **CLI fallback appendix** — documented upstream as a first-class Blender CLI surface, while noting BlendOps has **no in-repo CLI evidence file yet**.
|
|
188
|
+
- Express job steps as phased operational checkpoints (`Startup → Load → Process → Save & Verify`) rather than raw shell one-liners or Python code blocks.
|
|
189
|
+
- Remind operators that argument order in Blender's CLI is positional and must be verified against the exact Blender manual version running on the host.
|
|
190
|
+
- Pair every CLI outline with explicit stdout/stderr log paths and output file checks consumed by `render-export-evidence`.
|
|
191
|
+
|
|
192
|
+
## Good examples
|
|
193
|
+
|
|
194
|
+
- "CLI appendix job outline (Batch GLB export): Phase 1 Background startup (headless mode, verify extension profile) → Phase 2 Load `.blend` source → Phase 3 Trigger GLB export step with `--` argument boundary checked against upstream Blender CLI manual → Phase 4 Capture exit code, stdout/stderr log path, and exported `.glb` byte size for `render-export-evidence`. Runtime status: Not Run. Artifact status: Not Produced."
|
|
195
|
+
- "Because interactive viewport look-dev is required, `cli-appendix-job-outline` is not the right surface (`references/stateless-limitations.md`); hand off to `runtime-path-picker` to evaluate Path 1 (Blender 5.1+ Lab MCP) or Path 2 (`mcp-for-blender`)."
|
|
196
|
+
|
|
197
|
+
## Bad examples
|
|
198
|
+
|
|
199
|
+
- "Run this 120-line Python script with `blender -b scene.blend -P export_all.py` and your GLBs are Verified." — violates `laws/no-arbitrary-python-interface.md` and `laws/evidence-before-done.md`.
|
|
200
|
+
- "Path 3 (Blender CLI) is a verified peer runtime in BlendOps." — misrepresents the CLI appendix as a peer path and fabricates in-repo eval evidence.
|
|
201
|
+
- " Blender 5.1+ is required to run `blender --background`." — falsely applies Path 1's Lab MCP add-on version floor to the CLI appendix.
|
|
202
|
+
|
|
203
|
+
## User-facing response template
|
|
204
|
+
|
|
205
|
+
```txt
|
|
206
|
+
Job classification: <Batch still render | Batch GLB export | Scripted scene prep | Hygiene pass> (CLI fallback appendix — not a peer MCP path; no in-repo BlendOps CLI evidence file yet)
|
|
207
|
+
Upstream reference: Verify exact positional flags in the official Blender Command Line Manual for your Blender version.
|
|
208
|
+
|
|
209
|
+
Phased job outline:
|
|
210
|
+
1. Startup: <headless background mode + startup profile checks>
|
|
211
|
+
2. Load: <target .blend input + path quoting cautions>
|
|
212
|
+
3. Process: <render/export/script flag category + ordering reminders>
|
|
213
|
+
4. Save & logging hooks: <expected output path + stdout/stderr log capture>
|
|
214
|
+
|
|
215
|
+
Stateless limitations: <no interactive viewport; factory-startup/GPU caveats>
|
|
216
|
+
Blockers: <none or specific environment/policy blockers>
|
|
217
|
+
Runtime status: Not Run
|
|
218
|
+
Artifact status: Not Produced
|
|
219
|
+
Evidence used: <none during outlining>
|
|
220
|
+
Next skill: <render-export-evidence | runtime-attempt-report | output-format-decision>
|
|
221
|
+
```
|
|
222
|
+
|
|
223
|
+
## Anti-patterns
|
|
224
|
+
|
|
225
|
+
- Dumping copy-paste Python (`bpy`) scripts or claiming BlendOps ships a CLI wrapper binary.
|
|
226
|
+
- Presenting the CLI fallback appendix as a peer path to Path 1 / Path 2 without an in-repo evaluation record under `docs/evals/`.
|
|
227
|
+
- Applying the Path 1 **Blender 5.1+** floor (`blender_version_min = "5.1.0"`) to `blender --background` CLI jobs.
|
|
228
|
+
- Writing `Artifact status: Not Run` or upgrading `Runtime status` / `Artifact status` merely from outlining a batch job.
|
|
229
|
+
- Skipping `output-format-decision` or `render-export-evidence` when planning deliverable verification.
|
|
230
|
+
|
|
231
|
+
## Cross-skill handoff
|
|
232
|
+
<!-- blendops:generated:start handoffs -->
|
|
233
|
+
- [upstream_reference] Pick MCP vs CLI → `../runtime-path-picker/SKILL.md`
|
|
234
|
+
- [upstream_reference] Interactive MCP host outline → `../path-one-host-outline/SKILL.md`
|
|
235
|
+
- [progression] Export format choices → `../output-format-decision/SKILL.md`
|
|
236
|
+
- [progression] Actual CLI output evidence recording → `../render-export-evidence/SKILL.md`
|
|
237
|
+
- [progression] Runtime attempt reporting → `../runtime-attempt-report/SKILL.md`
|
|
238
|
+
<!-- blendops:generated:end handoffs -->
|
|
239
|
+
|
|
240
|
+
## Non-goals
|
|
241
|
+
|
|
242
|
+
- Generating or debugging user-facing Python (`bpy`) scripts.
|
|
243
|
+
- Executing `blender --background` jobs or inspecting output files directly.
|
|
244
|
+
- Selecting between MCP Path 1, Path 2, and CLI (owned by `runtime-path-picker`).
|
|
245
|
+
- Certifying rendered frames or exported GLBs (owned by `render-export-evidence`).
|
|
246
|
+
|
|
247
|
+
## References
|
|
248
|
+
|
|
249
|
+
- `references/job-type-matrix.md`
|
|
250
|
+
- `references/flag-order-reminders.md`
|
|
251
|
+
- `references/stateless-limitations.md`
|
|
252
|
+
- `../../docs/runtime-stack-strategy.md`
|
|
@@ -0,0 +1,147 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$schema": "../../schemas/skill-contract.schema.json",
|
|
3
|
+
"id": "cli-appendix-job-outline",
|
|
4
|
+
"version": "1.0.0",
|
|
5
|
+
"category": "runtime-and-execution",
|
|
6
|
+
"role": "headless-cli-batch-job-planner",
|
|
7
|
+
"purpose": "Plan headless blender --background export or render jobs when MCP chat control is a poor fit; cite upstream Blender CLI docs only.",
|
|
8
|
+
"capabilityTier": "L0",
|
|
9
|
+
"triggers": [
|
|
10
|
+
"headless blender",
|
|
11
|
+
"batch render CLI",
|
|
12
|
+
"blender --background",
|
|
13
|
+
"render farm outline"
|
|
14
|
+
],
|
|
15
|
+
"exclusions": [
|
|
16
|
+
{
|
|
17
|
+
"condition": "interactive viewport iteration primary goal",
|
|
18
|
+
"delegateTo": "runtime-path-picker",
|
|
19
|
+
"reason": "Delegates out-of-scope requests to runtime-path-picker"
|
|
20
|
+
},
|
|
21
|
+
{
|
|
22
|
+
"condition": "user expects Connector chat loop",
|
|
23
|
+
"delegateTo": "path-one-host-outline",
|
|
24
|
+
"reason": "Delegates out-of-scope requests to path-one-host-outline"
|
|
25
|
+
}
|
|
26
|
+
],
|
|
27
|
+
"inputs": {
|
|
28
|
+
"required": [
|
|
29
|
+
{
|
|
30
|
+
"name": "target_blend_scene_and_outputs",
|
|
31
|
+
"type": "object",
|
|
32
|
+
"description": "Source .blend file expectations and target render/export output deliverables"
|
|
33
|
+
},
|
|
34
|
+
{
|
|
35
|
+
"name": "execution_environment_constraints",
|
|
36
|
+
"type": "string",
|
|
37
|
+
"description": "Headless CI, render node, or local batch constraints selected via runtime-path-picker"
|
|
38
|
+
}
|
|
39
|
+
],
|
|
40
|
+
"optional": [
|
|
41
|
+
{
|
|
42
|
+
"name": "frame_range_or_batch_items",
|
|
43
|
+
"type": "array",
|
|
44
|
+
"description": "Optional frame range or batch variant list for headless execution"
|
|
45
|
+
}
|
|
46
|
+
]
|
|
47
|
+
},
|
|
48
|
+
"outputs": {
|
|
49
|
+
"primary": [
|
|
50
|
+
"headless_cli_job_outline",
|
|
51
|
+
"appendix_governance_and_backup_gates",
|
|
52
|
+
"expected_output_evidence_hooks"
|
|
53
|
+
],
|
|
54
|
+
"truthStatePolicy": {
|
|
55
|
+
"runtimeDefault": "Not Run",
|
|
56
|
+
"artifactDefault": "Not Produced",
|
|
57
|
+
"mutationRule": "downgrade_only"
|
|
58
|
+
}
|
|
59
|
+
},
|
|
60
|
+
"handoffs": [
|
|
61
|
+
{
|
|
62
|
+
"target": "runtime-path-picker",
|
|
63
|
+
"type": "upstream_reference",
|
|
64
|
+
"label": "Pick MCP vs CLI",
|
|
65
|
+
"when": {
|
|
66
|
+
"all": [
|
|
67
|
+
{
|
|
68
|
+
"field": "runtime.path",
|
|
69
|
+
"operator": "equals",
|
|
70
|
+
"value": "unselected"
|
|
71
|
+
}
|
|
72
|
+
]
|
|
73
|
+
}
|
|
74
|
+
},
|
|
75
|
+
{
|
|
76
|
+
"target": "path-one-host-outline",
|
|
77
|
+
"type": "upstream_reference",
|
|
78
|
+
"label": "Interactive MCP host outline",
|
|
79
|
+
"when": {
|
|
80
|
+
"all": [
|
|
81
|
+
{
|
|
82
|
+
"field": "runtime.path",
|
|
83
|
+
"operator": "equals",
|
|
84
|
+
"value": "path_1"
|
|
85
|
+
},
|
|
86
|
+
{
|
|
87
|
+
"field": "stage.current",
|
|
88
|
+
"operator": "equals",
|
|
89
|
+
"value": "runtime_setup"
|
|
90
|
+
}
|
|
91
|
+
]
|
|
92
|
+
}
|
|
93
|
+
},
|
|
94
|
+
{
|
|
95
|
+
"target": "output-format-decision",
|
|
96
|
+
"type": "progression",
|
|
97
|
+
"label": "Export format choices",
|
|
98
|
+
"when": {
|
|
99
|
+
"all": [
|
|
100
|
+
{
|
|
101
|
+
"field": "decision.formatLocked",
|
|
102
|
+
"operator": "equals",
|
|
103
|
+
"value": false
|
|
104
|
+
}
|
|
105
|
+
]
|
|
106
|
+
}
|
|
107
|
+
},
|
|
108
|
+
{
|
|
109
|
+
"target": "render-export-evidence",
|
|
110
|
+
"type": "progression",
|
|
111
|
+
"label": "Actual CLI output evidence recording",
|
|
112
|
+
"when": {
|
|
113
|
+
"all": [
|
|
114
|
+
{
|
|
115
|
+
"field": "stage.current",
|
|
116
|
+
"operator": "equals",
|
|
117
|
+
"value": "post_execution_audit"
|
|
118
|
+
}
|
|
119
|
+
]
|
|
120
|
+
}
|
|
121
|
+
},
|
|
122
|
+
{
|
|
123
|
+
"target": "runtime-attempt-report",
|
|
124
|
+
"type": "progression",
|
|
125
|
+
"label": "Runtime attempt reporting",
|
|
126
|
+
"when": {
|
|
127
|
+
"all": [
|
|
128
|
+
{
|
|
129
|
+
"field": "runtime.status",
|
|
130
|
+
"operator": "in",
|
|
131
|
+
"value": [
|
|
132
|
+
"Attempted",
|
|
133
|
+
"Produced",
|
|
134
|
+
"Verified",
|
|
135
|
+
"Failed"
|
|
136
|
+
]
|
|
137
|
+
},
|
|
138
|
+
{
|
|
139
|
+
"field": "request.topic",
|
|
140
|
+
"operator": "equals",
|
|
141
|
+
"value": "attempt_report"
|
|
142
|
+
}
|
|
143
|
+
]
|
|
144
|
+
}
|
|
145
|
+
}
|
|
146
|
+
]
|
|
147
|
+
}
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
# CLI Flag Ordering & Upstream Manual Checkpoints
|
|
2
|
+
|
|
3
|
+
Blender evaluates CLI arguments **left-to-right sequentially**. Wrong ordering silently skips renders or drops script parameters without raising an error. Always verify exact flags against the upstream Blender Command Line Arguments manual matching the operator's binary version.
|
|
4
|
+
|
|
5
|
+
| Checkpoint | Failure mode if misplaced | Planning check rule |
|
|
6
|
+
|---|---|---|
|
|
7
|
+
| **`--background` (`-b`) position** | Loading `.blend` before `-b` opens GUI window; `-b` must precede scene file path. | `blender -b <scene.blend> ...` |
|
|
8
|
+
| **Output `-o` & format `-F` before `-f` / `-a`** | Placing `-o //out/frame_` *after* `-f 1` renders frame 1 to default `/tmp` before `-o` is read. | Put `-E`, `-o`, `-F` strictly *before* `-f` or `-a`. |
|
|
9
|
+
| **`--python` with `--` argument barrier** | Blender consumes flags (`-i`, `-o`, `--help`) unless separated by `--`. | Always pass custom parameters after `--`: `-P script.py -- --spec plan.json`. |
|
|
10
|
+
| **Python Exit Code (`--python-exit-code 1`)** | By default Blender exits `0` even when Python raises an unhandled traceback. | Explicitly require `--python-exit-code 1` in automation outlines so failures fail closed. |
|
|
11
|
+
| **`--factory-startup` add-on assumptions** | Skips user preferences and custom OCIO / extension state. | Note explicitly whether batch job requires `--factory-startup` or clean project profile. |
|
|
12
|
+
|
|
13
|
+
*Scope rule*: Use these as verification prompts inside plans and outlines — never present copy-paste Python snippets as the primary user-facing BlendOps interface (`no-arbitrary-python-interface.md`).
|
|
14
|
+
|
|
15
|
+
## Related skill
|
|
16
|
+
- [SKILL.md](../SKILL.md)
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
# CLI Appendix Job Type Matrix
|
|
2
|
+
|
|
3
|
+
Choose headless Blender CLI jobs whenever repeatability, CI automation, or batch export matters more than conversational inspection. Always cross-check exact flags against the upstream Blender Command Line manual matching the user's binary version.
|
|
4
|
+
|
|
5
|
+
| Job Type | Planning Focus | Critical Manual Checks | Required Verification Evidence |
|
|
6
|
+
|---|---|---|---|
|
|
7
|
+
| **Batch still / turntable render** | Camera name, resolution, Color Management (`AgX` / `Khronos PBR Neutral`), engine (`CYCLES` / `EEVEE`), frame range | Frame `-f` / `-a` vs output `-o` placement; GPU device fallback if headless | Rendered frame paths on disk, non-zero byte sizes, exit code `0`, clean `stderr` |
|
|
8
|
+
| **Headless GLB export** | Applied transforms (`Location/Rotation/Scale`), `Z=0` floor, modifier bake state, texture packing / compression settings | Extension flags per glTF 2.0 exporter version in target Blender release | Output `.glb` byte size, `blendops glb-inspect` / `gltf-validator` report, triangle/texture budget match |
|
|
9
|
+
| **Scene hygiene / purge pass** | Orphan data cleanup (`outliner.orphans_purge`), missing texture check, color space audit | Confirm `--factory-startup` does not strip required project add-ons or OCIO config | Before/after triangle, material, and orphan-block counts + saved `.blend` SHA-256 |
|
|
10
|
+
| **Deterministic scene build script** | Read inputs from JSON (`SceneSpec`), log structured JSON summary, never paste raw Python as final user chat output | Keep user script args strictly **after `--`** separator | Execution log, stdout JSON summary, explicit `Not Produced` for any skipped outputs |
|
|
11
|
+
|
|
12
|
+
## Related skill
|
|
13
|
+
- [SKILL.md](../SKILL.md)
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
# Stateless CLI Limitations & Verification Caveats
|
|
2
|
+
|
|
3
|
+
The `blender --background` CLI fallback is documented upstream as a **first-class Blender CLI surface** (currently carrying `Not Run` in-repo eval evidence in BlendOps). Operators using stateless batch jobs must account for these structural constraints:
|
|
4
|
+
|
|
5
|
+
1. **No mid-run conversational refinement**: A headless invocation executes its planned DAG once and exits. Visual lookdev tuning requires inspecting staged PNG/GLB outputs and running a bounded follow-up revision pass.
|
|
6
|
+
2. **UI & viewport operators fail without active GUI context**: Any script relying on `bpy.context.area`, viewport shading overrides, or interactive selection breaks under `-b` unless rewritten around headless `render(write_still=True)` or explicit data APIs (`bpy.data`).
|
|
7
|
+
3. **Simulation caches are not baked automatically**: Physics, cloth, rigid-body, or Geometry Nodes simulation zones remain replay-only unless explicitly baked (` Bake All` / `.bphys` / `simulation` cache) inside the `.blend` or pre-step before export/render.
|
|
8
|
+
4. **Device fallback ambiguity (`CYCLES_DEVICE` / GPU headless)**: Cloud/CI hosts without GPUs may silently fail or stall if `cycles.device` is forced to `OPTIX`/`CUDA` without falling back to `CPU`.
|
|
9
|
+
5. **Proof still requires output verification**: Exit code `0` alone proves nothing without checking rendered image dimensions/non-blank luminance and running `blendops glb-inspect` on exported GLBs.
|
|
10
|
+
|
|
11
|
+
## Related skill
|
|
12
|
+
- [SKILL.md](../SKILL.md)
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
# EVAL — color-management-decision
|
|
2
|
+
|
|
3
|
+
## Text-only eval prompt
|
|
4
|
+
Apply color-management-decision for a web hero PNG output, sRGB consumer pipeline.
|
|
5
|
+
|
|
6
|
+
## Expected behavior
|
|
7
|
+
- Display Device: sRGB
|
|
8
|
+
- View Transform: Filmic (or Standard for pure flat color)
|
|
9
|
+
- Look: None or Medium High Contrast
|
|
10
|
+
- Sequencer: sRGB
|
|
11
|
+
- Output rule: PNG 8-bit sRGB
|
|
12
|
+
- Caveats: per-channel texture rules (color sRGB, data Linear)
|
|
13
|
+
- handoff: render-export-evidence
|
|
14
|
+
|
|
15
|
+
## Pass / Warn / Fail criteria
|
|
16
|
+
- Pass: 4-line config + per-output + caveats + handoff
|
|
17
|
+
- Warn: config pinned but caveat thin
|
|
18
|
+
- Fail: wrong pipeline match, "looks good" verdict, skipped per-channel rules
|
|
19
|
+
|
|
20
|
+
## Sample passing response outline
|
|
21
|
+
- Consumer pipeline + outputs header
|
|
22
|
+
- 4-line config
|
|
23
|
+
- Per-output rules
|
|
24
|
+
- Caveats list
|
|
25
|
+
|
|
26
|
+
## Sample failing response outline
|
|
27
|
+
- "Use Filmic"
|
|
28
|
+
- No pipeline context
|