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

4.0 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 public model: blender/samford-solarpunk-wind-tour-v009.blend. It derives from distributable v007; earlier binaries remain historical.

  • 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. The Buddha remains in v009.

  • 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.

  • Historical licensed revision v008 is in the PRIVATE archive /home/marcus/projects-private/samford-valley-home-v008. It contains the licensed 7K Studio Tesla and daylight Unreal scene. Public binaries remain v007. Never publish embedded Tesla geometry; see the v008 decision.

  • Do not export Blender volume-only haze as an opaque Unreal mesh. The v007 enclosing haze cube blocked sunlight and was removed in v008. Match Unreal imported material slots by name, not index. Use explicit look-at rotations or keyword Rotator arguments; confirm the sun forward vector points down.

  • Latest revision is v009. Public Blender is based on v007; private Blender with the licensed Tesla is at /home/marcus/projects-private/samford-valley-home-v009/. Never publish that private binary.

  • Preserve the wind turbine detailed and FAST copies, provisional (-36,40) concept location, and chapter 32 (32 chapters, 160 seconds). The 18 m hub and 6 m rotor are visual placeholders, not engineered dimensions or a product selection.

  • Current plan: plans/concept/wind-turbine-plan-v009.svg. Unreal and the v007 film do not yet contain the turbine. Read the v009 decision before editing.