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,171 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$schema": "../../schemas/skill-contract.schema.json",
|
|
3
|
+
"id": "scope-guard",
|
|
4
|
+
"version": "1.0.0",
|
|
5
|
+
"category": "process-discipline",
|
|
6
|
+
"role": "scope-creep-and-change-request-guard",
|
|
7
|
+
"purpose": "Detect mid-recipe scope creep and push back constructively before the recipe drifts; require explicit user agreement before scope expansion.",
|
|
8
|
+
"capabilityTier": "L0",
|
|
9
|
+
"triggers": [
|
|
10
|
+
"can you also",
|
|
11
|
+
"while you're at it",
|
|
12
|
+
"actually let's also",
|
|
13
|
+
"one more thing"
|
|
14
|
+
],
|
|
15
|
+
"exclusions": [
|
|
16
|
+
{
|
|
17
|
+
"condition": "early planning before scope is pinned",
|
|
18
|
+
"delegateTo": "done-criteria",
|
|
19
|
+
"reason": "use intent-to-3d-brief-writer and done-criteria"
|
|
20
|
+
},
|
|
21
|
+
{
|
|
22
|
+
"condition": "pure brainstorming with no active recipe",
|
|
23
|
+
"delegateTo": "blender-brainstorming",
|
|
24
|
+
"reason": "use blender-brainstorming"
|
|
25
|
+
},
|
|
26
|
+
{
|
|
27
|
+
"condition": "when the addition is already explicitly covered by existing gate criteria in stage-gates / acceptance-criteria-builder (verified against w",
|
|
28
|
+
"delegateTo": "acceptance-criteria-builder",
|
|
29
|
+
"reason": "verified against written criteria, never judged by feel"
|
|
30
|
+
}
|
|
31
|
+
],
|
|
32
|
+
"inputs": {
|
|
33
|
+
"required": [
|
|
34
|
+
{
|
|
35
|
+
"name": "locked_baseline_brief",
|
|
36
|
+
"type": "object",
|
|
37
|
+
"description": "Currently locked 3D brief, acceptance criteria, and stop conditions"
|
|
38
|
+
},
|
|
39
|
+
{
|
|
40
|
+
"name": "proposed_scope_change",
|
|
41
|
+
"type": "string",
|
|
42
|
+
"description": "Mid-workflow user request adding new deliverables, environments, animations, or scope"
|
|
43
|
+
}
|
|
44
|
+
],
|
|
45
|
+
"optional": [
|
|
46
|
+
{
|
|
47
|
+
"name": "current_workflow_stage",
|
|
48
|
+
"type": "string",
|
|
49
|
+
"description": "Active stage when the scope expansion was requested"
|
|
50
|
+
}
|
|
51
|
+
]
|
|
52
|
+
},
|
|
53
|
+
"outputs": {
|
|
54
|
+
"primary": [
|
|
55
|
+
"scope_classification_verdict",
|
|
56
|
+
"impact_on_locked_brief_and_budget",
|
|
57
|
+
"defer_split_or_reopen_decision"
|
|
58
|
+
],
|
|
59
|
+
"truthStatePolicy": {
|
|
60
|
+
"runtimeDefault": "Not Run",
|
|
61
|
+
"artifactDefault": "Not Produced",
|
|
62
|
+
"mutationRule": "downgrade_only"
|
|
63
|
+
}
|
|
64
|
+
},
|
|
65
|
+
"handoffs": [
|
|
66
|
+
{
|
|
67
|
+
"target": "intent-to-3d-brief-writer",
|
|
68
|
+
"type": "upstream_reference",
|
|
69
|
+
"label": "Original brief",
|
|
70
|
+
"when": {
|
|
71
|
+
"all": [
|
|
72
|
+
{
|
|
73
|
+
"field": "goal.clarity",
|
|
74
|
+
"operator": "equals",
|
|
75
|
+
"value": "clear"
|
|
76
|
+
},
|
|
77
|
+
{
|
|
78
|
+
"field": "brief.locked",
|
|
79
|
+
"operator": "equals",
|
|
80
|
+
"value": false
|
|
81
|
+
}
|
|
82
|
+
]
|
|
83
|
+
}
|
|
84
|
+
},
|
|
85
|
+
{
|
|
86
|
+
"target": "done-criteria",
|
|
87
|
+
"type": "upstream_reference",
|
|
88
|
+
"label": "Stop condition pinned beforehand / updated on expansion",
|
|
89
|
+
"when": {
|
|
90
|
+
"all": [
|
|
91
|
+
{
|
|
92
|
+
"field": "brief.locked",
|
|
93
|
+
"operator": "equals",
|
|
94
|
+
"value": true
|
|
95
|
+
},
|
|
96
|
+
{
|
|
97
|
+
"field": "stage.current",
|
|
98
|
+
"operator": "equals",
|
|
99
|
+
"value": "stop_condition"
|
|
100
|
+
}
|
|
101
|
+
]
|
|
102
|
+
}
|
|
103
|
+
},
|
|
104
|
+
{
|
|
105
|
+
"target": "stage-gates",
|
|
106
|
+
"type": "upstream_reference",
|
|
107
|
+
"label": "Per-stage gates enforced / updated on expansion",
|
|
108
|
+
"when": {
|
|
109
|
+
"all": [
|
|
110
|
+
{
|
|
111
|
+
"field": "brief.locked",
|
|
112
|
+
"operator": "equals",
|
|
113
|
+
"value": true
|
|
114
|
+
},
|
|
115
|
+
{
|
|
116
|
+
"field": "stage.current",
|
|
117
|
+
"operator": "equals",
|
|
118
|
+
"value": "stage_gates"
|
|
119
|
+
}
|
|
120
|
+
]
|
|
121
|
+
}
|
|
122
|
+
},
|
|
123
|
+
{
|
|
124
|
+
"target": "acceptance-criteria-builder",
|
|
125
|
+
"type": "boundary_delegation",
|
|
126
|
+
"label": "Measurable acceptance rows for added scope",
|
|
127
|
+
"when": {
|
|
128
|
+
"all": [
|
|
129
|
+
{
|
|
130
|
+
"field": "brief.locked",
|
|
131
|
+
"operator": "equals",
|
|
132
|
+
"value": true
|
|
133
|
+
},
|
|
134
|
+
{
|
|
135
|
+
"field": "stage.current",
|
|
136
|
+
"operator": "equals",
|
|
137
|
+
"value": "acceptance_criteria"
|
|
138
|
+
}
|
|
139
|
+
]
|
|
140
|
+
}
|
|
141
|
+
},
|
|
142
|
+
{
|
|
143
|
+
"target": "blender-recipe-decomposer",
|
|
144
|
+
"type": "boundary_delegation",
|
|
145
|
+
"label": "Deferred scope split into follow-up recipes",
|
|
146
|
+
"when": {
|
|
147
|
+
"all": [
|
|
148
|
+
{
|
|
149
|
+
"field": "fit.multiDeliverableDetected",
|
|
150
|
+
"operator": "equals",
|
|
151
|
+
"value": true
|
|
152
|
+
}
|
|
153
|
+
]
|
|
154
|
+
}
|
|
155
|
+
},
|
|
156
|
+
{
|
|
157
|
+
"target": "pre-handoff-verification",
|
|
158
|
+
"type": "progression",
|
|
159
|
+
"label": "Delivery gate after scope and gates settle",
|
|
160
|
+
"when": {
|
|
161
|
+
"all": [
|
|
162
|
+
{
|
|
163
|
+
"field": "stage.current",
|
|
164
|
+
"operator": "equals",
|
|
165
|
+
"value": "final_verification"
|
|
166
|
+
}
|
|
167
|
+
]
|
|
168
|
+
}
|
|
169
|
+
}
|
|
170
|
+
]
|
|
171
|
+
}
|
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
# Options-language template
|
|
2
|
+
|
|
3
|
+
## The 3 options (always offer all three)
|
|
4
|
+
|
|
5
|
+
### 1. Decline
|
|
6
|
+
|
|
7
|
+
"Proceed with original scope."
|
|
8
|
+
|
|
9
|
+
When to recommend:
|
|
10
|
+
- Addition contradicts the brief.
|
|
11
|
+
- Time / budget exhausted.
|
|
12
|
+
- The user is in evaluation mode, not commitment mode.
|
|
13
|
+
|
|
14
|
+
### 2. Add now (with agreement)
|
|
15
|
+
|
|
16
|
+
"Agree to new scope: <updated stop condition>. Cost: <time / gate / budget>."
|
|
17
|
+
|
|
18
|
+
When to recommend:
|
|
19
|
+
- Addition is small or medium AND fits the same recipe semantically.
|
|
20
|
+
- Time budget allows.
|
|
21
|
+
- The addition strengthens the original deliverable rather than diluting it.
|
|
22
|
+
|
|
23
|
+
### 3. Defer
|
|
24
|
+
|
|
25
|
+
"Track as follow-up recipe (no current scope change)."
|
|
26
|
+
|
|
27
|
+
When to recommend:
|
|
28
|
+
- Addition is large or new modality.
|
|
29
|
+
- Brief already locked.
|
|
30
|
+
- Adding now would multiply gates beyond manageability.
|
|
31
|
+
- Deferral is almost always safer than absorption.
|
|
32
|
+
|
|
33
|
+
## Phrasing tips
|
|
34
|
+
|
|
35
|
+
- Always show all three options, even if recommending one.
|
|
36
|
+
- State the **cost** of "add now" explicitly (time, gates, budget).
|
|
37
|
+
- State the **followup-recipe-name** for "defer" (helps the user track it).
|
|
38
|
+
- Use neutral language; do not push the user toward your preference.
|
|
39
|
+
|
|
40
|
+
## Decision evidence
|
|
41
|
+
|
|
42
|
+
When the user picks an option, record it:
|
|
43
|
+
- Picked option (1 / 2 / 3)
|
|
44
|
+
- Time of agreement
|
|
45
|
+
- Updated stop condition (if option 2)
|
|
46
|
+
- Follow-up recipe name (if option 3)
|
|
47
|
+
|
|
48
|
+
This serves as evidence per `evidence-before-done.md` for the scope state.
|
|
49
|
+
|
|
50
|
+
## Related skill
|
|
51
|
+
`../SKILL.md`
|
|
@@ -0,0 +1,55 @@
|
|
|
1
|
+
# Recurring creep patterns
|
|
2
|
+
|
|
3
|
+
When the same user repeatedly drives scope creep, the pattern itself is the issue. Catch it.
|
|
4
|
+
|
|
5
|
+
## Common patterns
|
|
6
|
+
|
|
7
|
+
### Pattern A: "Just one more thing"
|
|
8
|
+
- 3+ small additions in one recipe.
|
|
9
|
+
- Each individually trivial; together they double scope.
|
|
10
|
+
- Response: pause and propose a follow-up recipe to bundle the additions.
|
|
11
|
+
|
|
12
|
+
### Pattern B: Late-stage feature requests
|
|
13
|
+
- User adds substantive features after the render gate has run.
|
|
14
|
+
- Response: hold the line; defer to follow-up. Re-running gates with new scope is expensive.
|
|
15
|
+
|
|
16
|
+
### Pattern C: Scope grows under deadline pressure
|
|
17
|
+
- "We're already running this, can we squeeze in X?"
|
|
18
|
+
- Response: explicit cost language; let the user weigh deadline vs scope.
|
|
19
|
+
|
|
20
|
+
### Pattern D: Brief revision masquerading as addition
|
|
21
|
+
- "Actually let's also flip the brand to Y" mid-recipe.
|
|
22
|
+
- This is a brief revision, not a scope addition. Pause; revise brief; restart relevant stages.
|
|
23
|
+
|
|
24
|
+
### Pattern E: Polish creep
|
|
25
|
+
- "Looks great, but can we tweak X for the tenth time?"
|
|
26
|
+
- Stop condition has been met. Revisit with `done-criteria`.
|
|
27
|
+
|
|
28
|
+
## Why catch the pattern
|
|
29
|
+
|
|
30
|
+
A single addition is trivial. A repeated pattern compounds:
|
|
31
|
+
- Gates lose meaning.
|
|
32
|
+
- Stop condition drifts.
|
|
33
|
+
- Time multiplies.
|
|
34
|
+
- Recipe quality degrades.
|
|
35
|
+
|
|
36
|
+
## Response per pattern
|
|
37
|
+
|
|
38
|
+
| Pattern | Suggested response |
|
|
39
|
+
|---|---|
|
|
40
|
+
| A — "just one more" | Pause; propose follow-up recipe to bundle |
|
|
41
|
+
| B — late-stage requests | Hold gate; defer |
|
|
42
|
+
| C — deadline pressure | Cost-explicit options |
|
|
43
|
+
| D — brief revision | Reset brief; restart relevant stages |
|
|
44
|
+
| E — polish creep | Reaffirm stop condition |
|
|
45
|
+
|
|
46
|
+
## When to escalate
|
|
47
|
+
|
|
48
|
+
If patterns A-E repeat across multiple recipes, propose a process retro:
|
|
49
|
+
- Are briefs scoped tightly enough?
|
|
50
|
+
- Are stop conditions concrete enough?
|
|
51
|
+
- Is the recipe size right?
|
|
52
|
+
- Is the user actually exploring rather than committing?
|
|
53
|
+
|
|
54
|
+
## Related skill
|
|
55
|
+
`../SKILL.md`
|
|
@@ -0,0 +1,55 @@
|
|
|
1
|
+
# Scope addition classification
|
|
2
|
+
|
|
3
|
+
## Classification table
|
|
4
|
+
|
|
5
|
+
| Class | Indicator | Recommendation |
|
|
6
|
+
|---|---|---|
|
|
7
|
+
| Trivial | Within current gate; <5% extra effort | Mention, may absorb |
|
|
8
|
+
| Small | 5-15% extra effort; one new gate or tweak | Offer 3 options; lean accept |
|
|
9
|
+
| Medium | 15-30% extra; new sub-stage; new asset | Offer 3 options; balanced |
|
|
10
|
+
| Large | >30% extra; new modality (animation, multi-render); new render path | Recommend defer |
|
|
11
|
+
| Brief-contradicting | Conflicts with original brief | Pause; revise brief first |
|
|
12
|
+
|
|
13
|
+
## Effort estimates
|
|
14
|
+
|
|
15
|
+
Time is the cleanest signal. Estimate:
|
|
16
|
+
- Original recipe time
|
|
17
|
+
- Addition's marginal time
|
|
18
|
+
- New total
|
|
19
|
+
|
|
20
|
+
If new total > 1.5× original → Medium or Large.
|
|
21
|
+
If addition adds new render queue items → at least Medium.
|
|
22
|
+
If addition needs new asset sourcing → at least Medium.
|
|
23
|
+
|
|
24
|
+
## Examples per class
|
|
25
|
+
|
|
26
|
+
### Trivial
|
|
27
|
+
- Slight color tweak in existing material
|
|
28
|
+
- Adjusted camera distance by 10cm
|
|
29
|
+
- Renamed output file
|
|
30
|
+
|
|
31
|
+
### Small
|
|
32
|
+
- Add one extra prop in scene
|
|
33
|
+
- Render one extra frame
|
|
34
|
+
- Slightly stricter samples count
|
|
35
|
+
|
|
36
|
+
### Medium
|
|
37
|
+
- Add second camera angle of same scene
|
|
38
|
+
- Add one variant of a material
|
|
39
|
+
- Add HDRI swap render
|
|
40
|
+
|
|
41
|
+
### Large
|
|
42
|
+
- Add 4 product variants
|
|
43
|
+
- Add animation
|
|
44
|
+
- Add interior environment to product hero scene
|
|
45
|
+
- Add 4K version
|
|
46
|
+
|
|
47
|
+
### Brief-contradicting
|
|
48
|
+
- "Make it look more like X" where X is incompatible with the existing mood/style locked in brief
|
|
49
|
+
|
|
50
|
+
## Why classify
|
|
51
|
+
|
|
52
|
+
The class drives recommendation. Without classification, every addition risks being silently absorbed.
|
|
53
|
+
|
|
54
|
+
## Related skill
|
|
55
|
+
`../SKILL.md`
|
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
# EVAL — stage-gates
|
|
2
|
+
|
|
3
|
+
## Text-only eval prompt
|
|
4
|
+
Use stage-gates on the cyberpunk shoe hero recipe (7 stages).
|
|
5
|
+
|
|
6
|
+
## Expected behavior
|
|
7
|
+
- 7 stages listed in linear order
|
|
8
|
+
- Per-stage gate with 3-5 concrete acceptance criteria
|
|
9
|
+
- Evidence required per gate explicit
|
|
10
|
+
- Per-stage handoff to domain skill
|
|
11
|
+
- Current state explicit (`Pending` since text-only)
|
|
12
|
+
- "Failed gate stops work" rule stated
|
|
13
|
+
- Final handoff to pre-handoff-verification
|
|
14
|
+
|
|
15
|
+
## Pass / Warn / Fail criteria
|
|
16
|
+
- Pass: 7 stages + concrete gates + evidence required + handoff per stage + final pre-handoff named
|
|
17
|
+
- Warn: one gate vague, one stage missing evidence row
|
|
18
|
+
- Fail: vague gates throughout, skipped stages, parallel stages without justification
|
|
19
|
+
|
|
20
|
+
## Common failure modes
|
|
21
|
+
- "Stage looks good" gates
|
|
22
|
+
- Inventing criteria at gate time
|
|
23
|
+
- Marking Pass without evidence
|
|
24
|
+
- Skipping the final pre-handoff handoff
|
|
25
|
+
|
|
26
|
+
## Evidence expectations
|
|
27
|
+
- per-stage row with concrete checks
|
|
28
|
+
- per-stage handoff named
|
|
29
|
+
- failed-gate action stated
|
|
30
|
+
|
|
31
|
+
## Sample passing response outline
|
|
32
|
+
- Recipe header
|
|
33
|
+
- 7-row stage table
|
|
34
|
+
- Failed gate action
|
|
35
|
+
- Final handoff to pre-handoff-verification
|
|
36
|
+
|
|
37
|
+
## Sample failing response outline
|
|
38
|
+
- Vague "checklist" without per-stage rows
|
|
39
|
+
- "Looks good" gates
|
|
40
|
+
- No final handoff
|
|
@@ -0,0 +1,257 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: stage-gates
|
|
3
|
+
description: Define explicit per-stage gates and acceptance checklists before any modeling, render, or export work — work only proceeds gate by gate.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# stage-gates
|
|
7
|
+
|
|
8
|
+
## Purpose
|
|
9
|
+
Enforce a checklist-driven discipline where every stage of a Blender recipe (brief → asset → scene → render → export → handoff) has a written acceptance gate. Work does not advance until the previous stage's gate is checked off. Inspired by Anthropic Superpowers `/test-driven-development` analog: gate first, work second.
|
|
10
|
+
|
|
11
|
+
## Quick start
|
|
12
|
+
- list the stages of the user's recipe
|
|
13
|
+
- write the gate per stage (specific, checkable conditions)
|
|
14
|
+
- run the gate after each stage; do not proceed if it fails
|
|
15
|
+
- record the gate result + evidence per stage
|
|
16
|
+
|
|
17
|
+
## When to use
|
|
18
|
+
- complex multi-stage recipe (4+ distinct stages) requiring per-stage gate enforcement
|
|
19
|
+
- when work must be locked behind explicit `Pending | Pass | Fail | Blocked` stage gates before advancing
|
|
20
|
+
- when the user wants verifiable proof that each stage passes its checks before starting the next stage
|
|
21
|
+
- before any runtime work begins, to lock concrete checks, required evidence, and failure exits per stage
|
|
22
|
+
|
|
23
|
+
## When not to use
|
|
24
|
+
<!-- blendops:generated:start exclusions -->
|
|
25
|
+
- single-step requests → use `../blender-brainstorming/SKILL.md` (Delegates out-of-scope requests to blender-brainstorming)
|
|
26
|
+
- pure exploratory brainstorming → use `../blender-brainstorming/SKILL.md` (use blender-brainstorming)
|
|
27
|
+
- decomposing a brief into stages → use `../blender-recipe-decomposer/SKILL.md` (use blender-recipe-decomposer)
|
|
28
|
+
- writing measurable acceptance criteria rows from scratch → use `../acceptance-criteria-builder/SKILL.md` (use acceptance-criteria-builder)
|
|
29
|
+
- pinning the overall done/stop condition → use `../done-criteria/SKILL.md` (use done-criteria)
|
|
30
|
+
- guarding against mid-flight scope creep → use `../scope-guard/SKILL.md` (use scope-guard)
|
|
31
|
+
- selecting which skill runs next across the workflow → use `../workflow-stage-router/SKILL.md` (use workflow-stage-router)
|
|
32
|
+
- fixing repeated stage failures or broken renders → use `../blender-troubleshooting/SKILL.md` (use blender-troubleshooting)
|
|
33
|
+
- executing the final 7-point handoff gate → use `../pre-handoff-verification/SKILL.md` (use pre-handoff-verification)
|
|
34
|
+
<!-- blendops:generated:end exclusions -->
|
|
35
|
+
|
|
36
|
+
## Trigger phrases
|
|
37
|
+
<!-- blendops:generated:start triggers -->
|
|
38
|
+
- "let's do this step by step"
|
|
39
|
+
- "what's done before we move on"
|
|
40
|
+
- "checklist for this work"
|
|
41
|
+
- "I want to make sure each stage is solid"
|
|
42
|
+
<!-- blendops:generated:end triggers -->
|
|
43
|
+
|
|
44
|
+
## Prerequisites / readiness
|
|
45
|
+
- recipe stages identified (or willing to identify them)
|
|
46
|
+
- user accepts gate-driven discipline (not all do)
|
|
47
|
+
|
|
48
|
+
## Input schema
|
|
49
|
+
|
|
50
|
+
### Required inputs
|
|
51
|
+
|
|
52
|
+
| Input | Why it is required |
|
|
53
|
+
|---|---|
|
|
54
|
+
| Recipe stages | Defines gate count |
|
|
55
|
+
| Acceptance criteria per stage | Drives gate content |
|
|
56
|
+
| Mode (text-only / runtime-ready) | Determines what gates can verify |
|
|
57
|
+
|
|
58
|
+
### Optional inputs
|
|
59
|
+
|
|
60
|
+
| Input | Use |
|
|
61
|
+
|---|---|
|
|
62
|
+
| Reference images / specs | Drives stage-specific acceptance |
|
|
63
|
+
| Time budget | Allows gate prioritization |
|
|
64
|
+
|
|
65
|
+
### Assumptions to confirm
|
|
66
|
+
- The user agrees not to skip gates.
|
|
67
|
+
- "Acceptance criteria" are pre-agreed, not invented at gate time.
|
|
68
|
+
- A failing gate stops work until resolved.
|
|
69
|
+
|
|
70
|
+
## Output schema
|
|
71
|
+
|
|
72
|
+
### Primary output
|
|
73
|
+
A per-stage gate table written BEFORE stage work begins: stage name, concrete checks (3-5 explicit checks consuming rows from `acceptance-criteria-builder`), evidence required, failure exit, and current gate state (`Pending` | `Pass` | `Fail` | `Blocked`).
|
|
74
|
+
|
|
75
|
+
### Secondary output
|
|
76
|
+
- the linear order in which gates must be evaluated
|
|
77
|
+
- explicit failure exits per gate (stop work immediately on `Fail`; route repeated failures to `blender-troubleshooting`)
|
|
78
|
+
- delegation to `workflow-stage-router` to pick the next domain skill after a gate reaches `Pass`
|
|
79
|
+
|
|
80
|
+
### Evidence / caveat output
|
|
81
|
+
Keep gate states (`Pending | Pass | Fail | Blocked`) strictly separate from runtime truth states and artifact states. Truth states are downgrade-only, never upgrade:
|
|
82
|
+
|
|
83
|
+
```txt
|
|
84
|
+
Runtime status: Not Run | Attempted | Produced | Verified | Failed
|
|
85
|
+
Artifact status: Not Produced | Produced | Verified | Failed
|
|
86
|
+
Evidence used: <links, paths, logs, or "none">
|
|
87
|
+
Limitations: <known gaps>
|
|
88
|
+
```
|
|
89
|
+
|
|
90
|
+
## Required laws
|
|
91
|
+
- `../../laws/evidence-before-done.md`
|
|
92
|
+
- `../../laws/non-blender-user-language.md`
|
|
93
|
+
- `../../laws/no-arbitrary-python-interface.md`
|
|
94
|
+
- `../../laws/official-runtime-only.md`
|
|
95
|
+
|
|
96
|
+
## Official runtime boundary
|
|
97
|
+
|
|
98
|
+
Process / discipline skill — does not run Blender. Gates are written and evaluated against produced artifacts (per `evidence-before-done.md`). Gate verdicts are honest labels, not motivation.
|
|
99
|
+
|
|
100
|
+
## Operating procedure
|
|
101
|
+
1. Confirm the linear recipe stages (using output from `blender-recipe-decomposer` if not yet decomposed).
|
|
102
|
+
2. BEFORE any stage work begins, write the per-stage gate for every stage: concrete checks (consuming measurable rows from `acceptance-criteria-builder`), required evidence, and explicit failure exits (see `references/gate-template.md`).
|
|
103
|
+
3. Pin the gate sequence in linear order; no parallel stages without explicit justification.
|
|
104
|
+
4. After each stage's work, evaluate the gate and update its gate state (`Pending` → `Pass` or `Fail`), keeping gate vocabulary separate from runtime truth states (`Not Run | Attempted | Produced | Verified | Failed`) and artifact states (default `Not Produced`).
|
|
105
|
+
5. If a gate is `Fail`: stop work immediately and execute the gate's failure exit; if a gate fails repeatedly, hand off to `blender-troubleshooting`.
|
|
106
|
+
6. If a gate is `Pass`: advance to the next stage (using `workflow-stage-router` to pick the next skill if needed).
|
|
107
|
+
7. Once all per-stage gates are `Pass`, hand off to `pre-handoff-verification` for the final 7-point gate.
|
|
108
|
+
|
|
109
|
+
## Decision tree
|
|
110
|
+
|
|
111
|
+
```txt
|
|
112
|
+
User wants to skip a stage?
|
|
113
|
+
→ Push back; document as risk if user insists
|
|
114
|
+
A previous gate is `Fail` but later stage was attempted anyway?
|
|
115
|
+
→ Stop; mark all subsequent stages `Blocked`
|
|
116
|
+
Two stages claimed `Pass` simultaneously?
|
|
117
|
+
→ Suspicious; verify each independently
|
|
118
|
+
Gate criteria are vague ("looks good")?
|
|
119
|
+
→ Re-write with concrete checks; do not run an undefined gate
|
|
120
|
+
```
|
|
121
|
+
|
|
122
|
+
## Playbooks
|
|
123
|
+
|
|
124
|
+
### Playbook A: Cyberpunk shoe hero (7 stages)
|
|
125
|
+
Stages: brief → scene plan → asset discovery → scene build → render → export → handoff. One gate per stage.
|
|
126
|
+
|
|
127
|
+
### Playbook B: Multi-product grid (5 stages)
|
|
128
|
+
Stages: brief → grid plan → consistency setup → render → export. One gate per stage; gate 3 = "all cells render identical at sub-resolution".
|
|
129
|
+
|
|
130
|
+
### Playbook C: Character portrait (6 stages)
|
|
131
|
+
Stages: brief → portrait plan → asset discovery → lookdev → render → handoff. Gate 4 = "lookdev approved against mood brief".
|
|
132
|
+
|
|
133
|
+
## Mode handling
|
|
134
|
+
|
|
135
|
+
### Text-only mode
|
|
136
|
+
Gates evaluate plans and specs only. Pre-runtime planning gates can be evaluated (`Pending | Pass | Fail | Blocked`), while runtime-dependent gates remain `Pending` or `Blocked`. Separately, runtime truth state remains `Not Run` and artifact state defaults to `Not Produced` (never assign `Not Run` as a gate state).
|
|
137
|
+
|
|
138
|
+
### Runtime-ready mode
|
|
139
|
+
Gates evaluate produced artifacts using `Pending | Pass | Fail | Blocked` against honest runtime truth states (`Not Run | Attempted | Produced | Verified | Failed`) and artifact states (default `Not Produced`) per `evidence-before-done.md`. Truth states are downgrade-only, never upgrade.
|
|
140
|
+
|
|
141
|
+
### Blocked runtime mode
|
|
142
|
+
Pre-runtime gates can reach `Pass`, while runtime/artifact-dependent gates remain `Blocked`. Runtime truth state stays `Not Run` (or `Failed` if attempted and broken) and artifact state remains `Not Produced`.
|
|
143
|
+
|
|
144
|
+
## Validation checklist
|
|
145
|
+
- [ ] Stages listed in linear order
|
|
146
|
+
- [ ] Gates written BEFORE stage work begins
|
|
147
|
+
- [ ] Concrete checks (3-5 per gate), required evidence, and failure exits explicit for every gate
|
|
148
|
+
- [ ] Gate states use only `Pending | Pass | Fail | Blocked`
|
|
149
|
+
- [ ] Runtime truth states (`Not Run | Attempted | Produced | Verified | Failed`) and artifact states (default `Not Produced`) are kept separate from gate states and downgrade-only
|
|
150
|
+
- [ ] No vague "looks good" gate
|
|
151
|
+
- [ ] Failing gate stops work immediately
|
|
152
|
+
- [ ] Final handoff to `pre-handoff-verification` present
|
|
153
|
+
|
|
154
|
+
## Pass / Warn / Fail rubric
|
|
155
|
+
|
|
156
|
+
| Verdict | Criteria |
|
|
157
|
+
|---|---|
|
|
158
|
+
| Pass | All stages have written gates; evidence required is concrete; no skipped or vague gates. |
|
|
159
|
+
| Warn | One gate has soft criteria ("looks acceptable"); one stage missing evidence row. |
|
|
160
|
+
| Fail | Vague gates throughout; gates skipped; later stage `Pass` without earlier gate `Pass`. |
|
|
161
|
+
|
|
162
|
+
## Failure handling
|
|
163
|
+
- Vague criteria → rewrite with concrete checks.
|
|
164
|
+
- User pushes to skip → document as risk; require explicit acknowledgment.
|
|
165
|
+
- Gate fails repeatedly → hand off to `blender-troubleshooting`.
|
|
166
|
+
|
|
167
|
+
## Troubleshooting
|
|
168
|
+
|
|
169
|
+
| Problem | Response |
|
|
170
|
+
|---|---|
|
|
171
|
+
| Gate criteria invented at gate time | Reset; write gates (checks, evidence, failure exits) BEFORE stage work begins. |
|
|
172
|
+
| Gate `Pass` without evidence | Mark gate `Pending` or `Fail` and require evidence; downgrade runtime/artifact truth states accordingly (truth states are downgrade-only, never upgrade). |
|
|
173
|
+
| Gate state marked `Not Run` or `Verified` | Fix vocabulary conflation: gates use `Pending | Pass | Fail | Blocked`; runtime truth uses `Not Run | Attempted | Produced | Verified | Failed`; artifacts default to `Not Produced`. |
|
|
174
|
+
| Repeated `Fail` on the same gate | Stop work; hand off to `blender-troubleshooting`. |
|
|
175
|
+
|
|
176
|
+
## Best practices
|
|
177
|
+
- Write gates BEFORE the stage work begins.
|
|
178
|
+
- Gates contain concrete checks (numbers, paths, file existence) — not feelings.
|
|
179
|
+
- Stop work on first `Fail`; do not "we'll fix it in the next stage".
|
|
180
|
+
- Pair every gate with a fallback action.
|
|
181
|
+
|
|
182
|
+
## Good examples
|
|
183
|
+
- "Stage 4 (render) gate — written before render work: Checks: `out/render-2026-05-09.png` exists, dimensions 1920×1080, samples >= 128, render time logged. Evidence required: file path + visible image + render log snippet. Failure exit: stop work immediately; if fails twice, hand off to `blender-troubleshooting`. Gate state: `Pending`."
|
|
184
|
+
|
|
185
|
+
## Bad examples
|
|
186
|
+
- "Stage 4 gate: render looks good." — vague.
|
|
187
|
+
|
|
188
|
+
## User-facing response template
|
|
189
|
+
|
|
190
|
+
```txt
|
|
191
|
+
Recipe: <name>
|
|
192
|
+
Stages (linear order, written before work begins):
|
|
193
|
+
|
|
194
|
+
| # | Stage | Concrete checks (3-5) | Evidence required | Failure exit | Gate state |
|
|
195
|
+
|---|---|---|---|---|---|
|
|
196
|
+
| 1 | <stage> | <3-5 concrete checks> | <path / file / measurement> | Stop work; <re-do or hand off to blender-troubleshooting on repeated fail> | Pending / Pass / Fail / Blocked |
|
|
197
|
+
| 2 | … | … | … | … | … |
|
|
198
|
+
|
|
199
|
+
Next skill routing (on Pass): hand off to workflow-stage-router
|
|
200
|
+
Final handoff (after all stage gates Pass): pre-handoff-verification
|
|
201
|
+
|
|
202
|
+
Runtime status: Not Run | Attempted | Produced | Verified | Failed
|
|
203
|
+
Artifact status: Not Produced | Produced | Verified | Failed
|
|
204
|
+
Evidence used: <links, paths, logs, or "none">
|
|
205
|
+
Limitations: <gaps>
|
|
206
|
+
```
|
|
207
|
+
|
|
208
|
+
## Anti-patterns
|
|
209
|
+
- Vague gate criteria ("looks good").
|
|
210
|
+
- Skipping gates or advancing after a `Fail` gate.
|
|
211
|
+
- Inventing gate checks or failure exits after stage work has already started.
|
|
212
|
+
- Running parallel stages without explicit justification.
|
|
213
|
+
- Conflating gate states (`Pending | Pass | Fail | Blocked`) with runtime truth states (`Not Run | Attempted | Produced | Verified | Failed`) or artifact states (default `Not Produced`).
|
|
214
|
+
- Upgrading runtime or artifact truth states (truth states are downgrade-only).
|
|
215
|
+
- Blurring boundaries with `acceptance-criteria-builder`, `done-criteria`, `scope-guard`, `workflow-stage-router`, or `pre-handoff-verification`.
|
|
216
|
+
|
|
217
|
+
## Cross-skill handoff
|
|
218
|
+
<!-- blendops:generated:start handoffs -->
|
|
219
|
+
- [upstream_reference] Brainstorming → `../blender-brainstorming/SKILL.md`
|
|
220
|
+
- [upstream_reference] Brief authoring → `../intent-to-3d-brief-writer/SKILL.md`
|
|
221
|
+
- [upstream_reference] Recipe stage decomposition → `../blender-recipe-decomposer/SKILL.md`
|
|
222
|
+
- [upstream_reference] Measurable acceptance rows → `../acceptance-criteria-builder/SKILL.md`
|
|
223
|
+
- [upstream_reference] Overall done condition → `../done-criteria/SKILL.md`
|
|
224
|
+
- [progression] Scope creep protection → `../scope-guard/SKILL.md`
|
|
225
|
+
- [progression] Next-skill routing across stages → `../workflow-stage-router/SKILL.md`
|
|
226
|
+
- [progression] Asset discovery → `../asset-discovery/SKILL.md`
|
|
227
|
+
- [progression] Scene planners (camera-composition) → `../camera-composition/SKILL.md`
|
|
228
|
+
- [progression] Scene planners (lighting-material-plan) → `../lighting-material-plan/SKILL.md`
|
|
229
|
+
- [alternative] Scene planners (character-portrait) → `../character-portrait/SKILL.md`
|
|
230
|
+
- [alternative] Scene planners (environment-shot) → `../environment-shot/SKILL.md`
|
|
231
|
+
- [alternative] Scene planners (interior-scene) → `../interior-scene/SKILL.md`
|
|
232
|
+
- [alternative] Scene planners (product-grid-scene-planner) → `../product-grid-scene-planner/SKILL.md`
|
|
233
|
+
- [alternative] Scene planners (product-hero-scene-planner) → `../product-hero-scene-planner/SKILL.md`
|
|
234
|
+
- [progression] Quality validators (scene-readiness) → `../scene-readiness/SKILL.md`
|
|
235
|
+
- [progression] Quality validators (composition-quality-checker) → `../composition-quality-checker/SKILL.md`
|
|
236
|
+
- [progression] Quality validators (lighting-quality-checker) → `../lighting-quality-checker/SKILL.md`
|
|
237
|
+
- [progression] Quality validators (material-quality-checker) → `../material-quality-checker/SKILL.md`
|
|
238
|
+
- [progression] Quality validators (polycount-budget-checker) → `../polycount-budget-checker/SKILL.md`
|
|
239
|
+
- [fallback] Repeated gate failures → `../blender-troubleshooting/SKILL.md`
|
|
240
|
+
- [progression] Final 7-point gate → `../pre-handoff-verification/SKILL.md`
|
|
241
|
+
<!-- blendops:generated:end handoffs -->
|
|
242
|
+
|
|
243
|
+
## Non-goals
|
|
244
|
+
- Run Blender or execute Python.
|
|
245
|
+
- Decompose recipes into stages (`blender-recipe-decomposer`).
|
|
246
|
+
- Write measurable acceptance criteria rows (`acceptance-criteria-builder`).
|
|
247
|
+
- Pin the overall done/stop condition (`done-criteria`).
|
|
248
|
+
- Guard against scope creep (`scope-guard`).
|
|
249
|
+
- Pick next skills across the workflow (`workflow-stage-router`).
|
|
250
|
+
- Diagnose repeated technical failures (`blender-troubleshooting`).
|
|
251
|
+
- Replace the final 7-point handoff gate (`pre-handoff-verification`).
|
|
252
|
+
|
|
253
|
+
## References
|
|
254
|
+
- `references/gate-template.md`
|
|
255
|
+
- `references/stage-decomposition-patterns.md`
|
|
256
|
+
- `references/failed-gate-handling.md`
|
|
257
|
+
- `../../docs/skill-system.md`
|