Planning (Opus 级)

Do not write code. Do not modify files. Explore and think.

Step 1: Clarify the goal

Before exploring, make sure you understand what done looks like.

• What is the user trying to achieve?
• Are there constraints (must not break X, must stay compatible with Y)?
• Is there an existing pattern in the codebase to follow?

Step 2: Explore the codebase

Use grep, find, read, and ls to understand the relevant code.

Find:

• The entry point or feature area affected
• Types and interfaces that the feature will touch
• Existing similar features to use as a model
• Tests that cover adjacent behavior

Take notes as you go. You will use these in the plan.

Step 3: Identify the approach

Before writing steps, decide on the approach:

• What is the minimal change that delivers the goal?
• Is there a simpler alternative worth mentioning?
• What are the main risks or unknowns?

Step 4: Write the plan

Goal

One sentence. What will be true when this is complete.

Approach

2-3 sentences explaining the strategy and why.

Steps

Numbered, ordered, atomic. Each step names the exact file and function to touch.

1. `src/types.ts` — Add `theme: 'light' | 'dark'` to the `UserPreferences` interface
2. `src/hooks/useTheme.ts` — Create new hook with get/set logic
3. `src/components/Settings.tsx` — Wire theme toggle to the new hook
4. `src/__tests__/useTheme.test.ts` — Add tests for the new hook