# Phase 22: Add-from-Catalog & Thread Integration - Discussion Log

> **Audit trail only.** Do not use as input to planning, research, or execution agents.
> Decisions are captured in CONTEXT.md — this log preserves the alternatives considered.

**Date:** 2026-04-06
**Phase:** 22-add-from-catalog-thread-integration
**Areas discussed:** Add-to-Collection Confirmation UX, Add-to-Thread Flow, Post-Add Behavior, Thread Selection Context
**Mode:** --auto (all defaults auto-selected)

---

## Add-to-Collection Confirmation UX

| Option | Description | Selected |
|--------|-------------|----------|
| Compact modal dialog | Small modal with category picker, notes, purchase price, and confirm button | ✓ |
| Inline card expansion | Expand the card in-place to show form fields | |
| Full-page form | Navigate to a dedicated add page | |

**User's choice:** [auto] Compact modal dialog (recommended default)
**Notes:** Aligns with existing modal patterns (CreateThreadModal). Minimal friction — one confirmation step as specified in success criteria.

---

## Add-to-Thread Flow

| Option | Description | Selected |
|--------|-------------|----------|
| Thread picker dropdown in modal | Modal with dropdown of active threads, instant candidate creation | ✓ |
| Auto-add to most recent thread | Skip selection, add to last-used thread | |
| Thread list with search | Full thread list with search filtering | |

**User's choice:** [auto] Thread picker dropdown in modal (recommended default)
**Notes:** Active threads are typically few, so a simple dropdown suffices. Includes empty state handling when no threads exist.

---

## Post-Add Behavior

| Option | Description | Selected |
|--------|-------------|----------|
| Success toast, stay in search | Brief notification, user continues browsing | ✓ |
| Navigate to the item/thread | Redirect to the newly created item or thread | |
| Close overlay | Dismiss search overlay after add | |

**User's choice:** [auto] Success toast, stay in search (recommended default)
**Notes:** Supports adding multiple items in one session — common use case when researching gear.

---

## Thread Selection Context

| Option | Description | Selected |
|--------|-------------|----------|
| Create thread when first candidate added | Combined modal: thread creation + first candidate in one step | ✓ |
| Create thread first, then search | Require thread creation before entering search | |
| Always show thread picker | No special first-add flow | |

**User's choice:** [auto] Create thread when first candidate added (recommended default)
**Notes:** Seamless flow — user finds an item first, then names the thread. Subsequent adds in same session default to the just-created thread.

---

## Claude's Discretion

- Modal animation and layout proportions
- Category auto-selection logic
- Toast notification pattern
- Thread picker display details
- Field ordering in modals
- Purchase price input formatting

## Deferred Ideas

- Manual entry fallback (Phase 23)
- Bulk add multiple items
- Quick one-tap add without confirmation
- Quantity selection during add
