Update directory structure documentation to reflect new cooldown organization

Author: orangekame3

docs/guide/directory-structure.md

@@ -10,24 +10,25 @@ my-cryo-data/
 │   ├── readout_send_module.yaml # Readout send line module template
 │   └── readout_return_module.yaml # Readout return line module template
 ├── <cryo-name>/
-│   ├── chip.yaml                # Chip information
-│   ├── current/                 # Working cooldown
-│   │   ├── metadata.yaml
-│   │   ├── control.yaml
-│   │   ├── readout_send.yaml
-│   │   └── readout_return.yaml
-│   └── <YYYY-NNN>/             # Snapshot
-│       ├── metadata.yaml
-│       ├── control.yaml
-│       ├── readout_send.yaml
-│       └── readout_return.yaml
+│   └── <YYYY>/                  # Year group
+│       ├── cd001/               # Cooldown directory
+│       │   ├── metadata.yaml
+│       │   ├── chip.yaml
+│       │   ├── components.yaml  # Per-cooldown (optional)
+│       │   ├── control.yaml
+│       │   ├── readout_send.yaml
+│       │   ├── readout_return.yaml
+│       │   └── cooldown.yaml    # Resolved bundle
+│       └── cd002/
+│           └── ...
 ```
 
 ## Key Concepts
 
 - **`components.yaml`** **(required)** — Shared component catalog defining all RF/microwave parts used in wiring configurations. All components must be registered here and referenced by key name in wiring files
 - **`templates/`** — Module templates that define default stage configurations per line type. Each template file uses the same format as the `modules` section in wiring files, so they can be imported and shared across cooldowns
-- **`current/`** — The active cooldown configuration being worked on
-- **`<YYYY-NNN>/`** — Immutable snapshots of past cooldowns (e.g., `2026-001`)
+- **`<YYYY>/`** — Year group directory (e.g., `2026`)
+- **`cdNNN/`** — Cooldown directory with auto-incrementing ID (e.g., `cd001`, `cd002`)
 - **`chip.yaml`** — Chip metadata (name, number of qubits)
 - **`metadata.yaml`** — Cooldown metadata (ID, date, cryo, operator, purpose)
+- **`cooldown.yaml`** — Resolved bundle with all modules expanded and components resolved

docs/index.md

@@ -44,14 +44,16 @@ my-cryo-data/
 │   ├── readout_send_module.yaml
 │   └── readout_return_module.yaml
 ├── <cryo-name>/
-│   ├── chip.yaml                # Chip information
-│   ├── current/                 # Working cooldown
-│   │   ├── metadata.yaml
-│   │   ├── control.yaml
-│   │   ├── readout_send.yaml
-│   │   └── readout_return.yaml
-│   └── <YYYY-NNN>/             # Snapshot
-│       └── ...
+│   └── <YYYY>/                  # Year group
+│       ├── cd001/               # Cooldown directory
+│       │   ├── metadata.yaml
+│       │   ├── chip.yaml
+│       │   ├── control.yaml
+│       │   ├── readout_send.yaml
+│       │   ├── readout_return.yaml
+│       │   └── cooldown.yaml    # Resolved bundle
+│       └── cd002/
+│           └── ...
 ```
 
 Use [cryo-wiring/template](https://github.com/cryo-wiring/template) to get started quickly.