Files
samford-valley-home/AGENTS.md

30 lines
3.4 KiB
Markdown

# 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.
- Latest working revision is v008 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.