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,225 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: done-criteria
|
|
3
|
+
description: Define explicit "done" conditions for a Blender recipe before starting work, so the agent stops at the right point instead of drifting into endless polish.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# done-criteria
|
|
7
|
+
|
|
8
|
+
## Purpose
|
|
9
|
+
Pin a single, explicit stop condition for one recipe BEFORE work begins—consisting of one concrete sentence, an explicit out-of-scope list, and a handoff trigger—so the agent stops at the right point instead of drifting into endless polish. Firing the stop condition routes the deliverable to the next skill; it never upgrades any runtime or artifact truth state. Inspired by Anthropic Superpowers `/just-say-when-it's-done` analog.
|
|
10
|
+
|
|
11
|
+
## Quick start
|
|
12
|
+
- write one stop condition per recipe (one sentence, concrete)
|
|
13
|
+
- write what is OUT OF SCOPE for "done"
|
|
14
|
+
- write the handoff trigger (which skill receives the deliverable when stop condition fires)
|
|
15
|
+
- enforce: do not polish past the stop condition; do not declare done before it
|
|
16
|
+
|
|
17
|
+
## When to use
|
|
18
|
+
- BEFORE starting work on any non-trivial single Blender recipe
|
|
19
|
+
- after `blender-recipe-decomposer` has isolated a single recipe and `acceptance-criteria-builder` has provided measurable acceptance rows
|
|
20
|
+
- when previous attempts drifted into endless polish or unclear completion boundaries
|
|
21
|
+
|
|
22
|
+
## When not to use
|
|
23
|
+
<!-- blendops:generated:start exclusions -->
|
|
24
|
+
- pure exploration or brainstorming → use `../blender-brainstorming/SKILL.md` (use blender-brainstorming; goal is divergence)
|
|
25
|
+
- tiny single-shot requests → use `../intent-to-3d-brief-writer/SKILL.md` (Delegates out-of-scope requests to intent-to-3d-brief-writer)
|
|
26
|
+
- splitting a broad multi-recipe request beforehand → use `../blender-recipe-decomposer/SKILL.md` (use blender-recipe-decomposer first)
|
|
27
|
+
- authoring measurable acceptance rows from scratch → use `../acceptance-criteria-builder/SKILL.md` (use acceptance-criteria-builder first)
|
|
28
|
+
- enforcing per-stage checklist gates during execution → use `../stage-gates/SKILL.md` (use stage-gates)
|
|
29
|
+
- after work has already started and scope is drifting mid-flight → use `../scope-guard/SKILL.md` (use scope-guard)
|
|
30
|
+
- performing the final verification gate before delivery → use `../pre-handoff-verification/SKILL.md` (use pre-handoff-verification)
|
|
31
|
+
<!-- blendops:generated:end exclusions -->
|
|
32
|
+
|
|
33
|
+
## Trigger phrases
|
|
34
|
+
<!-- blendops:generated:start triggers -->
|
|
35
|
+
- "when are we done"
|
|
36
|
+
- "let's set the bar"
|
|
37
|
+
- "what does done look like"
|
|
38
|
+
<!-- blendops:generated:end triggers -->
|
|
39
|
+
|
|
40
|
+
## Prerequisites / readiness
|
|
41
|
+
- single-recipe scope is clear (split beforehand via `blender-recipe-decomposer` if needed)
|
|
42
|
+
- measurable acceptance rows are available from `acceptance-criteria-builder`
|
|
43
|
+
- user accepts a written stop condition BEFORE work begins
|
|
44
|
+
|
|
45
|
+
## Input schema
|
|
46
|
+
|
|
47
|
+
### Required inputs
|
|
48
|
+
|
|
49
|
+
| Input | Why it is required |
|
|
50
|
+
|---|---|
|
|
51
|
+
| Single recipe scope | Anchors the stop condition to one recipe (via `blender-recipe-decomposer` if previously multi-part) |
|
|
52
|
+
| Measurable acceptance rows | Consumed from `acceptance-criteria-builder` to define what "done" means concretely |
|
|
53
|
+
|
|
54
|
+
### Optional inputs
|
|
55
|
+
|
|
56
|
+
| Input | Use |
|
|
57
|
+
|---|---|
|
|
58
|
+
| Time / budget constraints | Forces tighter out-of-scope boundaries |
|
|
59
|
+
| Reference deliverable | Calibrates the measurable bar |
|
|
60
|
+
|
|
61
|
+
### Assumptions to confirm
|
|
62
|
+
- The stop condition is written and agreed to BEFORE work begins.
|
|
63
|
+
- "Done" is the stop and handoff point, not a temporary plateau before extra polish.
|
|
64
|
+
- Ambiguous "done" means the recipe is not yet ready to start.
|
|
65
|
+
|
|
66
|
+
## Output schema
|
|
67
|
+
|
|
68
|
+
### Primary output
|
|
69
|
+
A single stop condition record written before work begins: one concrete sentence, an out-of-scope list (3-5 items), and a named handoff trigger skill.
|
|
70
|
+
|
|
71
|
+
### Secondary output
|
|
72
|
+
- explicit guardrails: what does NOT count as done
|
|
73
|
+
- next-step routing instruction when the stop condition fires
|
|
74
|
+
|
|
75
|
+
### Evidence / caveat output
|
|
76
|
+
|
|
77
|
+
```txt
|
|
78
|
+
Runtime status: Not Run | Attempted | Produced | Verified | Failed
|
|
79
|
+
Artifact status: Not Produced | Produced | Verified | Failed
|
|
80
|
+
Evidence used: <links, paths, logs, or "none">
|
|
81
|
+
Limitations: <known gaps>
|
|
82
|
+
```
|
|
83
|
+
|
|
84
|
+
- Default artifact status is `Not Produced`; default runtime status before execution is `Not Run`.
|
|
85
|
+
- Truth states are downgrade-only, never upgrade.
|
|
86
|
+
- A stop condition firing does NOT upgrade any truth state; downstream evidence skills (such as `render-export-evidence` and `pre-handoff-verification`) decide labels.
|
|
87
|
+
|
|
88
|
+
## Required laws
|
|
89
|
+
- `../../laws/evidence-before-done.md`
|
|
90
|
+
- `../../laws/non-blender-user-language.md`
|
|
91
|
+
- `../../laws/no-arbitrary-python-interface.md`
|
|
92
|
+
- `../../laws/official-runtime-only.md`
|
|
93
|
+
|
|
94
|
+
## Official runtime boundary
|
|
95
|
+
|
|
96
|
+
Process and discipline skill only—no Python code and no Blender execution. This skill writes the stop condition before work starts and routes handoff when the condition is met; it never executes runtime tasks or upgrades truth states.
|
|
97
|
+
|
|
98
|
+
## Operating procedure
|
|
99
|
+
1. Confirm single-recipe scope BEFORE work begins (if multiple recipes exist, hand off to `blender-recipe-decomposer` first).
|
|
100
|
+
2. Consume measurable acceptance rows from `acceptance-criteria-builder` and write one concrete stop-condition sentence for the recipe.
|
|
101
|
+
3. List 3-5 items that are explicitly OUT OF SCOPE for "done".
|
|
102
|
+
4. Pin the exact catalog skill that receives the handoff when the stop condition fires.
|
|
103
|
+
5. Hold the boundary: stop polishing once the condition fires and route to the handoff skill (such as `pre-handoff-verification` or `render-export-evidence`) without claiming a truth-state upgrade.
|
|
104
|
+
|
|
105
|
+
## Decision tree
|
|
106
|
+
|
|
107
|
+
```txt
|
|
108
|
+
Stop condition vague ("looks great")?
|
|
109
|
+
→ Route to acceptance-criteria-builder for measurable rows, then rewrite as one concrete sentence
|
|
110
|
+
Multiple stop conditions or recipes proposed?
|
|
111
|
+
→ Route to blender-recipe-decomposer to split scope, or keep the highest-priority condition and move others to out-of-scope
|
|
112
|
+
Work already started and scope is shifting mid-flight?
|
|
113
|
+
→ Hand off to scope-guard
|
|
114
|
+
Stop condition not yet evaluable in current mode?
|
|
115
|
+
→ Mark as forward-condition; keep runtime Not Run and artifact Not Produced
|
|
116
|
+
```
|
|
117
|
+
|
|
118
|
+
## Playbooks
|
|
119
|
+
|
|
120
|
+
### Playbook A: Hero render
|
|
121
|
+
"Done = `out/render-2026-05-09.png` exists at 1920×1080, 128+ Cycles samples, mood matches brief, validation logged." Handoff trigger: `render-export-evidence` (then `pre-handoff-verification`). Out of scope: animation, post-process, alternate lighting takes.
|
|
122
|
+
|
|
123
|
+
### Playbook B: GLB handoff
|
|
124
|
+
"Done = `out/scene.glb` exists, gltf-validator passes, triangle count within budget, animation contract documented." Handoff trigger: `glb-web-handoff` (or `pre-handoff-verification`). Out of scope: high-poly cinematic renders, custom shader authoring, additional LOD tiers, promotional stills.
|
|
125
|
+
|
|
126
|
+
### Playbook C: Text-only plan
|
|
127
|
+
"Done = scene plan section count >= 7, all sections concrete, asset list flagged, handoff to scene quality checker." Handoff trigger: `scene-readiness`. Out of scope: running Blender, producing files, writing Python.
|
|
128
|
+
|
|
129
|
+
## Mode handling
|
|
130
|
+
|
|
131
|
+
### Text-only mode
|
|
132
|
+
Stop condition refers strictly to plan completeness. Runtime status remains `Not Run` and artifact status remains `Not Produced`.
|
|
133
|
+
|
|
134
|
+
### Runtime-ready mode
|
|
135
|
+
Stop condition refers to target artifacts and acceptance rows. When the condition fires, it routes to `render-export-evidence` or `pre-handoff-verification`—firing does not itself upgrade runtime or artifact status to `Produced` or `Verified`.
|
|
136
|
+
|
|
137
|
+
### Blocked runtime mode
|
|
138
|
+
Stop condition is recorded before work begins as a forward condition awaiting runtime readiness; runtime status stays `Not Run` and artifact status stays `Not Produced`.
|
|
139
|
+
|
|
140
|
+
## Validation checklist
|
|
141
|
+
- [ ] Written BEFORE work begins on a single recipe
|
|
142
|
+
- [ ] Stop condition is exactly one concrete sentence consuming `acceptance-criteria-builder` rows
|
|
143
|
+
- [ ] Out-of-scope list (3-5 items) is present and explicit
|
|
144
|
+
- [ ] Handoff trigger names a real BlendOps catalog skill
|
|
145
|
+
- [ ] Does not claim or trigger a truth-state upgrade upon firing
|
|
146
|
+
- [ ] Plain language used (no Python, no Blender execution claims)
|
|
147
|
+
|
|
148
|
+
## Pass / Warn / Fail rubric
|
|
149
|
+
|
|
150
|
+
| Verdict | Criteria |
|
|
151
|
+
|---|---|
|
|
152
|
+
| Pass | One concrete stop condition + out-of-scope + handoff. |
|
|
153
|
+
| Warn | Stop condition present but slightly soft; out-of-scope partial. |
|
|
154
|
+
| Fail | Vague "looks good" stop condition; no out-of-scope; no handoff; multiple conditions stacked. |
|
|
155
|
+
|
|
156
|
+
## Failure handling
|
|
157
|
+
- Vague stop condition without measurable criteria → route to `acceptance-criteria-builder`, then rewrite.
|
|
158
|
+
- Multiple recipes or conditions stacked → route to `blender-recipe-decomposer` to split into separate recipes.
|
|
159
|
+
- User pushes for "more polish" or changes scope after work starts → hand off to `scope-guard`.
|
|
160
|
+
|
|
161
|
+
## Troubleshooting
|
|
162
|
+
|
|
163
|
+
| Problem | Response |
|
|
164
|
+
| --- | --- |
|
|
165
|
+
| User wants "perfect" before stopping | Consume concrete rows from `acceptance-criteria-builder`; place "perfect" polish items into the out-of-scope list. |
|
|
166
|
+
| Stop condition keeps moving mid-flight | Mid-recipe scope drift; hand off to `scope-guard`. |
|
|
167
|
+
| Firing treated as `Verified` without evidence | Downgrade-only rule applies (default artifact `Not Produced`); route to `render-export-evidence` and `pre-handoff-verification` to evaluate truth states. |
|
|
168
|
+
|
|
169
|
+
## Best practices
|
|
170
|
+
- One sentence, one stop condition, one recipe.
|
|
171
|
+
- Write the condition BEFORE work begins.
|
|
172
|
+
- Out-of-scope is at least as important as in-scope.
|
|
173
|
+
- "Done" is honest, not optimistic.
|
|
174
|
+
|
|
175
|
+
## Good examples
|
|
176
|
+
- "Done = single hero still exported at 1920x1080 meeting the approved framing and lighting acceptance rows. Out of scope: animation, post-process grading, alternate lighting takes. Handoff trigger: `render-export-evidence`."
|
|
177
|
+
|
|
178
|
+
## Bad examples
|
|
179
|
+
- "Done when it looks great." — vague.
|
|
180
|
+
|
|
181
|
+
## User-facing response template
|
|
182
|
+
|
|
183
|
+
```txt
|
|
184
|
+
Recipe: <name>
|
|
185
|
+
Stop condition (one sentence, concrete): <…>
|
|
186
|
+
Out of scope for "done":
|
|
187
|
+
- <…>
|
|
188
|
+
- <…>
|
|
189
|
+
- <…>
|
|
190
|
+
Handoff trigger: <skill>
|
|
191
|
+
Mode: <text-only / runtime-ready / blocked>
|
|
192
|
+
Limitations: <gaps>
|
|
193
|
+
```
|
|
194
|
+
|
|
195
|
+
## Anti-patterns
|
|
196
|
+
- Stacking multiple stop conditions or multiple recipes into one record.
|
|
197
|
+
- Using vague language ("when it looks great").
|
|
198
|
+
- Defining or moving the stop condition after work has already begun.
|
|
199
|
+
- Treating a fired stop condition as an automatic upgrade to `Produced` or `Verified`.
|
|
200
|
+
- Blurring roles with `acceptance-criteria-builder`, `stage-gates`, or `scope-guard`.
|
|
201
|
+
|
|
202
|
+
## Cross-skill handoff
|
|
203
|
+
<!-- blendops:generated:start handoffs -->
|
|
204
|
+
- [upstream_reference] Intent brief → `../intent-to-3d-brief-writer/SKILL.md`
|
|
205
|
+
- [boundary_delegation] Scope splitting beforehand → `../blender-recipe-decomposer/SKILL.md`
|
|
206
|
+
- [upstream_reference] Measurable acceptance rows → `../acceptance-criteria-builder/SKILL.md`
|
|
207
|
+
- [progression] Per-stage workflow gates → `../stage-gates/SKILL.md`
|
|
208
|
+
- [progression] Mid-flight scope drift → `../scope-guard/SKILL.md`
|
|
209
|
+
- [progression] Artifact and render evidence → `../render-export-evidence/SKILL.md`
|
|
210
|
+
- [progression] Final pre-handoff gate → `../pre-handoff-verification/SKILL.md`
|
|
211
|
+
<!-- blendops:generated:end handoffs -->
|
|
212
|
+
|
|
213
|
+
## Non-goals
|
|
214
|
+
- Run Blender or execute Python.
|
|
215
|
+
- Split multi-recipe scope (`blender-recipe-decomposer`).
|
|
216
|
+
- Author raw measurable acceptance rows (`acceptance-criteria-builder`).
|
|
217
|
+
- Enforce per-stage checklist gates (`stage-gates`).
|
|
218
|
+
- Police mid-flight scope drift (`scope-guard`).
|
|
219
|
+
- Gate the final delivery (`pre-handoff-verification`) or upgrade runtime/artifact truth states.
|
|
220
|
+
|
|
221
|
+
## References
|
|
222
|
+
- `references/stop-condition-templates.md`
|
|
223
|
+
- `references/out-of-scope-patterns.md`
|
|
224
|
+
- `references/done-vs-perfect.md`
|
|
225
|
+
- `../../docs/skill-system.md`
|
|
@@ -0,0 +1,199 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$schema": "../../schemas/skill-contract.schema.json",
|
|
3
|
+
"id": "done-criteria",
|
|
4
|
+
"version": "1.0.0",
|
|
5
|
+
"category": "process-discipline",
|
|
6
|
+
"role": "done-condition-and-iteration-cap-pinner",
|
|
7
|
+
"purpose": "Define explicit \"done\" conditions for a Blender recipe before starting work, so the agent stops at the right point instead of drifting into endless polish.",
|
|
8
|
+
"capabilityTier": "L0",
|
|
9
|
+
"triggers": [
|
|
10
|
+
"when are we done",
|
|
11
|
+
"let's set the bar",
|
|
12
|
+
"what does done look like"
|
|
13
|
+
],
|
|
14
|
+
"exclusions": [
|
|
15
|
+
{
|
|
16
|
+
"condition": "pure exploration or brainstorming",
|
|
17
|
+
"delegateTo": "blender-brainstorming",
|
|
18
|
+
"reason": "use blender-brainstorming; goal is divergence"
|
|
19
|
+
},
|
|
20
|
+
{
|
|
21
|
+
"condition": "tiny single-shot requests",
|
|
22
|
+
"delegateTo": "intent-to-3d-brief-writer",
|
|
23
|
+
"reason": "Delegates out-of-scope requests to intent-to-3d-brief-writer"
|
|
24
|
+
},
|
|
25
|
+
{
|
|
26
|
+
"condition": "splitting a broad multi-recipe request beforehand",
|
|
27
|
+
"delegateTo": "blender-recipe-decomposer",
|
|
28
|
+
"reason": "use blender-recipe-decomposer first"
|
|
29
|
+
},
|
|
30
|
+
{
|
|
31
|
+
"condition": "authoring measurable acceptance rows from scratch",
|
|
32
|
+
"delegateTo": "acceptance-criteria-builder",
|
|
33
|
+
"reason": "use acceptance-criteria-builder first"
|
|
34
|
+
},
|
|
35
|
+
{
|
|
36
|
+
"condition": "enforcing per-stage checklist gates during execution",
|
|
37
|
+
"delegateTo": "stage-gates",
|
|
38
|
+
"reason": "use stage-gates"
|
|
39
|
+
},
|
|
40
|
+
{
|
|
41
|
+
"condition": "after work has already started and scope is drifting mid-flight",
|
|
42
|
+
"delegateTo": "scope-guard",
|
|
43
|
+
"reason": "use scope-guard"
|
|
44
|
+
},
|
|
45
|
+
{
|
|
46
|
+
"condition": "performing the final verification gate before delivery",
|
|
47
|
+
"delegateTo": "pre-handoff-verification",
|
|
48
|
+
"reason": "use pre-handoff-verification"
|
|
49
|
+
}
|
|
50
|
+
],
|
|
51
|
+
"inputs": {
|
|
52
|
+
"required": [
|
|
53
|
+
{
|
|
54
|
+
"name": "locked_3d_brief",
|
|
55
|
+
"type": "object",
|
|
56
|
+
"description": "Locked 8-slot 3D brief defining deliverable intent"
|
|
57
|
+
},
|
|
58
|
+
{
|
|
59
|
+
"name": "acceptance_criteria_rows",
|
|
60
|
+
"type": "array",
|
|
61
|
+
"description": "Measurable Pass/Warn/Fail criteria from acceptance-criteria-builder"
|
|
62
|
+
}
|
|
63
|
+
],
|
|
64
|
+
"optional": [
|
|
65
|
+
{
|
|
66
|
+
"name": "iteration_budget_preference",
|
|
67
|
+
"type": "integer",
|
|
68
|
+
"description": "Maximum refinement passes before halting or escalating"
|
|
69
|
+
}
|
|
70
|
+
]
|
|
71
|
+
},
|
|
72
|
+
"outputs": {
|
|
73
|
+
"primary": [
|
|
74
|
+
"definition_of_done_checklist",
|
|
75
|
+
"max_iteration_caps_per_stage",
|
|
76
|
+
"halt_and_escalation_triggers"
|
|
77
|
+
],
|
|
78
|
+
"truthStatePolicy": {
|
|
79
|
+
"runtimeDefault": "Not Run",
|
|
80
|
+
"artifactDefault": "Not Produced",
|
|
81
|
+
"mutationRule": "downgrade_only"
|
|
82
|
+
}
|
|
83
|
+
},
|
|
84
|
+
"handoffs": [
|
|
85
|
+
{
|
|
86
|
+
"target": "intent-to-3d-brief-writer",
|
|
87
|
+
"type": "upstream_reference",
|
|
88
|
+
"label": "Intent brief",
|
|
89
|
+
"when": {
|
|
90
|
+
"all": [
|
|
91
|
+
{
|
|
92
|
+
"field": "goal.clarity",
|
|
93
|
+
"operator": "equals",
|
|
94
|
+
"value": "clear"
|
|
95
|
+
},
|
|
96
|
+
{
|
|
97
|
+
"field": "brief.locked",
|
|
98
|
+
"operator": "equals",
|
|
99
|
+
"value": false
|
|
100
|
+
}
|
|
101
|
+
]
|
|
102
|
+
}
|
|
103
|
+
},
|
|
104
|
+
{
|
|
105
|
+
"target": "blender-recipe-decomposer",
|
|
106
|
+
"type": "boundary_delegation",
|
|
107
|
+
"label": "Scope splitting beforehand",
|
|
108
|
+
"when": {
|
|
109
|
+
"all": [
|
|
110
|
+
{
|
|
111
|
+
"field": "fit.multiDeliverableDetected",
|
|
112
|
+
"operator": "equals",
|
|
113
|
+
"value": true
|
|
114
|
+
}
|
|
115
|
+
]
|
|
116
|
+
}
|
|
117
|
+
},
|
|
118
|
+
{
|
|
119
|
+
"target": "acceptance-criteria-builder",
|
|
120
|
+
"type": "upstream_reference",
|
|
121
|
+
"label": "Measurable acceptance rows",
|
|
122
|
+
"when": {
|
|
123
|
+
"all": [
|
|
124
|
+
{
|
|
125
|
+
"field": "brief.locked",
|
|
126
|
+
"operator": "equals",
|
|
127
|
+
"value": true
|
|
128
|
+
},
|
|
129
|
+
{
|
|
130
|
+
"field": "stage.current",
|
|
131
|
+
"operator": "equals",
|
|
132
|
+
"value": "acceptance_criteria"
|
|
133
|
+
}
|
|
134
|
+
]
|
|
135
|
+
}
|
|
136
|
+
},
|
|
137
|
+
{
|
|
138
|
+
"target": "stage-gates",
|
|
139
|
+
"type": "progression",
|
|
140
|
+
"label": "Per-stage workflow gates",
|
|
141
|
+
"when": {
|
|
142
|
+
"all": [
|
|
143
|
+
{
|
|
144
|
+
"field": "brief.locked",
|
|
145
|
+
"operator": "equals",
|
|
146
|
+
"value": true
|
|
147
|
+
},
|
|
148
|
+
{
|
|
149
|
+
"field": "stage.current",
|
|
150
|
+
"operator": "equals",
|
|
151
|
+
"value": "stage_gates"
|
|
152
|
+
}
|
|
153
|
+
]
|
|
154
|
+
}
|
|
155
|
+
},
|
|
156
|
+
{
|
|
157
|
+
"target": "scope-guard",
|
|
158
|
+
"type": "progression",
|
|
159
|
+
"label": "Mid-flight scope drift",
|
|
160
|
+
"when": {
|
|
161
|
+
"all": [
|
|
162
|
+
{
|
|
163
|
+
"field": "scope.driftDetected",
|
|
164
|
+
"operator": "equals",
|
|
165
|
+
"value": true
|
|
166
|
+
}
|
|
167
|
+
]
|
|
168
|
+
}
|
|
169
|
+
},
|
|
170
|
+
{
|
|
171
|
+
"target": "render-export-evidence",
|
|
172
|
+
"type": "progression",
|
|
173
|
+
"label": "Artifact and render evidence",
|
|
174
|
+
"when": {
|
|
175
|
+
"all": [
|
|
176
|
+
{
|
|
177
|
+
"field": "stage.current",
|
|
178
|
+
"operator": "equals",
|
|
179
|
+
"value": "post_execution_audit"
|
|
180
|
+
}
|
|
181
|
+
]
|
|
182
|
+
}
|
|
183
|
+
},
|
|
184
|
+
{
|
|
185
|
+
"target": "pre-handoff-verification",
|
|
186
|
+
"type": "progression",
|
|
187
|
+
"label": "Final pre-handoff gate",
|
|
188
|
+
"when": {
|
|
189
|
+
"all": [
|
|
190
|
+
{
|
|
191
|
+
"field": "stage.current",
|
|
192
|
+
"operator": "equals",
|
|
193
|
+
"value": "final_verification"
|
|
194
|
+
}
|
|
195
|
+
]
|
|
196
|
+
}
|
|
197
|
+
}
|
|
198
|
+
]
|
|
199
|
+
}
|
|
@@ -0,0 +1,56 @@
|
|
|
1
|
+
# Done vs perfect
|
|
2
|
+
|
|
3
|
+
## Why this matters
|
|
4
|
+
|
|
5
|
+
"Done" is honest completion against a stop condition. "Perfect" is an asymptote — pursuing it eats time without bounded benefit.
|
|
6
|
+
|
|
7
|
+
The stop condition pins "done" so the agent stops before drifting toward "perfect".
|
|
8
|
+
|
|
9
|
+
## When users push past the stop condition
|
|
10
|
+
|
|
11
|
+
User says: "Looks great, but can we also...?"
|
|
12
|
+
|
|
13
|
+
Response:
|
|
14
|
+
1. Acknowledge the stop condition is met.
|
|
15
|
+
2. Offer the addition as a new scope agreement (new recipe / new stop condition).
|
|
16
|
+
3. Do not silently absorb.
|
|
17
|
+
|
|
18
|
+
User says: "Almost there, just one more pass at...?"
|
|
19
|
+
|
|
20
|
+
Response:
|
|
21
|
+
1. Check: does the stop condition actually require another pass?
|
|
22
|
+
2. If yes (the condition not yet evaluated true) → continue.
|
|
23
|
+
3. If no (condition is met but user wants more polish) → flag as scope addition; require new agreement.
|
|
24
|
+
|
|
25
|
+
## Polish vs done — the test
|
|
26
|
+
|
|
27
|
+
Question to self: **Has the stop condition been verified by evidence?**
|
|
28
|
+
- Yes → done. Stop. Hand off.
|
|
29
|
+
- No → not done. Continue per checklist gates.
|
|
30
|
+
|
|
31
|
+
This separates "honest done" from "feels not done".
|
|
32
|
+
|
|
33
|
+
## When not done feels done
|
|
34
|
+
|
|
35
|
+
Sometimes a render "feels great" but the stop condition is technically not met (e.g. samples threshold not yet reached, or validation not logged). In this case:
|
|
36
|
+
- "Done" remains `Pending` until evidence supports it.
|
|
37
|
+
- The user can choose to amend the stop condition (with a new agreement) if the original bar was too strict.
|
|
38
|
+
- Do not silently mark done.
|
|
39
|
+
|
|
40
|
+
## When done feels not done
|
|
41
|
+
|
|
42
|
+
Sometimes the stop condition is met but the result feels disappointing. In this case:
|
|
43
|
+
- The recipe is honestly done per agreed bar.
|
|
44
|
+
- Disappointment indicates the stop condition was the wrong target.
|
|
45
|
+
- Document as a learning for the next recipe; do not extend this one silently.
|
|
46
|
+
|
|
47
|
+
## Rationalization prevention table
|
|
48
|
+
|
|
49
|
+
| Excuse | Reality |
|
|
50
|
+
|---|---|
|
|
51
|
+
| "Let me add one extra camera bevel/polish before stopping." | Polish past the written stop condition is silent scope creep. Stop and route to handoff. |
|
|
52
|
+
| "The scene looks great, so the stop condition doesn't matter." | Subjectivity cannot replace the agreed acceptance row. Verify the row or downgrade to `Pending`. |
|
|
53
|
+
| "I'll adjust the stop condition slightly to match what was built." | Moving the goalpost after execution corrupts truth discipline. Route to `scope-guard`. |
|
|
54
|
+
|
|
55
|
+
## Related skill
|
|
56
|
+
`../SKILL.md`
|
|
@@ -0,0 +1,50 @@
|
|
|
1
|
+
# Out-of-scope patterns
|
|
2
|
+
|
|
3
|
+
The "out of scope" list is at least as important as the stop condition. It prevents:
|
|
4
|
+
- silent scope creep
|
|
5
|
+
- "while we're at it" drift
|
|
6
|
+
- post-stop polish that compounds time
|
|
7
|
+
|
|
8
|
+
## Common out-of-scope items per recipe type
|
|
9
|
+
|
|
10
|
+
### Render hero
|
|
11
|
+
- Alternate lighting takes
|
|
12
|
+
- Animation
|
|
13
|
+
- Post-process color grade beyond default
|
|
14
|
+
- Multiple aspect ratios from same scene
|
|
15
|
+
- Variant material colors
|
|
16
|
+
|
|
17
|
+
### GLB export
|
|
18
|
+
- Multiple LOD levels (unless explicit)
|
|
19
|
+
- Animation re-targeting
|
|
20
|
+
- Web component implementation
|
|
21
|
+
- Asset re-licensing
|
|
22
|
+
|
|
23
|
+
### Scene plan (text-only)
|
|
24
|
+
- Modeling work
|
|
25
|
+
- Asset sourcing (only flagging)
|
|
26
|
+
- Render preview
|
|
27
|
+
- Final-quality rendering
|
|
28
|
+
|
|
29
|
+
### Multi-product grid
|
|
30
|
+
- Per-product hero variants
|
|
31
|
+
- Lifestyle context shots
|
|
32
|
+
- Animation
|
|
33
|
+
- Per-product separate renders (unless requested)
|
|
34
|
+
|
|
35
|
+
## When to add to out-of-scope
|
|
36
|
+
|
|
37
|
+
If during work the user says "could you also...", that addition goes to:
|
|
38
|
+
- (a) a new follow-up recipe with its own stop condition, OR
|
|
39
|
+
- (b) the current recipe's out-of-scope (if the user is just exploring, not requesting).
|
|
40
|
+
|
|
41
|
+
Never silently expand the in-scope work to absorb the addition.
|
|
42
|
+
|
|
43
|
+
## How to phrase
|
|
44
|
+
|
|
45
|
+
- "Animation" (not "we won't animate" — phrase as a topic, not a verb negation)
|
|
46
|
+
- "Lifestyle context shots" (specific, not "anything else")
|
|
47
|
+
- Pair with "deferred to follow-up recipe" if the user wants to do it later.
|
|
48
|
+
|
|
49
|
+
## Related skill
|
|
50
|
+
`../SKILL.md`
|
|
@@ -0,0 +1,39 @@
|
|
|
1
|
+
# Stop condition templates
|
|
2
|
+
|
|
3
|
+
## Template by recipe type
|
|
4
|
+
|
|
5
|
+
### Render hero
|
|
6
|
+
"Done = `out/<name>.png` exists at <W>×<H>, <samples>+ samples, mood matches brief reference (diff < <X>%), validation logged in `docs/evals/...`."
|
|
7
|
+
|
|
8
|
+
### GLB export
|
|
9
|
+
"Done = `out/<name>.glb` exists, `gltf-validator` passes, triangle count <= <budget>, animation contract documented in `glb-animation-handoff` output."
|
|
10
|
+
|
|
11
|
+
### Text-only scene plan
|
|
12
|
+
"Done = scene plan with all <N> required sections concrete (no "TBD"), asset list flagged for discovery, handoff to `<next skill>`."
|
|
13
|
+
|
|
14
|
+
### Multi-render grid
|
|
15
|
+
"Done = <N> renders exist for grid cells, all consistent (camera + lighting + background within tolerance), composite layout image produced."
|
|
16
|
+
|
|
17
|
+
### Pre-runtime readiness
|
|
18
|
+
"Done = readiness checklist all green, runtime path chosen + recorded, no Blocked items remain."
|
|
19
|
+
|
|
20
|
+
### Final response writing
|
|
21
|
+
"Done = stakeholder-facing response written, jargon checked, evidence labels honest, no overclaim."
|
|
22
|
+
|
|
23
|
+
## Common boilerplate
|
|
24
|
+
|
|
25
|
+
Every stop condition contains:
|
|
26
|
+
- A specific artifact or evaluable state.
|
|
27
|
+
- A measurable threshold (resolution, samples, count, percentage).
|
|
28
|
+
- A reference for "match" if applicable (brief, image, validator output).
|
|
29
|
+
- A truth label rule per `evidence-before-done.md`.
|
|
30
|
+
|
|
31
|
+
## Templates to NOT use
|
|
32
|
+
|
|
33
|
+
- "Done when good."
|
|
34
|
+
- "Done when ready."
|
|
35
|
+
- "Done when the user says so." (Imprecise; user input is needed for scope agreement, not the stop condition itself.)
|
|
36
|
+
- "Done when there are no blockers." (Negative phrasing; rephrase positively.)
|
|
37
|
+
|
|
38
|
+
## Related skill
|
|
39
|
+
`../SKILL.md`
|
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
# EVAL — environment-shot
|
|
2
|
+
|
|
3
|
+
## Text-only eval prompt
|
|
4
|
+
Use environment-shot on a brief: "cyberpunk city street at night, light rain, cinematic 2.39:1 mood".
|
|
5
|
+
|
|
6
|
+
## Expected behavior
|
|
7
|
+
- Locale + time of day + weather pinned
|
|
8
|
+
- Atmosphere + sky chosen
|
|
9
|
+
- Camera position + lens + altitude + tilt explicit
|
|
10
|
+
- FG / MG / BG composition layers explicit
|
|
11
|
+
- Focal subject named (or explicit "none")
|
|
12
|
+
- Asset list flagged
|
|
13
|
+
- Handoff named
|
|
14
|
+
- Honest evidence label
|
|
15
|
+
|
|
16
|
+
## Pass / Warn / Fail criteria
|
|
17
|
+
- Pass: all sections + plausible weather + focal subject + assets flagged
|
|
18
|
+
- Warn: locale broad / one section ambiguous
|
|
19
|
+
- Fail: contradictory time + weather, no depth layers, no focal subject
|
|
20
|
+
|
|
21
|
+
## Common failure modes
|
|
22
|
+
- "Beautiful weather" without specifics
|
|
23
|
+
- mixing portrait scope into establishing
|
|
24
|
+
- skipping atmospheric haze decision
|
|
25
|
+
- treating sky as afterthought
|
|
26
|
+
|
|
27
|
+
## Evidence expectations
|
|
28
|
+
- explicit time-of-day + weather + atmosphere
|
|
29
|
+
- depth layers separated
|
|
30
|
+
- handoff list
|
|
31
|
+
|
|
32
|
+
## Sample passing response outline
|
|
33
|
+
- Locale + time + weather header
|
|
34
|
+
- Atmosphere + sky line
|
|
35
|
+
- Camera row
|
|
36
|
+
- FG / MG / BG layers
|
|
37
|
+
- Focal subject
|
|
38
|
+
- Asset list
|
|
39
|
+
- Next: handoff named
|
|
40
|
+
|
|
41
|
+
## Sample failing response outline
|
|
42
|
+
- "Wide shot of a city"
|
|
43
|
+
- No time / weather
|
|
44
|
+
- No depth layers
|