61 lines
2.0 KiB
Markdown
61 lines
2.0 KiB
Markdown
|
# 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.
|