Moves phases 08–11 execution artifacts from .planning/phases/ to .planning/milestones/v0.2-phases/ to keep .planning/phases/ clean for the next milestone. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
84 lines
3.6 KiB
Markdown
84 lines
3.6 KiB
Markdown
# Phase 11: Visual Design, Responsive Layout & Cleanup - 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-06-16
|
|
**Phase:** 11-visual-design-responsive-layout-cleanup
|
|
**Areas discussed:** Sidebar state, Visual polish depth, Dead code scope
|
|
|
|
---
|
|
|
|
## Existing Plans Gate
|
|
|
|
| Option | Description | Selected |
|
|
|--------|-------------|----------|
|
|
| View existing plans | Show what plans were created before deciding | ✓ |
|
|
| Continue and replan after | Capture context now, then replan | |
|
|
| Cancel | Stop here | |
|
|
|
|
**User's choice:** Viewed plans first, then chose "Continue and replan after"
|
|
**Notes:** User reviewed all 6 existing plans (11-01 through 11-06) before proceeding. Plans looked solid in structure; user wants context captured so plans can be rebuilt with decisions locked in.
|
|
|
|
---
|
|
|
|
## Sidebar State
|
|
|
|
| Option | Description | Selected |
|
|
|--------|-------------|----------|
|
|
| App.vue / AdminLayout.vue refs | Local ref() in layout root. Simple, no store overhead. | |
|
|
| Shared useLayoutStore (Pinia) | One store, two fields. Any component can close the drawer. | |
|
|
| You decide | Researcher picks cleanest option given actual component tree | ✓ |
|
|
|
|
**User's choice:** You decide (Claude's discretion)
|
|
**Notes:** ROADMAP.md pitfall constraint (§Pitfall 8) is locked — state must not live in AppSidebar/AdminSidebar own data(). Researcher will read actual component tree and choose between Pinia store or layout-root ref based on whether child components (e.g., nav links, "Back to app" button) need to close the drawer.
|
|
|
|
---
|
|
|
|
## Visual Polish Depth
|
|
|
|
**Question 1: Ambition level**
|
|
|
|
| Option | Description | Selected |
|
|
|--------|-------------|----------|
|
|
| Discipline only | Fix VISUAL-01..04 only. No visual redesign. | |
|
|
| Polish + subtle refinements | Fix requirements AND allow minor improvements where things look off (shadows, border radius, color tone drift). Still no new palette. | ✓ |
|
|
|
|
**User's choice:** Polish + subtle refinements
|
|
**Notes:** User wants things to look noticeably better where there's clear visual drift, not just mechanically compliant.
|
|
|
|
**Question 2: Known problem areas**
|
|
|
|
| Option | Description | Selected |
|
|
|--------|-------------|----------|
|
|
| No, let the researcher find them | Systematic full audit | ✓ |
|
|
| Yes, I have specific complaints | User would specify targets | |
|
|
|
|
**User's choice:** Researcher does full audit
|
|
**Notes:** No specific components flagged by user. Full discovery expected.
|
|
|
|
---
|
|
|
|
## Dead Code Scope
|
|
|
|
| Option | Description | Selected |
|
|
|--------|-------------|----------|
|
|
| Frontend only | Stick to 6 existing plans. Backend was cleaned in Phase 8. | ✓ |
|
|
| Frontend + backend | Also sweep backend for unused routes, dead utilities, stale imports. | |
|
|
|
|
**User's choice:** Frontend only
|
|
**Notes:** Backend was decomposed and cleaned in Phase 8. No backend dead-code sweep needed in this phase.
|
|
|
|
---
|
|
|
|
## Claude's Discretion
|
|
|
|
- **Sidebar state implementation** — Pinia store vs. layout refs; researcher decides based on actual component tree
|
|
- **Focus ring color** — pick one consistent color for focus-visible rings (recommendation: `ring-amber-500` or neutral `ring-blue-500`)
|
|
- **Typography scale definition** — enumerate actual sizes found in codebase, normalize to smallest consistent set, document in plan verification
|
|
- **Minor visual refinement scope** — researcher flags specific items during audit; apply only what has clear improvement value
|
|
|
|
## Deferred Ideas
|
|
|
|
None — discussion stayed within phase scope.
|