blendops 0.0.0-stage → 1.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +74 -0
- package/LICENSE +21 -0
- package/README.md +208 -2
- package/bin/blendops.mjs +4 -0
- package/bundles/claude-desktop-manual/BLENDOPS_SINGLE_FILE.md +78 -0
- package/bundles/claude-desktop-manual/IMPORT_STEPS.md +43 -0
- package/bundles/claude-desktop-manual/INSTALL_REPORT_TEMPLATE.md +13 -0
- package/bundles/claude-desktop-manual/README.md +70 -0
- package/bundles/claude-desktop-manual/SKILL.md +62 -0
- package/bundles/claude-desktop-manual/manifest.json +278 -0
- package/bundles/claude-desktop-manual/references/evidence-rules.md +13 -0
- package/bundles/claude-desktop-manual/references/install-boundary.md +13 -0
- package/bundles/claude-desktop-manual/references/laws/evidence-before-done.md +14 -0
- package/bundles/claude-desktop-manual/references/laws/no-arbitrary-python-interface.md +12 -0
- package/bundles/claude-desktop-manual/references/laws/non-blender-user-language.md +13 -0
- package/bundles/claude-desktop-manual/references/laws/official-runtime-only.md +20 -0
- package/bundles/claude-desktop-manual/references/packs/product-hero-v0.md +30 -0
- package/bundles/claude-desktop-manual/references/runtime-stacks.md +13 -0
- package/bundles/claude-desktop-manual/references/skill-map.md +36 -0
- package/bundles/claude-desktop-manual/references/skills/acceptance-criteria-builder.md +69 -0
- package/bundles/claude-desktop-manual/references/skills/asset-discovery.md +73 -0
- package/bundles/claude-desktop-manual/references/skills/asset-fallback-strategy.md +66 -0
- package/bundles/claude-desktop-manual/references/skills/asset-library-plan.md +69 -0
- package/bundles/claude-desktop-manual/references/skills/asset-license-checker.md +69 -0
- package/bundles/claude-desktop-manual/references/skills/asset-style-check.md +69 -0
- package/bundles/claude-desktop-manual/references/skills/blender-brainstorming.md +62 -0
- package/bundles/claude-desktop-manual/references/skills/blender-recipe-decomposer.md +66 -0
- package/bundles/claude-desktop-manual/references/skills/blender-troubleshooting.md +78 -0
- package/bundles/claude-desktop-manual/references/skills/blendops-help.md +82 -0
- package/bundles/claude-desktop-manual/references/skills/bridge-conflicts.md +68 -0
- package/bundles/claude-desktop-manual/references/skills/camera-composition.md +65 -0
- package/bundles/claude-desktop-manual/references/skills/character-portrait.md +68 -0
- package/bundles/claude-desktop-manual/references/skills/cli-appendix-job-outline.md +62 -0
- package/bundles/claude-desktop-manual/references/skills/color-management-decision.md +68 -0
- package/bundles/claude-desktop-manual/references/skills/composition-quality-checker.md +71 -0
- package/bundles/claude-desktop-manual/references/skills/cycles-vs-eevee-decision.md +65 -0
- package/bundles/claude-desktop-manual/references/skills/done-criteria.md +70 -0
- package/bundles/claude-desktop-manual/references/skills/environment-shot.md +65 -0
- package/bundles/claude-desktop-manual/references/skills/glb-animation-handoff.md +69 -0
- package/bundles/claude-desktop-manual/references/skills/glb-web-handoff.md +68 -0
- package/bundles/claude-desktop-manual/references/skills/intent-to-3d-brief-writer.md +68 -0
- package/bundles/claude-desktop-manual/references/skills/interior-scene.md +73 -0
- package/bundles/claude-desktop-manual/references/skills/lighting-material-plan.md +65 -0
- package/bundles/claude-desktop-manual/references/skills/lighting-quality-checker.md +70 -0
- package/bundles/claude-desktop-manual/references/skills/material-quality-checker.md +71 -0
- package/bundles/claude-desktop-manual/references/skills/mobile-glb-budget.md +73 -0
- package/bundles/claude-desktop-manual/references/skills/output-format-decision.md +63 -0
- package/bundles/claude-desktop-manual/references/skills/pack-prerequisite-checker.md +74 -0
- package/bundles/claude-desktop-manual/references/skills/path-one-host-outline.md +66 -0
- package/bundles/claude-desktop-manual/references/skills/plain-language-response.md +70 -0
- package/bundles/claude-desktop-manual/references/skills/polycount-budget-checker.md +71 -0
- package/bundles/claude-desktop-manual/references/skills/pre-handoff-verification.md +76 -0
- package/bundles/claude-desktop-manual/references/skills/preview-report.md +62 -0
- package/bundles/claude-desktop-manual/references/skills/product-grid-scene-planner.md +72 -0
- package/bundles/claude-desktop-manual/references/skills/product-hero-scene-planner.md +68 -0
- package/bundles/claude-desktop-manual/references/skills/r3f-component-plan.md +66 -0
- package/bundles/claude-desktop-manual/references/skills/recipe-fit-assessor.md +75 -0
- package/bundles/claude-desktop-manual/references/skills/render-export-evidence.md +70 -0
- package/bundles/claude-desktop-manual/references/skills/resolution-aspect-decision.md +65 -0
- package/bundles/claude-desktop-manual/references/skills/runtime-attempt-report.md +67 -0
- package/bundles/claude-desktop-manual/references/skills/runtime-path-picker.md +67 -0
- package/bundles/claude-desktop-manual/references/skills/runtime-readiness.md +63 -0
- package/bundles/claude-desktop-manual/references/skills/runtime-setup.md +63 -0
- package/bundles/claude-desktop-manual/references/skills/scene-readiness.md +65 -0
- package/bundles/claude-desktop-manual/references/skills/scope-guard.md +62 -0
- package/bundles/claude-desktop-manual/references/skills/stage-gates.md +91 -0
- package/bundles/claude-desktop-manual/references/skills/workflow-stage-router.md +67 -0
- package/bundles/generic-project-local/BLENDOPS.md +71 -0
- package/bundles/generic-project-local/INSTALL_REPORT_TEMPLATE.md +52 -0
- package/bundles/generic-project-local/README.md +73 -0
- package/bundles/generic-project-local/ROLLBACK.md +66 -0
- package/bundles/generic-project-local/manifest.json +66 -0
- package/bundles/skill-package/README.md +54 -0
- package/bundles/skill-package/blendops/LICENSE.txt +21 -0
- package/bundles/skill-package/blendops/SKILL.md +50 -0
- package/bundles/skill-package/blendops/agents/README.md +61 -0
- package/bundles/skill-package/blendops/agents/openai.yaml +4 -0
- package/bundles/skill-package/blendops/references/evidence-rules.md +17 -0
- package/bundles/skill-package/blendops/references/install-boundary.md +13 -0
- package/bundles/skill-package/blendops/references/law-evidence-before-done.md +12 -0
- package/bundles/skill-package/blendops/references/law-no-arbitrary-python-interface.md +7 -0
- package/bundles/skill-package/blendops/references/law-non-blender-user-language.md +8 -0
- package/bundles/skill-package/blendops/references/law-official-runtime-only.md +9 -0
- package/bundles/skill-package/blendops/references/pack-product-hero-v0.md +21 -0
- package/bundles/skill-package/blendops/references/runtime-stacks.md +13 -0
- package/bundles/skill-package/blendops/references/skill-acceptance-criteria-builder.md +51 -0
- package/bundles/skill-package/blendops/references/skill-asset-discovery.md +54 -0
- package/bundles/skill-package/blendops/references/skill-asset-fallback-strategy.md +48 -0
- package/bundles/skill-package/blendops/references/skill-asset-library-plan.md +51 -0
- package/bundles/skill-package/blendops/references/skill-asset-license-checker.md +51 -0
- package/bundles/skill-package/blendops/references/skill-asset-style-check.md +52 -0
- package/bundles/skill-package/blendops/references/skill-blender-brainstorming.md +43 -0
- package/bundles/skill-package/blendops/references/skill-blender-recipe-decomposer.md +48 -0
- package/bundles/skill-package/blendops/references/skill-blender-troubleshooting.md +59 -0
- package/bundles/skill-package/blendops/references/skill-blendops-help.md +62 -0
- package/bundles/skill-package/blendops/references/skill-bridge-conflicts.md +48 -0
- package/bundles/skill-package/blendops/references/skill-camera-composition.md +48 -0
- package/bundles/skill-package/blendops/references/skill-character-portrait.md +50 -0
- package/bundles/skill-package/blendops/references/skill-cli-appendix-job-outline.md +44 -0
- package/bundles/skill-package/blendops/references/skill-color-management-decision.md +50 -0
- package/bundles/skill-package/blendops/references/skill-composition-quality-checker.md +53 -0
- package/bundles/skill-package/blendops/references/skill-cycles-vs-eevee-decision.md +47 -0
- package/bundles/skill-package/blendops/references/skill-done-criteria.md +53 -0
- package/bundles/skill-package/blendops/references/skill-environment-shot.md +47 -0
- package/bundles/skill-package/blendops/references/skill-glb-animation-handoff.md +51 -0
- package/bundles/skill-package/blendops/references/skill-glb-web-handoff.md +51 -0
- package/bundles/skill-package/blendops/references/skill-intent-to-3d-brief-writer.md +50 -0
- package/bundles/skill-package/blendops/references/skill-interior-scene.md +54 -0
- package/bundles/skill-package/blendops/references/skill-lighting-material-plan.md +48 -0
- package/bundles/skill-package/blendops/references/skill-lighting-quality-checker.md +52 -0
- package/bundles/skill-package/blendops/references/skill-map.md +32 -0
- package/bundles/skill-package/blendops/references/skill-material-quality-checker.md +53 -0
- package/bundles/skill-package/blendops/references/skill-mobile-glb-budget.md +55 -0
- package/bundles/skill-package/blendops/references/skill-output-format-decision.md +46 -0
- package/bundles/skill-package/blendops/references/skill-pack-prerequisite-checker.md +56 -0
- package/bundles/skill-package/blendops/references/skill-path-one-host-outline.md +48 -0
- package/bundles/skill-package/blendops/references/skill-plain-language-response.md +53 -0
- package/bundles/skill-package/blendops/references/skill-polycount-budget-checker.md +53 -0
- package/bundles/skill-package/blendops/references/skill-pre-handoff-verification.md +57 -0
- package/bundles/skill-package/blendops/references/skill-preview-report.md +45 -0
- package/bundles/skill-package/blendops/references/skill-product-grid-scene-planner.md +54 -0
- package/bundles/skill-package/blendops/references/skill-product-hero-scene-planner.md +51 -0
- package/bundles/skill-package/blendops/references/skill-r3f-component-plan.md +48 -0
- package/bundles/skill-package/blendops/references/skill-recipe-fit-assessor.md +57 -0
- package/bundles/skill-package/blendops/references/skill-render-export-evidence.md +51 -0
- package/bundles/skill-package/blendops/references/skill-resolution-aspect-decision.md +48 -0
- package/bundles/skill-package/blendops/references/skill-runtime-attempt-report.md +49 -0
- package/bundles/skill-package/blendops/references/skill-runtime-path-picker.md +49 -0
- package/bundles/skill-package/blendops/references/skill-runtime-readiness.md +45 -0
- package/bundles/skill-package/blendops/references/skill-runtime-setup.md +45 -0
- package/bundles/skill-package/blendops/references/skill-scene-readiness.md +48 -0
- package/bundles/skill-package/blendops/references/skill-scope-guard.md +44 -0
- package/bundles/skill-package/blendops/references/skill-stage-gates.md +73 -0
- package/bundles/skill-package/blendops/references/skill-workflow-stage-router.md +49 -0
- package/docs/README.md +276 -0
- package/docs/examples/glb-web-handoff/README.md +174 -0
- package/docs/examples/glb-web-handoff/r3f-glb-viewer.tsx +320 -0
- package/docs/examples/glb-web-handoff/threejs-glb-viewer.mjs +709 -0
- package/docs/knowledge-and-recipe-catalog.md +236 -0
- package/docs/recipes/README.md +27 -0
- package/docs/recipes/cyberpunk-shoe-hero.md +97 -0
- package/docs/workflows/README.md +14 -0
- package/docs/workflows/full-non-blender-user-workflow.md +210 -0
- package/docs/workflows/product-hero-workflow.md +92 -0
- package/laws/README.md +32 -0
- package/laws/evidence-before-done.md +37 -0
- package/laws/no-arbitrary-python-interface.md +32 -0
- package/laws/non-blender-user-language.md +32 -0
- package/laws/official-runtime-only.md +78 -0
- package/package.json +103 -4
- package/packs/README.md +11 -0
- package/packs/product-hero-v0/PACK.md +114 -0
- package/registry/catalog-index.json +21344 -0
- package/registry/compatibility-matrix.json +533 -0
- package/registry/contract-context-fields.json +391 -0
- package/registry/knowledge-catalog.json +4648 -0
- package/registry/knowledge-sources.json +438 -0
- package/registry/recipe-catalog.json +2565 -0
- package/registry/runtime-capability-policy.json +525 -0
- package/registry/runtime-operations.json +4468 -0
- package/registry/skills.json +10231 -0
- package/registry/workflow-graph.json +7390 -0
- package/schemas/adapter-compatibility-matrix.schema.json +166 -0
- package/schemas/contract-context-fields.schema.json +147 -0
- package/schemas/execution-plan.schema.json +325 -0
- package/schemas/glb-web-handoff-manifest.schema.json +744 -0
- package/schemas/knowledge-record.schema.json +460 -0
- package/schemas/knowledge-source-registry.schema.json +268 -0
- package/schemas/operation-execution-ledger.schema.json +348 -0
- package/schemas/recipe-record.schema.json +469 -0
- package/schemas/runtime-capability-policy.schema.json +184 -0
- package/schemas/runtime-evidence-packet.schema.json +211 -0
- package/schemas/runtime-operations.schema.json +535 -0
- package/schemas/runtime-qualification-report.schema.json +540 -0
- package/schemas/runtime-session.schema.json +350 -0
- package/schemas/scene-spec.schema.json +624 -0
- package/schemas/skill-contract.schema.json +402 -0
- package/schemas/skill-eval.schema.json +509 -0
- package/scripts/build-knowledge-catalog.mjs +2376 -0
- package/scripts/compile-scene-plan.mjs +1945 -0
- package/scripts/export-claude-skills.mjs +634 -0
- package/scripts/generate-glb-handoff-report.mjs +2376 -0
- package/scripts/inspect-glb.mjs +1627 -0
- package/scripts/install-skills.mjs +5443 -0
- package/scripts/runtime-orchestrator.mjs +7713 -0
- package/scripts/validate-capability-policy.mjs +531 -0
- package/scripts/validate-evidence-packet.mjs +256 -0
- package/skills/README.md +315 -0
- package/skills/_template/SKILL.md +296 -0
- package/skills/acceptance-criteria-builder/EVAL.md +25 -0
- package/skills/acceptance-criteria-builder/SKILL.md +257 -0
- package/skills/acceptance-criteria-builder/contract.json +205 -0
- package/skills/acceptance-criteria-builder/references/brief-to-criteria-mapper.md +22 -0
- package/skills/acceptance-criteria-builder/references/checklist-patterns.md +22 -0
- package/skills/acceptance-criteria-builder/references/evidence-hook-rules.md +19 -0
- package/skills/asset-discovery/EVAL.md +81 -0
- package/skills/asset-discovery/SKILL.md +252 -0
- package/skills/asset-discovery/contract.json +291 -0
- package/skills/asset-discovery/references/asset-strategy-decision-tree.md +40 -0
- package/skills/asset-discovery/references/budget-reconciliation-patterns.md +54 -0
- package/skills/asset-discovery/references/license-confidence-table.md +41 -0
- package/skills/asset-fallback-strategy/EVAL.md +34 -0
- package/skills/asset-fallback-strategy/SKILL.md +248 -0
- package/skills/asset-fallback-strategy/contract.json +190 -0
- package/skills/asset-fallback-strategy/references/drop-with-caveat-rules.md +36 -0
- package/skills/asset-fallback-strategy/references/fallback-option-types.md +55 -0
- package/skills/asset-fallback-strategy/references/scoring-rubric.md +61 -0
- package/skills/asset-library-plan/EVAL.md +28 -0
- package/skills/asset-library-plan/SKILL.md +263 -0
- package/skills/asset-library-plan/contract.json +177 -0
- package/skills/asset-library-plan/references/folder-structure-rules.md +63 -0
- package/skills/asset-library-plan/references/metadata-schema.md +62 -0
- package/skills/asset-library-plan/references/naming-rules.md +51 -0
- package/skills/asset-license-checker/EVAL.md +33 -0
- package/skills/asset-license-checker/SKILL.md +245 -0
- package/skills/asset-license-checker/contract.json +172 -0
- package/skills/asset-license-checker/references/attribution-rendering-patterns.md +48 -0
- package/skills/asset-license-checker/references/common-license-mapping.md +39 -0
- package/skills/asset-license-checker/references/license-source-rules.md +38 -0
- package/skills/asset-style-check/EVAL.md +26 -0
- package/skills/asset-style-check/SKILL.md +238 -0
- package/skills/asset-style-check/contract.json +251 -0
- package/skills/asset-style-check/references/drift-classification.md +40 -0
- package/skills/asset-style-check/references/intentional-mixed-style.md +39 -0
- package/skills/asset-style-check/references/style-axes.md +46 -0
- package/skills/blender-brainstorming/EVAL.md +79 -0
- package/skills/blender-brainstorming/SKILL.md +228 -0
- package/skills/blender-brainstorming/contract.json +115 -0
- package/skills/blender-brainstorming/references/alternative-scoping-templates.md +43 -0
- package/skills/blender-brainstorming/references/clarification-patterns.md +29 -0
- package/skills/blender-brainstorming/references/intent-summary-style-guide.md +25 -0
- package/skills/blender-recipe-decomposer/EVAL.md +35 -0
- package/skills/blender-recipe-decomposer/SKILL.md +258 -0
- package/skills/blender-recipe-decomposer/contract.json +152 -0
- package/skills/blender-recipe-decomposer/references/dependency-patterns.md +53 -0
- package/skills/blender-recipe-decomposer/references/recipe-grouping-rules.md +58 -0
- package/skills/blender-recipe-decomposer/references/recipe-naming-rules.md +44 -0
- package/skills/blender-troubleshooting/EVAL.md +78 -0
- package/skills/blender-troubleshooting/SKILL.md +263 -0
- package/skills/blender-troubleshooting/contract.json +352 -0
- package/skills/blender-troubleshooting/references/common-symptom-playbooks.md +51 -0
- package/skills/blender-troubleshooting/references/divergence-routing-table.md +23 -0
- package/skills/blender-troubleshooting/references/four-phase-template.md +51 -0
- package/skills/blendops-help/EVAL.md +67 -0
- package/skills/blendops-help/SKILL.md +312 -0
- package/skills/blendops-help/contract.json +229 -0
- package/skills/blendops-help/references/lifecycle-phases.md +91 -0
- package/skills/blendops-help/references/quick-start-prompts.md +65 -0
- package/skills/blendops-help/references/routing-decision-tree.md +57 -0
- package/skills/bridge-conflicts/EVAL.md +83 -0
- package/skills/bridge-conflicts/SKILL.md +246 -0
- package/skills/bridge-conflicts/contract.json +145 -0
- package/skills/bridge-conflicts/references/bridge-state-matrix-template.md +82 -0
- package/skills/bridge-conflicts/references/conflict-playbooks.md +99 -0
- package/skills/bridge-conflicts/references/do-not-reminders.md +42 -0
- package/skills/camera-composition/EVAL.md +32 -0
- package/skills/camera-composition/SKILL.md +196 -0
- package/skills/camera-composition/contract.json +180 -0
- package/skills/camera-composition/references/camera-presets.md +30 -0
- package/skills/camera-composition/references/camera-rubric.md +24 -0
- package/skills/camera-composition/references/hero-composition-patterns.md +24 -0
- package/skills/camera-composition/references/web-layout-negative-space.md +25 -0
- package/skills/character-portrait/EVAL.md +42 -0
- package/skills/character-portrait/SKILL.md +245 -0
- package/skills/character-portrait/contract.json +205 -0
- package/skills/character-portrait/references/portrait-framing-rules.md +39 -0
- package/skills/character-portrait/references/portrait-lighting-patterns.md +50 -0
- package/skills/character-portrait/references/style-consistency-rules.md +41 -0
- package/skills/cli-appendix-job-outline/EVAL.md +26 -0
- package/skills/cli-appendix-job-outline/SKILL.md +252 -0
- package/skills/cli-appendix-job-outline/contract.json +147 -0
- package/skills/cli-appendix-job-outline/references/flag-order-reminders.md +16 -0
- package/skills/cli-appendix-job-outline/references/job-type-matrix.md +13 -0
- package/skills/cli-appendix-job-outline/references/stateless-limitations.md +12 -0
- package/skills/color-management-decision/EVAL.md +28 -0
- package/skills/color-management-decision/SKILL.md +254 -0
- package/skills/color-management-decision/contract.json +162 -0
- package/skills/color-management-decision/references/look-comparison.md +44 -0
- package/skills/color-management-decision/references/per-channel-rules.md +49 -0
- package/skills/color-management-decision/references/pipeline-mapping.md +47 -0
- package/skills/composition-quality-checker/EVAL.md +38 -0
- package/skills/composition-quality-checker/SKILL.md +260 -0
- package/skills/composition-quality-checker/contract.json +221 -0
- package/skills/composition-quality-checker/references/aspect-ratio-rules.md +37 -0
- package/skills/composition-quality-checker/references/composition-rules.md +58 -0
- package/skills/composition-quality-checker/references/headroom-leadroom-rules.md +46 -0
- package/skills/cycles-vs-eevee-decision/EVAL.md +26 -0
- package/skills/cycles-vs-eevee-decision/SKILL.md +249 -0
- package/skills/cycles-vs-eevee-decision/contract.json +142 -0
- package/skills/cycles-vs-eevee-decision/references/engine-feature-matrix.md +39 -0
- package/skills/cycles-vs-eevee-decision/references/gpu-device-rules.md +51 -0
- package/skills/cycles-vs-eevee-decision/references/samples-by-quality.md +53 -0
- package/skills/done-criteria/EVAL.md +33 -0
- package/skills/done-criteria/SKILL.md +225 -0
- package/skills/done-criteria/contract.json +199 -0
- package/skills/done-criteria/references/done-vs-perfect.md +56 -0
- package/skills/done-criteria/references/out-of-scope-patterns.md +50 -0
- package/skills/done-criteria/references/stop-condition-templates.md +39 -0
- package/skills/environment-shot/EVAL.md +44 -0
- package/skills/environment-shot/SKILL.md +237 -0
- package/skills/environment-shot/contract.json +162 -0
- package/skills/environment-shot/references/depth-layering-rules.md +49 -0
- package/skills/environment-shot/references/time-and-weather-rules.md +35 -0
- package/skills/environment-shot/references/wide-shot-camera-rules.md +51 -0
- package/skills/glb-animation-handoff/EVAL.md +39 -0
- package/skills/glb-animation-handoff/SKILL.md +271 -0
- package/skills/glb-animation-handoff/contract.json +247 -0
- package/skills/glb-animation-handoff/references/animation-types.md +36 -0
- package/skills/glb-animation-handoff/references/transition-rules.md +55 -0
- package/skills/glb-animation-handoff/references/web-stack-caveats.md +40 -0
- package/skills/glb-web-handoff/EVAL.md +33 -0
- package/skills/glb-web-handoff/SKILL.md +212 -0
- package/skills/glb-web-handoff/contract.json +171 -0
- package/skills/glb-web-handoff/references/artifact-status-language.md +26 -0
- package/skills/glb-web-handoff/references/glb-handoff-checklist.md +30 -0
- package/skills/glb-web-handoff/references/performance-caveats.md +26 -0
- package/skills/glb-web-handoff/references/threejs-r3f-handoff.md +28 -0
- package/skills/intent-to-3d-brief-writer/EVAL.md +82 -0
- package/skills/intent-to-3d-brief-writer/SKILL.md +238 -0
- package/skills/intent-to-3d-brief-writer/contract.json +195 -0
- package/skills/intent-to-3d-brief-writer/references/acceptance-criteria-patterns.md +46 -0
- package/skills/intent-to-3d-brief-writer/references/eight-slot-template.md +123 -0
- package/skills/intent-to-3d-brief-writer/references/mixed-audience-handling.md +39 -0
- package/skills/interior-scene/EVAL.md +44 -0
- package/skills/interior-scene/SKILL.md +261 -0
- package/skills/interior-scene/contract.json +277 -0
- package/skills/interior-scene/references/furniture-layout-rules.md +51 -0
- package/skills/interior-scene/references/interior-architecture-rules.md +47 -0
- package/skills/interior-scene/references/interior-camera-rules.md +47 -0
- package/skills/lighting-material-plan/EVAL.md +32 -0
- package/skills/lighting-material-plan/SKILL.md +194 -0
- package/skills/lighting-material-plan/contract.json +213 -0
- package/skills/lighting-material-plan/references/cyberpunk-lookdev.md +22 -0
- package/skills/lighting-material-plan/references/lighting-patterns.md +30 -0
- package/skills/lighting-material-plan/references/material-portability.md +25 -0
- package/skills/lighting-material-plan/references/reflective-floor-pattern.md +22 -0
- package/skills/lighting-material-plan/references/web-material-simplification.md +23 -0
- package/skills/lighting-quality-checker/EVAL.md +41 -0
- package/skills/lighting-quality-checker/SKILL.md +247 -0
- package/skills/lighting-quality-checker/contract.json +187 -0
- package/skills/lighting-quality-checker/references/hdri-balance-rules.md +48 -0
- package/skills/lighting-quality-checker/references/intensity-ranges.md +73 -0
- package/skills/lighting-quality-checker/references/shadow-softness-rules.md +38 -0
- package/skills/material-quality-checker/EVAL.md +40 -0
- package/skills/material-quality-checker/SKILL.md +261 -0
- package/skills/material-quality-checker/contract.json +244 -0
- package/skills/material-quality-checker/references/consumer-stack-rules.md +62 -0
- package/skills/material-quality-checker/references/pbr-sanity-rules.md +78 -0
- package/skills/material-quality-checker/references/texture-budget-rules.md +48 -0
- package/skills/mobile-glb-budget/EVAL.md +40 -0
- package/skills/mobile-glb-budget/SKILL.md +264 -0
- package/skills/mobile-glb-budget/contract.json +309 -0
- package/skills/mobile-glb-budget/references/budget-tiers.md +30 -0
- package/skills/mobile-glb-budget/references/degradation-plan.md +34 -0
- package/skills/mobile-glb-budget/references/violation-rules.md +43 -0
- package/skills/output-format-decision/EVAL.md +27 -0
- package/skills/output-format-decision/SKILL.md +222 -0
- package/skills/output-format-decision/contract.json +179 -0
- package/skills/output-format-decision/references/bit-depth-rules.md +56 -0
- package/skills/output-format-decision/references/compression-tradeoffs.md +62 -0
- package/skills/output-format-decision/references/format-decision-matrix.md +34 -0
- package/skills/pack-prerequisite-checker/EVAL.md +26 -0
- package/skills/pack-prerequisite-checker/SKILL.md +272 -0
- package/skills/pack-prerequisite-checker/contract.json +214 -0
- package/skills/pack-prerequisite-checker/references/blocked-start-playbook.md +21 -0
- package/skills/pack-prerequisite-checker/references/pack-readiness-template.md +38 -0
- package/skills/pack-prerequisite-checker/references/prerequisite-matrix.md +20 -0
- package/skills/path-one-host-outline/EVAL.md +26 -0
- package/skills/path-one-host-outline/SKILL.md +251 -0
- package/skills/path-one-host-outline/contract.json +167 -0
- package/skills/path-one-host-outline/references/connector-vs-manual-matrix.md +21 -0
- package/skills/path-one-host-outline/references/host-checklist-template.md +35 -0
- package/skills/path-one-host-outline/references/lab-addon-reminders.md +12 -0
- package/skills/plain-language-response/EVAL.md +33 -0
- package/skills/plain-language-response/SKILL.md +194 -0
- package/skills/plain-language-response/contract.json +242 -0
- package/skills/plain-language-response/references/caveat-language.md +25 -0
- package/skills/plain-language-response/references/plain-language-patterns.md +30 -0
- package/skills/plain-language-response/references/stakeholder-friendly-examples.md +30 -0
- package/skills/plain-language-response/references/status-summary-templates.md +50 -0
- package/skills/polycount-budget-checker/EVAL.md +40 -0
- package/skills/polycount-budget-checker/SKILL.md +251 -0
- package/skills/polycount-budget-checker/contract.json +196 -0
- package/skills/polycount-budget-checker/references/instance-counting-rules.md +39 -0
- package/skills/polycount-budget-checker/references/per-mesh-rules.md +43 -0
- package/skills/polycount-budget-checker/references/topology-hints.md +56 -0
- package/skills/pre-handoff-verification/EVAL.md +84 -0
- package/skills/pre-handoff-verification/SKILL.md +252 -0
- package/skills/pre-handoff-verification/contract.json +295 -0
- package/skills/pre-handoff-verification/references/downgrade-rules.md +39 -0
- package/skills/pre-handoff-verification/references/seven-point-checklist.md +46 -0
- package/skills/pre-handoff-verification/references/text-only-mode-handling.md +36 -0
- package/skills/preview-report/EVAL.md +39 -0
- package/skills/preview-report/SKILL.md +254 -0
- package/skills/preview-report/contract.json +141 -0
- package/skills/preview-report/references/handoff-recipients.md +41 -0
- package/skills/preview-report/references/report-schema.md +60 -0
- package/skills/preview-report/references/truth-label-rules.md +36 -0
- package/skills/product-grid-scene-planner/EVAL.md +42 -0
- package/skills/product-grid-scene-planner/SKILL.md +246 -0
- package/skills/product-grid-scene-planner/contract.json +257 -0
- package/skills/product-grid-scene-planner/references/grid-consistency-rules.md +53 -0
- package/skills/product-grid-scene-planner/references/grid-layout-rules.md +42 -0
- package/skills/product-grid-scene-planner/references/grid-output-naming-rules.md +52 -0
- package/skills/product-hero-scene-planner/EVAL.md +33 -0
- package/skills/product-hero-scene-planner/SKILL.md +227 -0
- package/skills/product-hero-scene-planner/contract.json +228 -0
- package/skills/product-hero-scene-planner/references/clarification-patterns.md +24 -0
- package/skills/product-hero-scene-planner/references/cyberpunk-shoe-example.md +28 -0
- package/skills/product-hero-scene-planner/references/product-hero-playbooks.md +22 -0
- package/skills/product-hero-scene-planner/references/scene-plan-schema.md +35 -0
- package/skills/r3f-component-plan/EVAL.md +43 -0
- package/skills/r3f-component-plan/SKILL.md +290 -0
- package/skills/r3f-component-plan/contract.json +171 -0
- package/skills/r3f-component-plan/references/component-shape-patterns.md +54 -0
- package/skills/r3f-component-plan/references/suspense-placement-rules.md +50 -0
- package/skills/r3f-component-plan/references/usegltf-caching-rules.md +53 -0
- package/skills/recipe-fit-assessor/EVAL.md +28 -0
- package/skills/recipe-fit-assessor/SKILL.md +266 -0
- package/skills/recipe-fit-assessor/contract.json +220 -0
- package/skills/recipe-fit-assessor/references/recipe-catalog.md +30 -0
- package/skills/recipe-fit-assessor/references/scope-gap-rules.md +27 -0
- package/skills/recipe-fit-assessor/references/workflow-recommendation-template.md +34 -0
- package/skills/render-export-evidence/EVAL.md +86 -0
- package/skills/render-export-evidence/SKILL.md +339 -0
- package/skills/render-export-evidence/contract.json +206 -0
- package/skills/render-export-evidence/references/attempted-vs-failed-rubric.md +75 -0
- package/skills/render-export-evidence/references/evidence-record-templates.md +143 -0
- package/skills/render-export-evidence/references/truth-label-decision-tree.md +57 -0
- package/skills/resolution-aspect-decision/EVAL.md +26 -0
- package/skills/resolution-aspect-decision/SKILL.md +246 -0
- package/skills/resolution-aspect-decision/contract.json +160 -0
- package/skills/resolution-aspect-decision/references/aspect-defaults.md +41 -0
- package/skills/resolution-aspect-decision/references/print-vs-screen-rules.md +58 -0
- package/skills/resolution-aspect-decision/references/resolution-defaults.md +64 -0
- package/skills/runtime-attempt-report/EVAL.md +26 -0
- package/skills/runtime-attempt-report/SKILL.md +268 -0
- package/skills/runtime-attempt-report/contract.json +176 -0
- package/skills/runtime-attempt-report/references/attempt-record-template.md +49 -0
- package/skills/runtime-attempt-report/references/triage-next-steps.md +15 -0
- package/skills/runtime-attempt-report/references/truth-label-blocks.md +27 -0
- package/skills/runtime-path-picker/EVAL.md +26 -0
- package/skills/runtime-path-picker/SKILL.md +268 -0
- package/skills/runtime-path-picker/contract.json +191 -0
- package/skills/runtime-path-picker/references/anti-patterns.md +14 -0
- package/skills/runtime-path-picker/references/decision-tree.md +29 -0
- package/skills/runtime-path-picker/references/path-constraints-table.md +18 -0
- package/skills/runtime-readiness/EVAL.md +33 -0
- package/skills/runtime-readiness/SKILL.md +218 -0
- package/skills/runtime-readiness/contract.json +190 -0
- package/skills/runtime-readiness/references/blocker-report-template.md +28 -0
- package/skills/runtime-readiness/references/evidence-examples.md +23 -0
- package/skills/runtime-readiness/references/readiness-matrix.md +46 -0
- package/skills/runtime-setup/EVAL.md +33 -0
- package/skills/runtime-setup/SKILL.md +209 -0
- package/skills/runtime-setup/contract.json +171 -0
- package/skills/runtime-setup/references/runtime-option-decision-tree.md +28 -0
- package/skills/runtime-setup/references/setup-summary-template.md +33 -0
- package/skills/runtime-setup/references/source-confidence-labels.md +23 -0
- package/skills/scene-readiness/EVAL.md +33 -0
- package/skills/scene-readiness/SKILL.md +195 -0
- package/skills/scene-readiness/contract.json +198 -0
- package/skills/scene-readiness/references/blocker-catalog.md +24 -0
- package/skills/scene-readiness/references/not-run-handling.md +22 -0
- package/skills/scene-readiness/references/quality-rubric.md +23 -0
- package/skills/scene-readiness/references/verdict-language.md +22 -0
- package/skills/scope-guard/EVAL.md +33 -0
- package/skills/scope-guard/SKILL.md +222 -0
- package/skills/scope-guard/contract.json +171 -0
- package/skills/scope-guard/references/options-language-template.md +51 -0
- package/skills/scope-guard/references/recurring-creep-patterns.md +55 -0
- package/skills/scope-guard/references/scope-addition-classification.md +55 -0
- package/skills/stage-gates/EVAL.md +40 -0
- package/skills/stage-gates/SKILL.md +257 -0
- package/skills/stage-gates/contract.json +490 -0
- package/skills/stage-gates/references/failed-gate-handling.md +42 -0
- package/skills/stage-gates/references/gate-template.md +46 -0
- package/skills/stage-gates/references/stage-decomposition-patterns.md +55 -0
- package/skills/workflow-stage-router/EVAL.md +25 -0
- package/skills/workflow-stage-router/SKILL.md +259 -0
- package/skills/workflow-stage-router/contract.json +150 -0
- package/skills/workflow-stage-router/references/milestone-model.md +20 -0
- package/skills/workflow-stage-router/references/routing-decision-tree.md +32 -0
- package/skills/workflow-stage-router/references/stage-handoff-template.md +37 -0
- package/skills.sh.json +102 -0
|
@@ -0,0 +1,490 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$schema": "../../schemas/skill-contract.schema.json",
|
|
3
|
+
"id": "stage-gates",
|
|
4
|
+
"version": "1.0.0",
|
|
5
|
+
"category": "process-discipline",
|
|
6
|
+
"role": "stage-gate-checklist-enforcer",
|
|
7
|
+
"purpose": "Define explicit per-stage gates and acceptance checklists before any modeling, render, or export work — work only proceeds gate by gate.",
|
|
8
|
+
"capabilityTier": "L0",
|
|
9
|
+
"triggers": [
|
|
10
|
+
"let's do this step by step",
|
|
11
|
+
"what's done before we move on",
|
|
12
|
+
"checklist for this work",
|
|
13
|
+
"I want to make sure each stage is solid"
|
|
14
|
+
],
|
|
15
|
+
"exclusions": [
|
|
16
|
+
{
|
|
17
|
+
"condition": "single-step requests",
|
|
18
|
+
"delegateTo": "blender-brainstorming",
|
|
19
|
+
"reason": "Delegates out-of-scope requests to blender-brainstorming"
|
|
20
|
+
},
|
|
21
|
+
{
|
|
22
|
+
"condition": "pure exploratory brainstorming",
|
|
23
|
+
"delegateTo": "blender-brainstorming",
|
|
24
|
+
"reason": "use blender-brainstorming"
|
|
25
|
+
},
|
|
26
|
+
{
|
|
27
|
+
"condition": "decomposing a brief into stages",
|
|
28
|
+
"delegateTo": "blender-recipe-decomposer",
|
|
29
|
+
"reason": "use blender-recipe-decomposer"
|
|
30
|
+
},
|
|
31
|
+
{
|
|
32
|
+
"condition": "writing measurable acceptance criteria rows from scratch",
|
|
33
|
+
"delegateTo": "acceptance-criteria-builder",
|
|
34
|
+
"reason": "use acceptance-criteria-builder"
|
|
35
|
+
},
|
|
36
|
+
{
|
|
37
|
+
"condition": "pinning the overall done/stop condition",
|
|
38
|
+
"delegateTo": "done-criteria",
|
|
39
|
+
"reason": "use done-criteria"
|
|
40
|
+
},
|
|
41
|
+
{
|
|
42
|
+
"condition": "guarding against mid-flight scope creep",
|
|
43
|
+
"delegateTo": "scope-guard",
|
|
44
|
+
"reason": "use scope-guard"
|
|
45
|
+
},
|
|
46
|
+
{
|
|
47
|
+
"condition": "selecting which skill runs next across the workflow",
|
|
48
|
+
"delegateTo": "workflow-stage-router",
|
|
49
|
+
"reason": "use workflow-stage-router"
|
|
50
|
+
},
|
|
51
|
+
{
|
|
52
|
+
"condition": "fixing repeated stage failures or broken renders",
|
|
53
|
+
"delegateTo": "blender-troubleshooting",
|
|
54
|
+
"reason": "use blender-troubleshooting"
|
|
55
|
+
},
|
|
56
|
+
{
|
|
57
|
+
"condition": "executing the final 7-point handoff gate",
|
|
58
|
+
"delegateTo": "pre-handoff-verification",
|
|
59
|
+
"reason": "use pre-handoff-verification"
|
|
60
|
+
}
|
|
61
|
+
],
|
|
62
|
+
"inputs": {
|
|
63
|
+
"required": [
|
|
64
|
+
{
|
|
65
|
+
"name": "active_workflow_stages",
|
|
66
|
+
"type": "array",
|
|
67
|
+
"description": "Ordered stages of the selected BlendOps recipe or custom workflow"
|
|
68
|
+
},
|
|
69
|
+
{
|
|
70
|
+
"name": "locked_acceptance_criteria",
|
|
71
|
+
"type": "object",
|
|
72
|
+
"description": "Measurable acceptance rows from acceptance-criteria-builder"
|
|
73
|
+
}
|
|
74
|
+
],
|
|
75
|
+
"optional": [
|
|
76
|
+
{
|
|
77
|
+
"name": "current_stage_status",
|
|
78
|
+
"type": "string",
|
|
79
|
+
"description": "Current stage progress and completed gate checks"
|
|
80
|
+
}
|
|
81
|
+
]
|
|
82
|
+
},
|
|
83
|
+
"outputs": {
|
|
84
|
+
"primary": [
|
|
85
|
+
"stage_gate_checklists",
|
|
86
|
+
"entry_and_exit_preconditions",
|
|
87
|
+
"gate_failure_routing_rules"
|
|
88
|
+
],
|
|
89
|
+
"truthStatePolicy": {
|
|
90
|
+
"runtimeDefault": "Not Run",
|
|
91
|
+
"artifactDefault": "Not Produced",
|
|
92
|
+
"mutationRule": "downgrade_only"
|
|
93
|
+
}
|
|
94
|
+
},
|
|
95
|
+
"handoffs": [
|
|
96
|
+
{
|
|
97
|
+
"target": "blender-brainstorming",
|
|
98
|
+
"type": "upstream_reference",
|
|
99
|
+
"label": "Brainstorming",
|
|
100
|
+
"when": {
|
|
101
|
+
"all": [
|
|
102
|
+
{
|
|
103
|
+
"field": "goal.clarity",
|
|
104
|
+
"operator": "equals",
|
|
105
|
+
"value": "ambiguous_or_mixed"
|
|
106
|
+
}
|
|
107
|
+
]
|
|
108
|
+
}
|
|
109
|
+
},
|
|
110
|
+
{
|
|
111
|
+
"target": "intent-to-3d-brief-writer",
|
|
112
|
+
"type": "upstream_reference",
|
|
113
|
+
"label": "Brief authoring",
|
|
114
|
+
"when": {
|
|
115
|
+
"all": [
|
|
116
|
+
{
|
|
117
|
+
"field": "goal.clarity",
|
|
118
|
+
"operator": "equals",
|
|
119
|
+
"value": "clear"
|
|
120
|
+
},
|
|
121
|
+
{
|
|
122
|
+
"field": "brief.locked",
|
|
123
|
+
"operator": "equals",
|
|
124
|
+
"value": false
|
|
125
|
+
}
|
|
126
|
+
]
|
|
127
|
+
}
|
|
128
|
+
},
|
|
129
|
+
{
|
|
130
|
+
"target": "blender-recipe-decomposer",
|
|
131
|
+
"type": "upstream_reference",
|
|
132
|
+
"label": "Recipe stage decomposition",
|
|
133
|
+
"when": {
|
|
134
|
+
"all": [
|
|
135
|
+
{
|
|
136
|
+
"field": "fit.multiDeliverableDetected",
|
|
137
|
+
"operator": "equals",
|
|
138
|
+
"value": true
|
|
139
|
+
}
|
|
140
|
+
]
|
|
141
|
+
}
|
|
142
|
+
},
|
|
143
|
+
{
|
|
144
|
+
"target": "acceptance-criteria-builder",
|
|
145
|
+
"type": "upstream_reference",
|
|
146
|
+
"label": "Measurable acceptance rows",
|
|
147
|
+
"when": {
|
|
148
|
+
"all": [
|
|
149
|
+
{
|
|
150
|
+
"field": "brief.locked",
|
|
151
|
+
"operator": "equals",
|
|
152
|
+
"value": true
|
|
153
|
+
},
|
|
154
|
+
{
|
|
155
|
+
"field": "stage.current",
|
|
156
|
+
"operator": "equals",
|
|
157
|
+
"value": "acceptance_criteria"
|
|
158
|
+
}
|
|
159
|
+
]
|
|
160
|
+
}
|
|
161
|
+
},
|
|
162
|
+
{
|
|
163
|
+
"target": "done-criteria",
|
|
164
|
+
"type": "upstream_reference",
|
|
165
|
+
"label": "Overall done condition",
|
|
166
|
+
"when": {
|
|
167
|
+
"all": [
|
|
168
|
+
{
|
|
169
|
+
"field": "brief.locked",
|
|
170
|
+
"operator": "equals",
|
|
171
|
+
"value": true
|
|
172
|
+
},
|
|
173
|
+
{
|
|
174
|
+
"field": "stage.current",
|
|
175
|
+
"operator": "equals",
|
|
176
|
+
"value": "stop_condition"
|
|
177
|
+
}
|
|
178
|
+
]
|
|
179
|
+
}
|
|
180
|
+
},
|
|
181
|
+
{
|
|
182
|
+
"target": "scope-guard",
|
|
183
|
+
"type": "progression",
|
|
184
|
+
"label": "Scope creep protection",
|
|
185
|
+
"when": {
|
|
186
|
+
"all": [
|
|
187
|
+
{
|
|
188
|
+
"field": "scope.driftDetected",
|
|
189
|
+
"operator": "equals",
|
|
190
|
+
"value": true
|
|
191
|
+
}
|
|
192
|
+
]
|
|
193
|
+
}
|
|
194
|
+
},
|
|
195
|
+
{
|
|
196
|
+
"target": "workflow-stage-router",
|
|
197
|
+
"type": "progression",
|
|
198
|
+
"label": "Next-skill routing across stages",
|
|
199
|
+
"when": {
|
|
200
|
+
"all": [
|
|
201
|
+
{
|
|
202
|
+
"field": "preflight.passed",
|
|
203
|
+
"operator": "equals",
|
|
204
|
+
"value": true
|
|
205
|
+
},
|
|
206
|
+
{
|
|
207
|
+
"field": "inventory.exists",
|
|
208
|
+
"operator": "equals",
|
|
209
|
+
"value": true
|
|
210
|
+
}
|
|
211
|
+
]
|
|
212
|
+
}
|
|
213
|
+
},
|
|
214
|
+
{
|
|
215
|
+
"target": "asset-discovery",
|
|
216
|
+
"type": "progression",
|
|
217
|
+
"label": "Asset discovery",
|
|
218
|
+
"when": {
|
|
219
|
+
"all": [
|
|
220
|
+
{
|
|
221
|
+
"field": "brief.locked",
|
|
222
|
+
"operator": "equals",
|
|
223
|
+
"value": true
|
|
224
|
+
},
|
|
225
|
+
{
|
|
226
|
+
"field": "assets.discoveryComplete",
|
|
227
|
+
"operator": "equals",
|
|
228
|
+
"value": false
|
|
229
|
+
}
|
|
230
|
+
]
|
|
231
|
+
}
|
|
232
|
+
},
|
|
233
|
+
{
|
|
234
|
+
"target": "camera-composition",
|
|
235
|
+
"type": "progression",
|
|
236
|
+
"label": "Scene planners (camera-composition)",
|
|
237
|
+
"when": {
|
|
238
|
+
"all": [
|
|
239
|
+
{
|
|
240
|
+
"field": "brief.locked",
|
|
241
|
+
"operator": "equals",
|
|
242
|
+
"value": true
|
|
243
|
+
},
|
|
244
|
+
{
|
|
245
|
+
"field": "stage.current",
|
|
246
|
+
"operator": "equals",
|
|
247
|
+
"value": "camera_planning"
|
|
248
|
+
}
|
|
249
|
+
]
|
|
250
|
+
}
|
|
251
|
+
},
|
|
252
|
+
{
|
|
253
|
+
"target": "lighting-material-plan",
|
|
254
|
+
"type": "progression",
|
|
255
|
+
"label": "Scene planners (lighting-material-plan)",
|
|
256
|
+
"when": {
|
|
257
|
+
"all": [
|
|
258
|
+
{
|
|
259
|
+
"field": "brief.locked",
|
|
260
|
+
"operator": "equals",
|
|
261
|
+
"value": true
|
|
262
|
+
},
|
|
263
|
+
{
|
|
264
|
+
"field": "stage.current",
|
|
265
|
+
"operator": "equals",
|
|
266
|
+
"value": "lookdev_planning"
|
|
267
|
+
}
|
|
268
|
+
]
|
|
269
|
+
}
|
|
270
|
+
},
|
|
271
|
+
{
|
|
272
|
+
"target": "character-portrait",
|
|
273
|
+
"type": "alternative",
|
|
274
|
+
"label": "Scene planners (character-portrait)",
|
|
275
|
+
"when": {
|
|
276
|
+
"all": [
|
|
277
|
+
{
|
|
278
|
+
"field": "brief.locked",
|
|
279
|
+
"operator": "equals",
|
|
280
|
+
"value": true
|
|
281
|
+
},
|
|
282
|
+
{
|
|
283
|
+
"field": "recipe.domain",
|
|
284
|
+
"operator": "equals",
|
|
285
|
+
"value": "character_portrait"
|
|
286
|
+
}
|
|
287
|
+
]
|
|
288
|
+
}
|
|
289
|
+
},
|
|
290
|
+
{
|
|
291
|
+
"target": "environment-shot",
|
|
292
|
+
"type": "alternative",
|
|
293
|
+
"label": "Scene planners (environment-shot)",
|
|
294
|
+
"when": {
|
|
295
|
+
"all": [
|
|
296
|
+
{
|
|
297
|
+
"field": "brief.locked",
|
|
298
|
+
"operator": "equals",
|
|
299
|
+
"value": true
|
|
300
|
+
},
|
|
301
|
+
{
|
|
302
|
+
"field": "recipe.domain",
|
|
303
|
+
"operator": "equals",
|
|
304
|
+
"value": "environment_shot"
|
|
305
|
+
}
|
|
306
|
+
]
|
|
307
|
+
}
|
|
308
|
+
},
|
|
309
|
+
{
|
|
310
|
+
"target": "interior-scene",
|
|
311
|
+
"type": "alternative",
|
|
312
|
+
"label": "Scene planners (interior-scene)",
|
|
313
|
+
"when": {
|
|
314
|
+
"all": [
|
|
315
|
+
{
|
|
316
|
+
"field": "brief.locked",
|
|
317
|
+
"operator": "equals",
|
|
318
|
+
"value": true
|
|
319
|
+
},
|
|
320
|
+
{
|
|
321
|
+
"field": "recipe.domain",
|
|
322
|
+
"operator": "equals",
|
|
323
|
+
"value": "interior_archviz"
|
|
324
|
+
}
|
|
325
|
+
]
|
|
326
|
+
}
|
|
327
|
+
},
|
|
328
|
+
{
|
|
329
|
+
"target": "product-grid-scene-planner",
|
|
330
|
+
"type": "alternative",
|
|
331
|
+
"label": "Scene planners (product-grid-scene-planner)",
|
|
332
|
+
"when": {
|
|
333
|
+
"all": [
|
|
334
|
+
{
|
|
335
|
+
"field": "brief.locked",
|
|
336
|
+
"operator": "equals",
|
|
337
|
+
"value": true
|
|
338
|
+
},
|
|
339
|
+
{
|
|
340
|
+
"field": "recipe.domain",
|
|
341
|
+
"operator": "equals",
|
|
342
|
+
"value": "product_grid"
|
|
343
|
+
}
|
|
344
|
+
]
|
|
345
|
+
}
|
|
346
|
+
},
|
|
347
|
+
{
|
|
348
|
+
"target": "product-hero-scene-planner",
|
|
349
|
+
"type": "alternative",
|
|
350
|
+
"label": "Scene planners (product-hero-scene-planner)",
|
|
351
|
+
"when": {
|
|
352
|
+
"all": [
|
|
353
|
+
{
|
|
354
|
+
"field": "brief.locked",
|
|
355
|
+
"operator": "equals",
|
|
356
|
+
"value": true
|
|
357
|
+
},
|
|
358
|
+
{
|
|
359
|
+
"field": "recipe.domain",
|
|
360
|
+
"operator": "equals",
|
|
361
|
+
"value": "product_hero"
|
|
362
|
+
}
|
|
363
|
+
]
|
|
364
|
+
}
|
|
365
|
+
},
|
|
366
|
+
{
|
|
367
|
+
"target": "scene-readiness",
|
|
368
|
+
"type": "progression",
|
|
369
|
+
"label": "Quality validators (scene-readiness)",
|
|
370
|
+
"when": {
|
|
371
|
+
"all": [
|
|
372
|
+
{
|
|
373
|
+
"field": "quality.domain",
|
|
374
|
+
"operator": "equals",
|
|
375
|
+
"value": "holistic"
|
|
376
|
+
},
|
|
377
|
+
{
|
|
378
|
+
"field": "stage.current",
|
|
379
|
+
"operator": "equals",
|
|
380
|
+
"value": "quality_validation"
|
|
381
|
+
}
|
|
382
|
+
]
|
|
383
|
+
}
|
|
384
|
+
},
|
|
385
|
+
{
|
|
386
|
+
"target": "composition-quality-checker",
|
|
387
|
+
"type": "progression",
|
|
388
|
+
"label": "Quality validators (composition-quality-checker)",
|
|
389
|
+
"when": {
|
|
390
|
+
"all": [
|
|
391
|
+
{
|
|
392
|
+
"field": "quality.domain",
|
|
393
|
+
"operator": "equals",
|
|
394
|
+
"value": "composition"
|
|
395
|
+
},
|
|
396
|
+
{
|
|
397
|
+
"field": "quality.verdict",
|
|
398
|
+
"operator": "equals",
|
|
399
|
+
"value": "not_run"
|
|
400
|
+
}
|
|
401
|
+
]
|
|
402
|
+
}
|
|
403
|
+
},
|
|
404
|
+
{
|
|
405
|
+
"target": "lighting-quality-checker",
|
|
406
|
+
"type": "progression",
|
|
407
|
+
"label": "Quality validators (lighting-quality-checker)",
|
|
408
|
+
"when": {
|
|
409
|
+
"all": [
|
|
410
|
+
{
|
|
411
|
+
"field": "quality.domain",
|
|
412
|
+
"operator": "equals",
|
|
413
|
+
"value": "lighting"
|
|
414
|
+
},
|
|
415
|
+
{
|
|
416
|
+
"field": "quality.verdict",
|
|
417
|
+
"operator": "equals",
|
|
418
|
+
"value": "not_run"
|
|
419
|
+
}
|
|
420
|
+
]
|
|
421
|
+
}
|
|
422
|
+
},
|
|
423
|
+
{
|
|
424
|
+
"target": "material-quality-checker",
|
|
425
|
+
"type": "progression",
|
|
426
|
+
"label": "Quality validators (material-quality-checker)",
|
|
427
|
+
"when": {
|
|
428
|
+
"all": [
|
|
429
|
+
{
|
|
430
|
+
"field": "quality.domain",
|
|
431
|
+
"operator": "equals",
|
|
432
|
+
"value": "material"
|
|
433
|
+
},
|
|
434
|
+
{
|
|
435
|
+
"field": "quality.verdict",
|
|
436
|
+
"operator": "equals",
|
|
437
|
+
"value": "not_run"
|
|
438
|
+
}
|
|
439
|
+
]
|
|
440
|
+
}
|
|
441
|
+
},
|
|
442
|
+
{
|
|
443
|
+
"target": "polycount-budget-checker",
|
|
444
|
+
"type": "progression",
|
|
445
|
+
"label": "Quality validators (polycount-budget-checker)",
|
|
446
|
+
"when": {
|
|
447
|
+
"all": [
|
|
448
|
+
{
|
|
449
|
+
"field": "quality.domain",
|
|
450
|
+
"operator": "equals",
|
|
451
|
+
"value": "polycount"
|
|
452
|
+
},
|
|
453
|
+
{
|
|
454
|
+
"field": "budget.verdict",
|
|
455
|
+
"operator": "equals",
|
|
456
|
+
"value": "Not Run"
|
|
457
|
+
}
|
|
458
|
+
]
|
|
459
|
+
}
|
|
460
|
+
},
|
|
461
|
+
{
|
|
462
|
+
"target": "blender-troubleshooting",
|
|
463
|
+
"type": "fallback",
|
|
464
|
+
"label": "Repeated gate failures",
|
|
465
|
+
"when": {
|
|
466
|
+
"all": [
|
|
467
|
+
{
|
|
468
|
+
"field": "runtime.errorDetected",
|
|
469
|
+
"operator": "equals",
|
|
470
|
+
"value": true
|
|
471
|
+
}
|
|
472
|
+
]
|
|
473
|
+
}
|
|
474
|
+
},
|
|
475
|
+
{
|
|
476
|
+
"target": "pre-handoff-verification",
|
|
477
|
+
"type": "progression",
|
|
478
|
+
"label": "Final 7-point gate",
|
|
479
|
+
"when": {
|
|
480
|
+
"all": [
|
|
481
|
+
{
|
|
482
|
+
"field": "stage.current",
|
|
483
|
+
"operator": "equals",
|
|
484
|
+
"value": "final_verification"
|
|
485
|
+
}
|
|
486
|
+
]
|
|
487
|
+
}
|
|
488
|
+
}
|
|
489
|
+
]
|
|
490
|
+
}
|
|
@@ -0,0 +1,42 @@
|
|
|
1
|
+
# Failed-gate handling
|
|
2
|
+
|
|
3
|
+
A failed gate is a feature, not a bug. It catches drift before it compounds.
|
|
4
|
+
|
|
5
|
+
## Standard response to `Fail`
|
|
6
|
+
|
|
7
|
+
1. Stop work on subsequent stages.
|
|
8
|
+
2. Mark all subsequent stages `Blocked`.
|
|
9
|
+
3. Hand off to `blender-troubleshooting` for root-cause analysis.
|
|
10
|
+
4. Resolve the failure (re-do current stage or change scope).
|
|
11
|
+
5. Re-run the gate; only after `Pass` proceed.
|
|
12
|
+
|
|
13
|
+
## Common failure types
|
|
14
|
+
|
|
15
|
+
| Failure type | Cause | Response |
|
|
16
|
+
|---|---|---|
|
|
17
|
+
| Missing artifact | Render / export did not run or failed | Re-run with verified inputs; capture error |
|
|
18
|
+
| Wrong dimensions / format | Scene config mismatch | Adjust scene render settings; re-run |
|
|
19
|
+
| Below quality threshold (samples, validation) | Speed-vs-quality compromise | Decide: accept lower quality with explicit caveat OR re-run with higher settings |
|
|
20
|
+
| Out-of-budget | Triangle / texture / file size | Hand off to budget skill; degrade per `mobile-glb-budget` rules |
|
|
21
|
+
| Mood / vision mismatch | Brief or plan diverged | Re-confirm brief; replan scene |
|
|
22
|
+
| User changes scope mid-run | Scope creep | Hand off to `scope-guard` |
|
|
23
|
+
|
|
24
|
+
## What NOT to do
|
|
25
|
+
|
|
26
|
+
- Skip the failed gate and continue.
|
|
27
|
+
- Mark `Pass` "for now" with a TODO to fix later.
|
|
28
|
+
- Ignore minor failures (they compound).
|
|
29
|
+
- Run more stages hoping the failure resolves itself.
|
|
30
|
+
|
|
31
|
+
## When to abandon a recipe
|
|
32
|
+
|
|
33
|
+
After 3+ failed gates on the same stage, consider:
|
|
34
|
+
- Is the stage criteria too strict?
|
|
35
|
+
- Has the brief drifted?
|
|
36
|
+
- Is the runtime path the wrong choice?
|
|
37
|
+
- Does this recipe need a rewrite?
|
|
38
|
+
|
|
39
|
+
Document the abandonment with the failed gates as evidence; do not pretend the work succeeded.
|
|
40
|
+
|
|
41
|
+
## Related skill
|
|
42
|
+
`../SKILL.md`
|
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
# Gate template
|
|
2
|
+
|
|
3
|
+
## Per-stage gate format
|
|
4
|
+
|
|
5
|
+
Every gate has 4 fields:
|
|
6
|
+
|
|
7
|
+
1. **Acceptance criteria** (3-5 concrete checks). NOT vague feelings.
|
|
8
|
+
2. **Evidence required**: file path / measurement / produced artifact.
|
|
9
|
+
3. **Current state**: `Pending` / `Pass` / `Fail` / `Blocked`.
|
|
10
|
+
4. **Failed-gate action**: what happens if this gate fails.
|
|
11
|
+
|
|
12
|
+
## Concrete criteria examples
|
|
13
|
+
|
|
14
|
+
### Stage: scene plan
|
|
15
|
+
- [ ] Scene plan section count >= 7 (subject, camera, lighting, materials, background, mood, asset list).
|
|
16
|
+
- [ ] Each section has explicit value (no "TBD").
|
|
17
|
+
- [ ] Asset list flagged for discovery.
|
|
18
|
+
- [ ] No runtime claim made.
|
|
19
|
+
|
|
20
|
+
### Stage: render
|
|
21
|
+
- [ ] `out/render-YYYY-MM-DD.png` exists.
|
|
22
|
+
- [ ] Dimensions match scene aspect (e.g. 1920×1080 for 16:9).
|
|
23
|
+
- [ ] Samples >= 128 (Cycles) or no banding artifacts (Eevee).
|
|
24
|
+
- [ ] Render time logged.
|
|
25
|
+
- [ ] No missing-texture error in render log.
|
|
26
|
+
|
|
27
|
+
### Stage: export
|
|
28
|
+
- [ ] `out/scene.glb` exists.
|
|
29
|
+
- [ ] File size within budget.
|
|
30
|
+
- [ ] `gltf-validator` passes.
|
|
31
|
+
- [ ] Triangle count within budget.
|
|
32
|
+
|
|
33
|
+
## Vague criteria to avoid
|
|
34
|
+
|
|
35
|
+
- "Looks good"
|
|
36
|
+
- "Acceptable"
|
|
37
|
+
- "Solid"
|
|
38
|
+
- "On the right track"
|
|
39
|
+
- "We'll know when we see it"
|
|
40
|
+
|
|
41
|
+
## Why concrete matters
|
|
42
|
+
|
|
43
|
+
A vague gate creates the illusion of progress without verification. Re-reading "looks good" later gives no information about whether the stage actually completed correctly. Concrete criteria allow honest re-evaluation.
|
|
44
|
+
|
|
45
|
+
## Related skill
|
|
46
|
+
`../SKILL.md`
|
|
@@ -0,0 +1,55 @@
|
|
|
1
|
+
# Stage decomposition patterns
|
|
2
|
+
|
|
3
|
+
## Standard 7-stage recipe (default for Blender hero work)
|
|
4
|
+
|
|
5
|
+
1. Brief (intent → 3D brief via `intent-to-3d-brief-writer`)
|
|
6
|
+
2. Scene plan (via domain scene planner)
|
|
7
|
+
3. Asset discovery (via `asset-discovery`)
|
|
8
|
+
4. Scene build (modeling / lookdev — runtime work)
|
|
9
|
+
5. Render (via `render-export-evidence` capture)
|
|
10
|
+
6. Export (GLB or PNG export — runtime work)
|
|
11
|
+
7. Handoff (via `glb-web-handoff` + `plain-language-response`)
|
|
12
|
+
|
|
13
|
+
## 5-stage recipe (multi-product grid)
|
|
14
|
+
|
|
15
|
+
1. Brief
|
|
16
|
+
2. Grid plan (via `product-grid-scene-planner`)
|
|
17
|
+
3. Consistency setup (camera + lighting locked)
|
|
18
|
+
4. Render
|
|
19
|
+
5. Export
|
|
20
|
+
|
|
21
|
+
## 6-stage recipe (character portrait)
|
|
22
|
+
|
|
23
|
+
1. Brief
|
|
24
|
+
2. Portrait plan (via `character-portrait`)
|
|
25
|
+
3. Asset discovery
|
|
26
|
+
4. Lookdev (materials + lighting test)
|
|
27
|
+
5. Render
|
|
28
|
+
6. Handoff
|
|
29
|
+
|
|
30
|
+
## 4-stage recipe (text-only planning, no runtime)
|
|
31
|
+
|
|
32
|
+
1. Brief
|
|
33
|
+
2. Scene plan
|
|
34
|
+
3. Quality validation (text-only via checkers)
|
|
35
|
+
4. Plan handoff
|
|
36
|
+
|
|
37
|
+
## When to add stages
|
|
38
|
+
|
|
39
|
+
- If two sub-stages have very different acceptance criteria → split.
|
|
40
|
+
- If user wants explicit approval point in the middle → add a review stage.
|
|
41
|
+
- If parallel work happens (e.g., asset discovery + scene plan in parallel) → still gate each separately.
|
|
42
|
+
|
|
43
|
+
## When to merge stages
|
|
44
|
+
|
|
45
|
+
- If two stages share the same gate criteria → merge.
|
|
46
|
+
- If a stage is too small to gate meaningfully → fold into adjacent.
|
|
47
|
+
|
|
48
|
+
## Avoid
|
|
49
|
+
|
|
50
|
+
- More than 9 stages (gate fatigue; user disengages).
|
|
51
|
+
- Less than 4 stages for non-trivial work (gates lose value).
|
|
52
|
+
- Stages not aligned to a real handoff (synthetic stages just to add gates).
|
|
53
|
+
|
|
54
|
+
## Related skill
|
|
55
|
+
`../SKILL.md`
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
# EVAL — workflow-stage-router
|
|
2
|
+
|
|
3
|
+
## Text-only eval prompt
|
|
4
|
+
|
|
5
|
+
User has locked brief + composition plan text, no renders, no GLB, wants to proceed to lighting. Route next skill.
|
|
6
|
+
|
|
7
|
+
## Expected behavior
|
|
8
|
+
|
|
9
|
+
- Stage = planning / lookdev boundary
|
|
10
|
+
- Next = `lighting-material-plan` after confirming composition plan consumed
|
|
11
|
+
- Note readiness if runtime mutation next
|
|
12
|
+
|
|
13
|
+
## Pass / Warn / Fail criteria
|
|
14
|
+
|
|
15
|
+
- Pass: one primary next skill + preconditions
|
|
16
|
+
- Warn: parallel optional validators listed as secondary
|
|
17
|
+
- Fail: jumps to export evidence without render plan
|
|
18
|
+
|
|
19
|
+
## Sample passing response outline
|
|
20
|
+
|
|
21
|
+
- Stage + next + 3 preconditions
|
|
22
|
+
|
|
23
|
+
## Sample failing response outline
|
|
24
|
+
|
|
25
|
+
- "Start rendering now" with no engine decision
|