# Linked shoulder v0.8 — local Blender development study

10 September 2026. [Open the study](index.html). The full-body entry remains [musculoskeletal v0.6](../musculoskeletal-v06/index.html). This regional checkpoint does not complete the musculoskeletal or final visual objective.

## What changed

The local Blender 5.2.1 scene contains 83 unchanged source structures: 16 muscle structures, shoulder bones/labra and fixed thoracic skeletal context including costal cartilage. Each side includes four cuff muscles, three deltoid portions and teres major. A seven-bone armature links the clavicle, scapula and humerus to the thorax. Both shoulders can move through an authored raised-arm illustration with an additional inward/outward rotation adjustment. The 0–100% slider is pose progression, not a measured joint range or a fixed scapulohumeral ratio.

The browser carries these Blender transformations through per-structure bone palettes. It preserves actual source tissue assignments, selection, labels, wheel zoom, two-axis viewing, hiding, receiving-bone references and the existing two-stage separation. Fixed rib-cage/spine context can be hidden. Separation and isolated selection now use the current posed muscle bounds: visual review found that resting bounds could send a raised, separated muscle outside the view. The corrected posed framing has an explicit browser check.

The original v0.3 coloured overlay compared two different body models. Its mismatch is a recorded diagnostic finding, not an intended anatomical fit. This study and the full-body v0.6 use the matching-source assembly. They have not warped those surfaces into the older v0.10 body.

## Evidence and limits

[The regional evidence](../../Research/2026-09-10/LINKED_SHOULDER_EVIDENCE.md) separates anatomical movement directions from authored animation values. Pivot/frame estimates and distance-based weights remain provisional. The raised-arm screenshots visibly show deformation/wrapping shortcomings, especially around the deltoid and humeral head. A linked bone chain alone does not make the muscle shape anatomically correct. Further wrapping, contact, attachment and movement calibration are required.

Original source inspection found no UV layers, colour attributes, vertex groups or modifiers on the inspected right cuff meshes. Supraspinatus, subscapularis and teres minor still have zero tendon-assigned faces; infraspinatus has 521. No anatomical tendon boundary has been invented from a material slot or proximity test. Existing tissue faces and source surface ridges are preserved, but verified fibre fields and missing tendon/aponeurosis regions remain unfinished.

Origin / Insertion / Both highlights whole receiving bones and names the anatomical region in text. Exact on-model attachment areas remain disabled. The armature's geometric seed vertices are not verified footprints. This study omits the forearm/hand and many crossing muscles, ligaments and other tissues. Broad body coverage, abdominal corrections, teaching/practice parity and the ten-image visual target remain in scope.

## Checks

Five Blender poses were compared against the exported linear-blend computation across all 83 structures. Maximum mesh deviation was below 0.000407 mm, maximum constrained-seed difference below 0.000402 mm. These are computational residuals, not anatomical accuracy tolerances. Browser matrices agree with Blender reference matrices within 3.43e-7 per element. The final browser run checked linked bones, torso hiding, left-side palette picking, CPU projection, posed separation and framing, neutral reset and 390-pixel layout. No page or HTTP errors. Results and screenshots are retained alongside this review; desktop and mobile views were inspected.

## Reproduce and preserve

Run `tools/blender/build_linked_shoulder_v08.py` through the installed FIT Blender helper, then `tools/build_linked_browser_v08.py`. Run `tools/qa/qa-linked-v08.cjs` against local server 8771; its output directory can be set with `FIT_ANATOMY_QA_OUTPUT`. Preserve the v0.5 source master/geometry/catalogue/study content, v0.7 inspection and v0.6 layout/joint presets. Build inputs remain versioned; generated buffers and Blender scene have release hashes. Source originals and earlier versions are retained.

No purchases or paid services were introduced. This used Blender on this computer. Skills Locker accounts/details remain future integration for Mitch. Local Git has no configured anatomy remote and is not an off-device backup.

Next: correct shoulder muscle deformation and contact around the humeral head, establish missing tissue/attachment boundaries, then carry the method through the other joints while continuing abdominal corrections. Do not polish over anatomical defects.
