marcus/samford-valley-home
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
ac5407f073b9867b07660e6e0fac47db9520061a
samford-valley-home/AGENTS.md

2.8 KiB
Raw Blame History

Working on the Samford Valley home

Read README.md, docs/PROJECT-CONTEXT.md, docs/REQUEST-HISTORY.md and the latest decision record before editing.

  • Current model: blender/samford-solarpunk-presentation-tour.blend, version 007.

  • The table-tennis deck was explicitly removed. Do not restore it from older scenes.

  • Future child/dwelling pavilions remain ghost outlines. The one built small pavilion is a meditation room.

  • Preserve the detailed kitchen, reading library, bedroom sleep setup, sauna, shower, solar, tanks, Starlink, homelab, Tesla garage, training and food-growing features.

  • Keep new layout geometry, plan coordinates, fast display copies, tour cameras and captions consistent.

  • Blender collections: DETAIL is full editable render geometry; FAST TOUR is the simplified viewport. A hidden DETAIL collection can have stale matrix_world values during scripting; explicitly construct transforms or evaluate the collection before applying them.

  • Incremental source scripts depend on particular prior models. Do not run the whole script history against the current scene; it would duplicate or misplace geometry. Read each script and choose its expected starting model first.

  • Validate saved .blend content and inspect actual renders before claiming a scene edit is finished.

  • Store a dated decision and a Git commit for intentional revisions. Preserve earlier model versions unless a cleanup is explicitly requested.

  • Marcus authorised making the repository, working files and design context public. The separate website gallery contains selected images and concept notes.

  • This is an illustrative, unsurveyed concept. Do not label materials, engineering, equipment loads, costs or property compliance as verified when they are not.

  • No need to create Linear issues unless Marcus explicitly asks.

  • Current water storage is a container-style enclosure with two sealed internal tanks. Do not restore the old exposed cylinders from earlier scene files.

  • Preserve the garden Buddha north of the meditation room and its chapter 31 tour stop. Latest scene is version 007.

  • v007 has a separate client cinematic and an actual whole-site Unreal walking project at unreal/SamfordHomestead. Do not describe Unreal as meditation-only anymore. Read walkthroughs/CLIENT-PRESENTATION-V007.md.

  • Never attach evaluated temporary Blender material IDs to persistent meshes: resolve materials through bpy.data.materials by name. Invalid evaluated references caused a save-time crash during this revision and were fixed.

  • Test Unreal collision in a fully initialized play world; editor startup traces can run before physics is ready. Set complex-as-simple collision, refresh the mesh section and save.

  • Bedroom bed is to be built into the wall, rigid and quiet, not a free-standing frame. Recorded in decisions/2026-09-11-bed-wall-integrated.md and still to be modelled.