design-os-3d-blender

Blender-native modeling, reusable components and evidence-based delivery. This repository contains agent skills, engineering reading packs, execution tools, verification gates and worked builds for Blender 5.2 LTS.

Image galleries · Reconstruction workflow · Session lessons · Quick start · Tools and skills

The opening GIF shows complete-component overviews of the robot arm, watch winder and five ORC components. Images contain no added captions or banners. Names, development status and evidence limits live in the surrounding documentation. Media provenance.

Image galleries

Each gallery separates overall views from the component’s available detail views. ORC images are derivatives of native renders; their source models are not included in this public checkout. Robot-arm and watch-winder worked builds are included under builds/.

Geothermal ORC components

The current plant layout uses an illustrative 1:15 scale. Catalogue dimensions and installation manuals support specific modeling decisions; they do not establish a selected vendor package, plant capacity or as-built engineering design. A component gallery is not evidence that the complete site has been integrated or qualified.

Mechanical products

Reusable parts

Instrument families and mounting details show the shared parts used across larger assemblies. Reuse requires a defined local origin, mounting interface, supported parameters and verification in the receiving assembly.

What the component work taught us

1. Specify the construction. A wheel, cabinet or gauge name is an inventory item. A build brief needs profile, thickness, transitions, layers, mounting and a visible condition that would reject the result.
2. Reconcile image and technical evidence. Use the main view for composition and all close-ups for local form. Read applicable drawings and manuals for flow, ports, instrumentation and dimensions; label unknowns and illustrative choices.
3. Qualify reusable families. Prove the first detailed part, then check a real second consumer and its interfaces. Repetition does not qualify a new scale or mounting arrangement.
4. Verify both the artifact and the verifier. A clean mesh or a green report does not prove fidelity. Surprising measurements need a checked numerical method before geometry is changed.
5. Bind delivery to the actual revision. Freeze source, camera and settings; inspect output-density proofs and final originals; preserve old media when geometry changes. Record manual checks and automated gates separately.

Read the complete lessons and next-component procedure, public journal, brief template, and Separator worked example.

The HQ coverage gate validates receipts on its explicit guarded launch route. It does not judge visual likeness or intercept every Blender render. The C05 refresh used a direct renderer after review and approval; its final checks passed, but automated pre-HQ launch protection did not run.

Tools and skills

The .claude/skills directories mirror the local skill sources. Antigravity setup is documented in the setup guide. Vendored img2threejs retains its Apache-2.0 license; production reconstruction uses native Blender geometry.

Quick start

Requirements: Blender 5.2.x, Python 3.10+ and macOS or Linux. Set the Blender binary for your machine. The core host-side tests use the Python standard library.

export BLENDER_BIN=/Applications/Blender.app/Contents/MacOS/Blender
python3 scripts/blender-knowledge.py check
python3 scripts/blender-knowledge.py list
python3 -m unittest discover -s tests/execution
python3 -m unittest discover -s tests/production-gate
python3 -m unittest discover -s tests/hq-coverage

Execute a Blender pass in an isolated process:

bash scripts/headless-run.sh my-pass.py

`` means the absolute path of this checkout. For an interactive session, connect the blender-mcp addon. Then run the same pass through the runtime:

import sys
sys.path.insert(0, "/scripts")
import agent_runtime as rt
rt.run_file("/builds//pass-01.py")

For a printable part, write the spec before detailing:

mkdir -p builds/my-part
cp specs/examples/bracket-m3.spec.json builds/my-part/spec.json
python3 scripts/production-gate.py \
  --scene builds/my-part/part.blend \
  --spec builds/my-part/spec.json \
  --report builds/my-part/gate-report.json

See specification and gate behavior. A digital gate does not establish physical fit, load capacity, pressure, thermal performance or successful printing.

Evidence boundaries

The worked-build READMEs contain detailed receipts and exclusions. The knowledge catalogue also includes small execution examples; the full private ORC development history and source reference images are not shipped.

License

MIT. Vendored dependencies retain their own licenses.