Files
GearBox/.planning/phases/22-add-from-catalog-thread-integration/22-DISCUSSION-LOG.md

80 lines
3.0 KiB
Markdown

# 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