docs: Add comprehensive bootupd integration and bootloader management documentation

- Added detailed explanation of what bootupd is and how it works
- Documented bootupd vs GRUB2 strategy in particle-os
- Explained bootupd architecture and required components
- Added future bootupd stage implementation examples
- Documented bootupd vs bootc relationship and integration
- Added migration path from GRUB2 to bootupd
- Included bootupd in CI/CD pipeline examples
- Added future roadmap for bootupd integration

This provides users with complete understanding of current bootloader
implementation and future direction for modern OSTree systems.

README.md

@@ -57,8 +57,6 @@ particle-os extends osbuild with **10 Debian-specific stages** and **Debian-spec
 
 ## 🔗 osbuild and bootc-image-builder Integration
 
-### What is bootc-image-builder?
-
 **bootc-image-builder** is a tool that uses osbuild to create bootable container images that can be deployed using bootc. It provides a higher-level interface for building OSTree-based systems with container-native booting capabilities.
 
 ### How They Work Together
@@ -91,6 +89,158 @@ bootc-image-builder build \
   debian-ostree.json
 ```
 
+## 🔧 bootupd Integration and Bootloader Management
+
+### What is bootupd?
+
+**bootupd** is a modern bootloader management system designed for OSTree-based systems. It handles A/B partition updates for atomic upgrades and provides a unified interface for managing bootloader components across different architectures and platforms.
+
+### bootupd vs GRUB2 in particle-os
+
+particle-os currently implements **GRUB2** as the primary bootloader, but **bootupd** represents the future direction for modern OSTree systems:
+
+#### **Current Implementation: GRUB2**
+- **Stage**: `org.osbuild.debian.grub2`
+- **Purpose**: Traditional bootloader with UEFI support
+- **Features**: Menu-based boot selection, kernel parameter management
+- **Use case**: Traditional systems, compatibility, legacy support
+
+#### **Future Implementation: bootupd**
+- **Purpose**: Modern bootloader management for OSTree systems
+- **Features**: A/B partition updates, atomic bootloader upgrades
+- **Use case**: Modern container-native systems, atomic updates
+
+### How bootupd Works with particle-os
+
+```
+OSTree System → bootupd → A/B Boot Partitions → Atomic Bootloader Updates
+      ↓           ↓              ↓                        ↓
+  System tree  Bootloader   Dual partitions        Safe rollbacks
+  updates      management   (current/next)        and upgrades
+```
+
+### bootupd Architecture in particle-os
+
+#### **Required Components**
+1. **bootupd package** - Core bootloader management
+2. **A/B partition layout** - Dual boot partitions for atomic updates
+3. **EFI system partition** - UEFI bootloader storage
+4. **OSTree integration** - System tree and bootloader coordination
+
+#### **Mount Points Required**
+```
+/boot/efi     - EFI system partition
+/boot         - Boot partition (kernel, initrd)
+/             - Root filesystem (OSTree)
+```
+
+### bootupd Stage Implementation (Future)
+
+When implemented, the bootupd stage would look like:
+
+```json
+{
+  "name": "org.osbuild.debian.bootupd",
+  "options": {
+    "enable": true,
+    "efi_partition": "/dev/sda1",
+    "boot_partition": "/dev/sda2",
+    "config": {
+      "auto_update": true,
+      "rollback_enabled": true,
+      "a_b_partitions": true
+    }
+  }
+}
+```
+
+### bootupd vs bootc Relationship
+
+#### **bootc (Container-native bootloader)**
+- **Purpose**: Container-native OS management
+- **Scope**: OS-level container operations
+- **Integration**: Works with bootupd for bootloader management
+
+#### **bootupd (Bootloader management)**
+- **Purpose**: Bootloader component management
+- **Scope**: Boot partition and EFI management
+- **Integration**: Provides bootloader services to bootc
+
+### Current particle-os Bootloader Strategy
+
+#### **Phase 1: GRUB2 Implementation (Current)**
+- ✅ **Implemented**: Complete GRUB2 stage with UEFI support
+- ✅ **Tested**: Thoroughly tested and validated
+- ✅ **Production ready**: Stable and reliable for current deployments
+
+#### **Phase 2: bootupd Integration (Future)**
+- 🔄 **Planned**: bootupd stage implementation
+- 🔄 **Architecture**: A/B partition support
+- 🔄 **Integration**: bootc + bootupd coordination
+
+### When to Use Each Bootloader
+
+#### **Use GRUB2 When:**
+- Building traditional Debian systems
+- Need legacy compatibility
+- Require menu-based boot selection
+- Working with existing infrastructure
+- Need immediate production deployment
+
+#### **Use bootupd When:**
+- Building modern OSTree systems
+- Require atomic bootloader updates
+- Need A/B partition support
+- Working with container-native deployments
+- Building future-proof systems
+
+### Migration Path
+
+#### **From GRUB2 to bootupd**
+1. **Update manifest** to include bootupd stage
+2. **Modify partition layout** for A/B support
+3. **Update bootc configuration** for bootupd integration
+4. **Test thoroughly** before production deployment
+
+#### **Hybrid Approach**
+- **Keep GRUB2** for current systems
+- **Add bootupd** for new deployments
+- **Gradual migration** as systems are updated
+
+### bootupd in CI/CD Pipelines
+
+When bootupd is implemented, it will integrate seamlessly with existing CI/CD workflows:
+
+```yaml
+# Future GitHub Actions with bootupd
+- name: Build Debian OSTree with bootupd
+  run: |
+    osbuild examples/debian-bootupd-ostree.json
+    
+- name: Test bootupd functionality
+  run: |
+    # Test A/B partition updates
+    # Verify atomic bootloader upgrades
+    # Validate rollback capabilities
+```
+
+### Future Roadmap
+
+#### **Short Term (Current)**
+- ✅ GRUB2 implementation complete
+- ✅ Traditional bootloader support
+- ✅ Production-ready bootable images
+
+#### **Medium Term (Next Release)**
+- 🔄 bootupd stage implementation
+- 🔄 A/B partition support
+- 🔄 Atomic bootloader updates
+
+#### **Long Term (Future)**
+- 🔮 Full bootupd integration
+- 🔮 Advanced A/B partition management
+- 🔮 Seamless bootc + bootupd coordination
+
 ## 🚀 Quick Start
 
 ### 1. Installation