decisions_log:
  - question: >
      No PSR-4 (or equivalent) autoloading/namespace convention has been documented
      for `app/`, `site/plugins/*`, and `site/themes/*`. Should that be captured here
      before MILESTONES.yaml is written?
    decision: >
      Yes. PSR-4 namespace mapping:
        - `app` => `SiteWeaver\Core`
        - `site/plugins` => `SiteWeaver\Plugins`
        - `site/themes` => `SiteWeaver\Themes`
        - `site/admin_themes` => `SiteWeaver\AdminThemes`
        - `tests` => `SiteWeaver\Tests`
    rationale: >
      Gives every directory tree a predictable, standard PSR-4 namespace so
      Composer autoloading and MILESTONES.yaml file paths can be derived consistently.