Initial commit with translated description

migration.md

@@ -0,0 +1,60 @@
+# Migration Guide - Skill Finder
+
+Read this guide when upgrading from older published versions.
+
+## Breaking Changes in v1.1.3
+
+### 1) Memory template now stores source-selection defaults
+
+**Before:** `~/skill-finder/memory.md` tracked status, preferences, liked skills, passed skills, and domains.
+
+**Now:** the memory file also tracks:
+- `sources: both|clawhub|skills.sh`
+- `integration: proactive|explicit`
+- `## Source Policy`
+
+**Migration steps:**
+1. Back up the current memory file before editing:
+   ```bash
+   cp ~/skill-finder/memory.md ~/skill-finder/memory.md.bak 2>/dev/null || true
+   ```
+2. Preserve all existing sections and user notes.
+3. Add missing status keys if they do not exist:
+   ```markdown
+   sources: both
+   integration: proactive
+   ```
+4. Add a `## Source Policy` section if missing.
+5. Ask the user which default source mode they want:
+   - `both`
+   - `clawhub`
+   - `skills.sh`
+6. Update `sources:` only after the user answers explicitly.
+
+### 2) Setup now assumes dual-source search readiness
+
+**Before:** the skill only described ClawHub search and could work with the older memory format.
+
+**Now:** the skill can search both ClawHub and Skills.sh, and setup should explain both ecosystems before first use.
+
+**Migration steps:**
+1. If `~/skill-finder/` already exists, keep using the same folder.
+2. Do not delete or rename existing files.
+3. Optionally create `~/skill-finder/searches.md` if the user wants recent-query continuity.
+4. If the workspace or AGENTS routing references the old one-source behavior, update it so the agent loads:
+   - the `skill-finder` skill
+   - `~/skill-finder/memory.md`
+
+## Post-Migration Verification
+
+- [ ] `~/skill-finder/memory.md` still contains all prior preferences and history
+- [ ] `sources:` exists and matches the user's explicit choice
+- [ ] `integration:` exists
+- [ ] `## Source Policy` exists
+- [ ] No existing data was deleted
+
+## Cleanup Policy
+
+- Never delete `memory.md.bak` without explicit user confirmation.
+- Do not remove legacy notes that still provide value.
+- Prefer additive migration over rewrite.