Initial commit with translated description

migration.md

@@ -0,0 +1,87 @@
+# Migration Guide - Productivity
+
+## v1.0.4 Productivity Operating System Update
+
+This update keeps the same home folder, `~/productivity/`, but changes the recommended structure from a light memory-only setup into a fuller operating system with named folders for inbox, goals, projects, tasks, habits, planning, reviews, commitments, focus, routines, and someday items.
+
+### Before
+
+- `~/productivity/memory.md`
+- optional loose notes such as `~/productivity/<topic>.md`
+- older installs may also have copied context guides in a flat layout
+
+### After
+
+- `~/productivity/memory.md`
+- `~/productivity/inbox/`
+- `~/productivity/dashboard.md`
+- `~/productivity/goals/`
+- `~/productivity/projects/`
+- `~/productivity/tasks/`
+- `~/productivity/habits/`
+- `~/productivity/planning/`
+- `~/productivity/reviews/`
+- `~/productivity/commitments/`
+- `~/productivity/focus/`
+- `~/productivity/routines/`
+- `~/productivity/someday/`
+- any old loose notes preserved until the user chooses to merge or archive them
+
+## Safe Migration
+
+1. Check whether `~/productivity/` already exists.
+
+2. If it exists, keep `memory.md` exactly as it is.
+
+3. Create the new files without deleting the old ones:
+
+```bash
+mkdir -p ~/productivity/{inbox,goals,projects,tasks,habits,planning,reviews,commitments,focus,routines,someday}
+touch ~/productivity/inbox/capture.md
+touch ~/productivity/inbox/triage.md
+touch ~/productivity/dashboard.md
+touch ~/productivity/goals/active.md
+touch ~/productivity/goals/someday.md
+touch ~/productivity/projects/active.md
+touch ~/productivity/projects/waiting.md
+touch ~/productivity/tasks/next-actions.md
+touch ~/productivity/tasks/this-week.md
+touch ~/productivity/tasks/waiting.md
+touch ~/productivity/tasks/done.md
+touch ~/productivity/habits/active.md
+touch ~/productivity/habits/friction.md
+touch ~/productivity/planning/daily.md
+touch ~/productivity/planning/weekly.md
+touch ~/productivity/planning/focus-blocks.md
+touch ~/productivity/reviews/weekly.md
+touch ~/productivity/reviews/monthly.md
+touch ~/productivity/commitments/promises.md
+touch ~/productivity/commitments/delegated.md
+touch ~/productivity/focus/sessions.md
+touch ~/productivity/focus/distractions.md
+touch ~/productivity/routines/morning.md
+touch ~/productivity/routines/shutdown.md
+touch ~/productivity/someday/ideas.md
+```
+
+4. If the user has older free-form topic files in `~/productivity/`, map them gradually:
+   - current priorities -> `dashboard.md`
+   - goals -> `goals/active.md`
+   - projects -> `projects/active.md`
+   - actionable work -> `tasks/next-actions.md`
+   - habits and routines -> `habits/active.md`
+   - focus notes -> `focus/sessions.md` or `focus/distractions.md`
+   - weekly reset notes -> `reviews/weekly.md`
+   - parked ideas -> `someday/ideas.md`
+
+5. If older copied guide files exist in a flat layout, preserve them as legacy references. Do not delete or rename them automatically.
+
+6. Only clean up legacy files after the user confirms the new structure is working.
+
+## Post-Migration Check
+
+- `memory.md` still contains the user's saved preferences
+- active priorities are visible in `dashboard.md`
+- next actions live in `tasks/next-actions.md`
+- review cadence is captured in `reviews/weekly.md`
+- no legacy file was deleted without explicit user approval