commit d24b1469125c73037cfc1e7d8fc027e2d7f1e171
Author: josemacontrerasp-arch <josemacontrerasp@gmail.com>
Date:   Tue Jun 16 19:39:59 2026 +0200

    Add ALLSHIFT umbrella README
    
    Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..acdbc10
--- /dev/null
+++ b/README.md
@@ -0,0 +1,65 @@
+# ALLSHIFT
+
+> Umbrella repository for **Team SHIFT** — an AI-driven hydrogen microgrid energy-management system for hospitals.
+
+ALLSHIFT is the central hub that ties together the team's repositories, models, data, and planning documents. It links the four clusters — **Energy Management**, **Simulations**, **Business & Economics**, and **AI & Control Systems** — under one roof.
+
+## Mission
+
+Accelerate the transition to resilient, low-carbon energy systems through AI-driven energy management. We develop intelligent control for critical infrastructure that optimizes renewables, storage, hydrogen technologies, and grid interaction — improving reliability, reducing emissions, and increasing efficiency where uninterrupted power matters most.
+
+Founded in 2021 at the TU/e Innovation Space and Neuron (Eindhoven). Case studies: Beth Israel Deaconess Medical Center (BIDMC) and UC San Diego (UCSD).
+
+## The challenge
+
+Hospitals need reliable, uninterrupted power while the grid grows more congested, less predictable, and more weather-dependent. With the Dutch "balancing system" being phased out from 2025, energy returned to the grid is only partially compensated. SHIFT answers with an AI-driven hydrogen microgrid that forecasts hospital demand, optimizes solar and battery use, and controls electrolyzers and fuel cells so every component runs at its full potential.
+
+## System architecture
+
+```
+Forecasters ──► Simulator (Gym-style env) ──► RL / rule-based controller
+ (PV, demand,      wraps physical models       (dispatch policy)
+  price)           PV · battery · PEM             │
+      ▲            electrolyser · PEM fuel         ▼
+      │            cell · H2 tank · grid       KPIs: unmet critical load ≈ 0,
+   weather/                                    cost (€), CO₂, curtailment
+   market data                                     │
+                                                    ▼
+                                          Business & Economics analysis
+```
+
+**Dispatch priority cascade:** PV → battery → hydrogen (fuel cell discharge / electrolyser charge) → external grid. Critical hospital load is always prioritised ("critical load is sacred").
+
+## Repositories
+
+| Repo | Purpose |
+|------|---------|
+| [`.github`](https://github.com/Team-SHIFT-Space/.github) | Organization profile — mission, vision, public face |
+| [`website`](https://github.com/Team-SHIFT-Space/website) | Public site (Astro + Tailwind, Cloudflare Pages) |
+| [`pre_model_01`](https://github.com/Team-SHIFT-Space/pre_model_01) | Modeling sandbox — early model approaches |
+| [`demo-repository`](https://github.com/Team-SHIFT-Space/demo-repository) | GitHub sample template |
+| **ALLSHIFT** | This repo — project hub and documentation index |
+
+## Clusters
+
+- **Energy Management** — hospital load characterisation, PV/solar data, datasets and manuals.
+- **Simulations** — MATLAB/Simulink physical models: PEM electrolyser, PEM fuel cell, hydrogen storage, battery, gravity storage; the dispatch controller.
+- **Business & Economics** — cost and CO₂ accounting, viability analysis.
+- **AI & Control Systems** — forecasting stack and the RL/rule-based control policy.
+
+## Key planning documents
+
+- **Forecasting requirements** — specs for three forecasters:
+  - *PV generation* — LightGBM + Temporal Fusion Transformer ensemble; inputs from KNMI NWP, solar position, clear-sky index.
+  - *Hospital electricity demand* — TFT primary, LightGBM/XGBoost ensemble; ASHRAE Guideline 14 metrics.
+  - *Day-ahead electricity price* — LEAR baseline → NBEATSx / DNN / TFT → ensemble.
+  - Methodology: rolling walk-forward cross-validation, post-2022-crisis training data, readiness for the Oct 2025 15-minute market units (24 → 96 outputs/day).
+- **Simulator Interface Input/Output sheet** — the typed contract between the simulator and everything that talks to it (controller, validation layer, economics): conventions, static config, per-timestep inputs/setpoints, outputs and KPIs, priority rules.
+
+## Status
+
+Early development. Physical models and planning specs are in place; the simulator environment, forecasters, and control policy are being built out.
+
+## Contact
+
+`info@shifthydrogen.nl`