TheLastGarden/.planning/phases/02-season-1-vertical-slice-soil/02-DISCUSSION-LOG.md

Phase 2: Season 1 Vertical Slice (Soil) - 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-05-09 Phase: 2 — Season 1 Vertical Slice (Soil) Areas discussed: Garden geometry & input · Time density (growth + offline) · Lura's Season 1 arc shape · Letter-from-the-garden composition · Begin screen treatment · Memory Journal access + layout · Visual placeholder treatment for plants · Phase 2 Settings UI scope

---

Garden Geometry & Input

Garden shape

Option	Description	Selected
Small fixed grid (4×4 = 16 tiles)	Intimate walled-garden feel; matches cozy/contemplative tone and Phase 2 minimum-viable bias.	✓
Medium fixed grid (6×6 = 36 tiles)	More room to experiment and more strategic depth, but Season 1 will feel emptier with sparse early plantings and authored-content scope grows.
Freeform / non-grid (5–7 named planting points)	Bespoke, painterly walled-garden feel. More work upfront and harder to cleanly extend in Seasons 2+.

Seed placement input

Option	Description	Selected
Click empty tile → inline seed picker	Clicking an unoccupied tile pops a small inline picker. Honors UX-01 'no UI clutter'.	✓
Persistent seed sidebar + click empty tile	More discoverable but introduces a permanent UI element that fights the A Dark Room rule.
Drag-from-inventory to tile	Tactile, but more failure modes and more Phase 3 polish to feel right.

Plant type count

Option	Description	Selected
2–3 plant types	Player exercises real choice; small enough to author + concept-art under Phase 2's minimum-viable bias.	✓
Just 1 plant type	Most minimum-viable possible; risks slice feeling like a single-mechanic demo.
4–6 plant types	Richer Season 1 with more variety, but ≈4× the authored-content + concept-art surface.

Seed supply

Option	Description	Selected
Infinite seeds from start	Anti-FOMO; meaningful constraint is time, not seed inventory.	✓
Harvest yields seeds + fragment	Adds a light economy; risks turning the cozy slice into a resource-management loop.
Limited starter seeds + replenish via composting	Couples composting and planting tightly; risks player feeling soft-locked.

Plant unlock progression

Option	Description	Selected
First plant from start, others unlock by fragment-count	Drip-feeds discovery without ceremony.	✓
All available from start	Simplest sim; loses small but real beat of progression.
Unlocks tied to specific authored fragments	Most narrative; brittle if deterministic selector reorders things.

Empty tile look in Phase 2

Option	Description	Selected
Faint outlined tile + subtle hover state	Readable but unembellished; Phaser primitive; no asset work.	✓
Visible 'empty plot' placeholder texture	More legible at a glance, but bakes in a visual Phase 3 will throw away.
Invisible tiles (only become visible on hover)	Maximum tonal restraint; risks confusing first-time players.

Post-harvest tile state

Option	Description	Selected
Returns to empty + brief acknowledgement	Fastest loop, cleanest sim, honors cozy 'release' feel.	✓
Leaves a 'spent' state for a short cooldown	Adds an extra plant lifecycle state to sim and save schema.
Fragment must be 'taken to the journal' first	Tactile but couples sim and UI tightly and adds dangling state.

---

Time Density (Growth + Offline)

First-plant growth duration in active play

Option	Description	Selected
~2–5 minutes	Cozy but watchable; lets a playtest session complete the loop in ~10 minutes.	✓
~30 seconds – 2 minutes	Demo-pace; reads less 'idle'.
~15–60 minutes	True idle; hard to playtest end-to-end without a debug fast-forward.
~6–12 hours (long-form idle)	Anchors 24h cap; risks empty active play; demands strong return-screen.

Per-plant duration variance

Option	Description	Selected
Vary (short / medium / longer) within band	Real time-vs-yield tradeoffs; tonal identity per plant.	✓
All identical growth times	Simplest sim; loses 'patience-is-rewarded' beat.
All identical for Phase 2; vary later	Avoids re-litigating; means Season 1 plants feel interchangeable.

Ready-state behavior

Option	Description	Selected
Auto-harvest during offline; manual in active play	Cleanest idle-game shape; lets the letter tell a story.	✓
Wait indefinitely — manual always	Maximum agency; offline payoff feels thin.
Decay if unharvested past a threshold	Adds tension and soft FOMO undercurrent — likely runs into anti-FOMO doctrine.

24h offline cap surfacing

Option	Description	Selected
Capped silently in the letter's voice	Anti-FOMO; tonally consistent.	✓
Explicit cap notice in the letter	Honest about the cap; risks reading as a system message.
Cap silently and never mention it	Cleanest tone; player returning after 3 days might be confused.

---

Lura's Season 1 Arc Shape

Lura form

Option	Description	Selected
Discrete visits at the gate	Bounded each visit; matches bible's 'she appears at the garden gate' framing.	✓
Single ongoing text-message thread	More 'friend texting,' but loses gate-arrival beat.
Hybrid: gate + occasional texts between visits	Two narrative-state mechanisms; risks Phase-2 scope creep.

Beat count

Option	Description	Selected
3 beats: arrival · mid · farewell	Tight Season 1 arc; small authoring surface; load-bearing for tone.	✓
5 beats (arrival, two mid, late, farewell)	More texture; doubles authoring + Ink-state plumbing surface.
Just 1 arrival beat in Phase 2	Simplest; Season 1 loses tonal anchor and prologue feels unfinished.

Beat gating

Option	Description	Selected
Fragment count thresholds (1st / 4th / 8th harvest)	Simple, content-coupled, robust to varying play sessions. STRY-10 satisfied.	✓
Specific authored-fragment IDs unlock specific beats	Most narratively rich; brittle if selector reorders things.
Pure tick-count thresholds	Cleanest against STRY-10; least responsive to player action.

Beat-fire UX

Option	Description	Selected
Subtle gate indicator + player-initiated visit	Honors A Dark Room rule and player's pace.	✓
Auto-opens dialogue when beat fires	Disrupts gardening flow; less cozy.
Queues silently; player finds Lura by clicking gate when curious	Most A-Dark-Room; risks player missing all 3 beats.

---

Letter-from-the-Garden Composition

Composition method

Option	Description	Selected
Authored skeleton + templated insertions	Best balance of voice and reactivity.	✓
Fully procedural from event-log templates	Risks tonal drift; voice depends on templates not authoring.
Fully hand-authored prose, conditional inclusion only	Maximum voice control; least reactive.

Authoring format

Option	Description	Selected
Ink (.ink files in /content/dialogue/)	Reuses STRY-06 stack — one runtime path, one tooling path.	✓
Markdown with frontmatter (in /content/letters/)	Aligns with fragment authoring; adds a second narrative-rendering path.
Both — Ink for branching, Markdown for prose passages	Maximum power; introduces a third loader path.

Offline event log scope

Option	Description	Selected
Compact summary (counts + IDs of bloomed/harvested + any unfired Lura beat)	Compact, sufficient, bounded in size.	✓
Full ordered timeline (every state transition with timestamp)	Most powerful; biggest schema surface and storage cost.
Just last/biggest event(s)	Smallest schema; letter has less to say across multiple returns.

Letter UX (when shown / dismiss)

Option	Description	Selected
On return after ≥5 minutes; full-screen overlay; one tap to dismiss	Avoids letter-spam; full-screen honors tonal weight.	✓
Always show on tab return regardless of duration	Most consistent; risks feeling intrusive.
Inline pane (slides in from a corner)	Less disruptive; loses 'sit with this' tonal beat.

---

Begin Screen Treatment

Phase 2 vs Phase 3 split

Option	Description	Selected
Tasteful placeholder; Phase 3 paints	Honors no-aesthetic-polish bias; avoids Phase 3 rework.	✓
Real painted gesture-gate now	Strongest first impression today; pulls Phase 3 work earlier and risks scope creep.
Title text only (no visual treatment)	Most-A-Dark-Room; risks reading as unfinished.

Subsequent-load behavior

Option	Description	Selected
Every load (browser autoplay policy demands it)	Honest with browser constraints; Recommended option.
Only first run; subsequent loads skip to garden + audio enables on first interaction	Smoother return; brief silent moment until first interaction.	✓
Only first run; explicit 'enable sound' prompt later	Two surfaces to maintain; risks system-message feel.

Notes: User picked the smoother-return path, accepting the brief silent moment until the first interaction as a worthwhile tradeoff for cozy pacing. CORE-05 + AEST-07 are both still satisfied — the gesture happens on first run; subsequent loads use any first interaction as the gesture.

---

Memory Journal Access + Layout

Open mechanism

Option	Description	Selected
Small persistent icon + keyboard shortcut	Most discoverable without violating UX-01; Recommended option.
Reveals after first harvest, then persistent	Most A-Dark-Room (UI grows as player progresses).	✓
Hidden until journal hotkey is discovered	Maximum tonal restraint; high risk players miss it.

Layout

Option	Description	Selected
Slide-in side panel; click a fragment to expand inline	Garden stays visible; lets player feel rooted; Recommended option.
Full-screen modal overlay; back button to return to garden	More tonal weight per visit; player can't see plants ripening while reading.	✓
Dedicated 'journal view' you navigate to, like a separate room	Most narratively rich; biggest implementation lift.

New-fragment surfacing in active play

Option	Description	Selected
Immediate full-text reveal modal; dismiss to return to garden	Honors harvest as a small event; creates a memorable beat.	✓
Quiet deposit — small acknowledgement, find it in journal later	Most A-Dark-Room; risks player never reading the prose.
Inline reveal at the harvested tile; tap to dismiss	Tactile but fragile (DOM positioned over Phaser canvas resizes).

---

Visual Placeholder Treatment for Plants

Plant look per growth stage

Option	Description	Selected
Simple Phaser-primitive shape per stage, single color per type	No PNG asset work; firewall stays clean; Phase 3 swaps in painted sprites.	✓
Programmer-art sprite per stage per plant (PNG placeholders)	Differentiates more legibly; produces throwaway assets that go through provenance gate.
Text labels at the tile instead of any visual	Most A-Dark-Room; reads as severe.

Ready-state cue

Option	Description	Selected
Subtle glow / pulse on ready tiles	Reads at a glance without text; Phase 3 paints over with warmer light.	✓
Bright color shift on the placeholder shape	Most legible; bakes a specific color Phase 3 will rework.
Text indicator at tile ('ready')	Very explicit; least cozy.

---

Phase 2 Settings UI Scope

Settings UI scope

Option	Description	Selected
Save management only (Export/Import + Restore prior snapshot)	Smallest scope that completes deferred Phase-1 surfaces; audio + accessibility stay in Phase 8.	✓
Save management + audio sliders	Doesn't fit 'no aesthetic polish' framing; risks dragging in keyboard nav and accessibility.
No settings menu at all in Phase 2	Smallest Phase-2 lift; deferred items still aren't player-reachable.

Access

Option	Description	Selected
Small icon in a corner of the main view + keyboard shortcut	Same restraint pattern as Memory Journal affordance.	✓
Hidden in a 'cog' on Begin screen + accessible from Lura's gate	Risks burying critical save-recovery affordances.
Only accessible via hotkey (no visual affordance)	Risks players losing access to save recovery in a crash recovery moment.

navigator.storage.persist() outcome surfacing

Option	Description	Selected
One-time soft toast on first save if denied; nothing if granted	Honors UX-01 + cozy tone; respects 'surfaces the result respectfully'.	✓
Always show 'persistent storage: yes/no' indicator in Settings only	Player won't know save is at risk if persistence denied.
Modal dialog if denied	Strongest call to attention; reads anti-cozy.

---

Claude's Discretion

Areas where the user explicitly deferred to implementation choice (full list in CONTEXT.md <decisions> § "Claude's Discretion"):

• Specific growth-duration values per plant within the 2–5min band.
• Exact fragment-count thresholds for plant unlocks and Lura beats (model is locked, values may shift ±1–2 in playtest).
• Form of the post-harvest acknowledgement beat (text / particle / pause).
• Form of Lura's gate indicator on beat-unlock.
• Tick rate / sim cadence (likely 4–10Hz).
• Internal Zustand store slice shapes.
• Internal Phaser scene tree.
• Specific copy of Begin screen, persistence-denied toast, post-harvest acknowledgement (must match bible voice; user reviews).
• e2e fast-forward mechanism (hidden hotkey vs URL flag vs sim-clock injection).
• Memory Journal empty-state copy.

Deferred Ideas

Items mentioned during discussion that belong in other phases (full list in CONTEXT.md <deferred>):

• Hybrid Lura presence (gate + ambient drip) — possibly Phase 4+.
• Plant-type unlocks tied to specific authored fragments — possibly Phase 4+.
• Fully procedural letter from event-log templates — reconsider if slot vocabulary too small in playtest.
• Audio sliders, keyboard nav, browser-zoom guarantees, color-redundant icons, tab-title bloom, Lura-not-numbers UX — Phase 8.
• Visual regression for asset library — Phase 8.
• Roothold prestige, Season transitions, die-off, finite ceiling enforcement, cross-pollination — Phase 4.
• Memory Storms, place-memory vignettes, Nameless Man's full arc — Phase 5.
• The Below, ecosystem planting, the Loom, the Archivist — Phase 6.
• Final binary choice + credits/coda rest state — Phase 7.
• Watercolor post-process, painted plants, painted Begin screen, solo cello + ambient buses, reduced-motion toggle — Phase 3.
• Real production-volume AI assets + locked north-star reference set — Phase 5 (Phase 1 IOU AEST-09).
• Real migrate_v1_to_v2 — Phase 4 (when Roothold lands). Phase 2 only extends V1Payload shape.
• Compost yielding seeds back — rejected; Phase 4's cross-pollination is the proper place for seed-as-economy.
• Persistent Settings element on Begin screen — rejected in favor of in-garden corner icon + hotkey.