Technical diary

D071 newproposedArchitectureDecision26 Jun 2026

Modular architecture plan - split generator into focused modules

As the codebase grows toward 10k lines, the monolithic generator script should be split into focused modules: gaad_shapes.py (shape creation), gaad_genome.py (mutation and scaling), gaad_data.py (JSON read/write), gaad_generator.py (thin orchestrator/main loop). A shared geometry/diff module should also be created to resolve D052 (metrics duplication between tree and report). The addon-generator coupling via scene properties should be reviewed for robustness.

D072 rebirthadoptedUXDecision26 Jun 2026

No coming soon labels in the UI

The GAAD panel must never show placeholder text such as "coming soon". If a feature is not yet built, it is simply absent from the panel. Unbuilt features belong in the records (as Feature Requests or Decisions), not in the live UI.

D073 rebirthadoptedUXDecision26 Jun 2026

Hide Reset GAAD Platform button in Design Evolution scene

The Reset GAAD Platform button must not be shown when the user is in the GAAD Design Evolution scene. Resetting from that scene causes new stages to be generated there instead of in GAAD Generator. Fix: suppress the button entirely when scene.name == GAAD Design Evolution.

P034 MilestoneMoment26 Jun 2026

First 1994 vs Rebirth feature audit - 19 of 41 original features covered

A full audit of the 1994 GAAD thesis features against Rebirth 2026 was conducted, prompted by concern about building new capabilities (stairs, buildings, garden rooms) on top of incomplete foundations. Of 41 original features across 7 categories: 19 are covered, 6 are partial, 16 are missing. The biggest gap is Navigation and Tracking (0 of 5 covered) - backtrack, forward track, right back, track decision point, and seed storage. These are the 4th dimension features that define GAAD as a design memory platform, not just a generator. Decision: consolidate the core 1994 feature set before expanding to new architectural generators. Priority order: seed storage (D030) → backtrack/forward track (F006) → global gene settings → isolate stage (F004) → orthogonal rotation (F005).

F001 openTestingFeature26 Jun 2026

Auto Testing Environment

An automated way to test GAAD script changes without manually running through the full Blender workflow each time. Would allow rapid validation of generator, tree, and addon changes, catching regressions before they reach a bundle zip.

F002 openBrandingFeature26 Jun 2026

GAAD Logo in HTML Records

Update all HTML record pages to include the GAAD logo image (gaad_logo_white.png on dark pages). Currently all pages use the text "GAAD" as a logo placeholder. Needs doing across all six HTML files.

F003 openToolingFeature26 Jun 2026

generate_handover.py

A script that auto-writes HANDOVER.md from the JSON records at the end of each session. Covers current bundle version, open decisions, latest script versions, sensible next steps, and recent pivotal moments. Removes the need to manually update the handover note daily.

F005 adoptedGenomeFeature26 Jun 2026

Orthogonal Rotation Only

Option to constrain primitive placement to orthogonal rotations only (0, 90, 180, 270 degrees). When enabled, primitives on each stage are placed at right-angle increments only, giving a cleaner, more architectural feel to the generated designs. Implemented in generator v0_24 and addon v0_43 as a toggle in the Object Collection panel.

F007 openGenomeFeature26 Jun 2026

Genetic Engineering - Inject New Cells

A forward search mechanism that allows the user to artificially accelerate the design toward a goal - called Genetic Engineering (GE) in the 1994 thesis (Fig 3.18, 3.19). Unlike natural mutation which follows the evolutionary path, GE introduces a break in the genetic tree by injecting new cells / a micro phenotype directly. Example from 1994: setting rotation to 10 degrees globally, then using GE to change this gene - the desired outcome can be achieved much faster. GE is an unnatural adjustment and an interference with the evolutionary process, but allows quite radical changes to the evolutionary path. In the algorithm (Fig 3.19), a genetic engineer decision point sits inside the genetic loop - if yes, inject new cells and engineer genes, then re-enter the loop. Severe GE may cause previously recognised features in past generations to be lost (break in genetic tree). This is a future capability once the core backtrack (F006) and seed storage (D030) are in place.