first commit

agent/ADRs/0011-build-release-hello-pear-electron.md

@@ -0,0 +1,32 @@
+# ADR-0011: Build and release via hello-pear-electron patterns
+
+- **Status:** Superseded in primary path by [ADR-0013](./0013-bare-pear-only-runtime-and-distribution.md) (Bare/Pear standalone + pear stage)
+- **Date:** 2026-07-30
+- **Superseded:** 2026-07-30
+
+## Context
+
+Distribution must support multi-platform installs and P2P OTA updates without central app stores as a hard requirement. Originally Electron Forge was assumed.
+
+## Decision (historical)
+
+Copy **hello-pear-electron** patterns (Electron Forge makers, make-pear-app, etc.).
+
+## Supersession
+
+**Primary product distribution is now Bare/Pear-only** per [ADR-0013](./0013-bare-pear-only-runtime-and-distribution.md):
+
+- `hello-pear-bare` + `bare-build --standalone` for single executables
+- pear stage → seed → provision → multisig for OTA drives
+- Electron Forge is **not** the default CI release path
+
+Pear deploy layers (stage/provision/multisig) and `upgrade` pear links remain valid; only the **shell and binary packing** change.
+
+## Consequences
+
+See ADR-0013.
+
+### Follow-ups
+
+- [ ] Phase 5: bare-build matrix + pear stage (not Electron makers as primary)
+