diff --git a/.beans/nuzlocke-tracker-jq50--add-ability-to-end-a-run-successfailure.md b/.beans/nuzlocke-tracker-jq50--add-ability-to-end-a-run-successfailure.md
new file mode 100644
index 0000000..f6c98aa
--- /dev/null
+++ b/.beans/nuzlocke-tracker-jq50--add-ability-to-end-a-run-successfailure.md
@@ -0,0 +1,33 @@
+---
+# nuzlocke-tracker-jq50
+title: Add ability to end a run (success/failure)
+status: todo
+type: task
+priority: normal
+created_at: 2026-02-06T10:22:00Z
+updated_at: 2026-02-06T10:22:34Z
+parent: nuzlocke-tracker-f5ob
+---
+
+Add functionality to mark a Nuzlocke run as completed (success) or failed.
+
+## Requirements
+
+1. **Run status transitions**:
+   - Active → Completed (player beat the game)
+   - Active → Failed (all Pokemon fainted / player gave up)
+
+2. **UI elements needed**:
+   - "End Run" button on run dashboard
+   - Confirmation modal with success/failure choice
+   - Optional: Add notes/summary when ending
+   - Display completion status prominently on ended runs
+
+3. **Backend**:
+   - Endpoint already supports status update via PATCH /runs/{id}
+   - May need to set `completedAt` timestamp when ending
+
+4. **Considerations**:
+   - Should ended runs be editable? (probably lock encounters)
+   - Show run duration (started → completed)
+   - Victory/defeat visual treatment (colors, icons)
\ No newline at end of file