docs: sharpen CloudLockFixer discovery context

Author: Lukas Geiger

CHANGELOG.md

@@ -6,6 +6,9 @@ Format basiert auf [Keep a Changelog](https://keepachangelog.com/de/1.1.0/).
 ## [Unreleased]
 
 ### Hinzugefügt / Added
+- README.md, README.de.md and `llms.txt`: added discovery/search context for
+  OneDrive access-denied, `cldflt.sys`, Windows Cloud Files filter, error
+  `0x8007016A`, and cloud-sync locked-folder retry workflows.
 - `tests/source_platform_smoke.py`: headless Smoke-Tests für Linux und macOS — prüft Modul-Import, Version, `ops`-Operationen (rename/move/delete), `models.Queue`-Persistenz, `paths.data_dir()` und `worker.run_once()` ohne Cloud-Client oder GUI.
 - `.github/workflows/source-platform-smoke.yml`: CI-Matrix für `ubuntu-latest` und `macos-latest`, die die Smoke-Tests bei jedem Push/PR auf `main` ausführt.
 

README.de.md

@@ -16,6 +16,16 @@ Ordnern zuverlässig erledigt, auch wenn sie der Windows-Cloud-Files-Filter
 genau das macht dieses Tool, plus verzögerte Retries und optionales Pausieren
 des Sync-Clients.
 
+## Einstieg
+
+| Bedarf | Einstieg |
+|---|---|
+| OneDrive- oder Cloud-Files-Fehler „Zugriff verweigert" beim Umbenennen/Verschieben/Löschen beheben | Tray-App mit `START.bat` starten und verzögerte Aufgabe hinzufügen |
+| Blockierte Dateioperationen aus Skripten oder LLM-Agenten automatisieren | `PYTHONPATH=src python -m cloudlockfixer.cli` nutzen |
+| Sicherheitsmodell vor destruktiven Aktionen prüfen | [`docs/DESIGN.md`](docs/DESIGN.md) lesen |
+| Aufgaben ohne UI eintragen | `%LOCALAPPDATA%\CloudLockFixer\queue.txt` bearbeiten |
+| Quellbaum verifizieren | `PYTHONPATH=src python -m pytest -q` ausführen |
+
 ## Funktionen
 
 - Datei-/Ordner-Operationen eintragen und fire & forget ausführen lassen
@@ -78,6 +88,18 @@ automatisch zu `#>` auskommentiert.
   mehrfach, wird der zuständige Sync-Client für den Lauf pausiert und danach
   neu gestartet.
 
+## Auffindbarkeit
+
+Nützliche Suchphrasen: `OneDrive Zugriff verweigert umbenennen`,
+`cldflt.sys Datei gesperrt`, `Windows Cloud Files Filter copy delete fallback`,
+`OneDrive 0x8007016A Dateioperation`, `Dropbox Google Drive iCloud gesperrter
+Ordner Retry` und `CloudLockFixer queue.txt`.
+
+CloudLockFixer ist kein generischer File-Unlocker, kein Anti-Malware-Werkzeug,
+kein Backup-Client und kein Ersatz für Cloud-Speicher. Es ist eine lokale
+Queue- und Retry-Hilfe für Dateien, die bereits unter Kontrolle des Nutzers
+stehen, aber temporär durch einen Cloud-Sync-Provider blockiert werden.
+
 ## Status / Roadmap
 
 - **P1 (fertig):** Core (copy+delete, Ketten, Retry) · CLI · `queue.txt` · Tray ·

README.md

@@ -17,6 +17,16 @@ workaround** is to replace `rename()` with **copy()+delete()** — which is
 exactly what this tool does, plus delayed retries and optional pausing of the
 sync client.
 
+## Start here
+
+| Need | Entry point |
+|---|---|
+| Fix a OneDrive or Cloud Files "Access denied" rename/move/delete | Start the tray app with `START.bat`, then add a delayed task |
+| Automate stuck file operations from scripts or LLM agents | Use `PYTHONPATH=src python -m cloudlockfixer.cli` |
+| Inspect the safety model before deleting anything | Read [`docs/DESIGN.md`](docs/DESIGN.md) |
+| Queue work without opening the UI | Edit `%LOCALAPPDATA%\CloudLockFixer\queue.txt` |
+| Verify the source tree | Run `PYTHONPATH=src python -m pytest -q` |
+
 ## Features
 
 - Queue file/folder operations and let them run fire & forget
@@ -79,6 +89,18 @@ automatically commented out with `#>`.
   is stuck repeatedly, the responsible sync client is paused for that run and
   restarted afterwards.
 
+## Discovery context
+
+Useful search phrases: `OneDrive access denied rename`, `cldflt.sys locked
+file`, `Windows Cloud Files filter copy delete fallback`, `OneDrive 0x8007016A
+file operation`, `Dropbox Google Drive iCloud locked folder retry`, and
+`CloudLockFixer queue.txt`.
+
+CloudLockFixer is not a generic file unlocker, anti-malware tool, backup client
+or cloud-storage replacement. It is a local-first queue and retry helper for
+files that are already under the user's control but temporarily blocked by a
+cloud-sync provider.
+
 ## Status / Roadmap
 
 - **P1 (done):** Core (copy+delete, chains, retry) · CLI · `queue.txt` · Tray ·

llms.txt

@@ -46,6 +46,17 @@ OneDrive locked file fix tray tool automation
 file-bricks CloudLockFixer queue.txt LLM script file operation
 Windows cloud files filter bypass Python PySide6
 OneDrive file lock retry tool CLF-WDAS
+OneDrive 0x8007016A rename move delete workaround
+cldflt.sys Access denied copy delete fallback
+Dropbox Google Drive iCloud locked folder retry queue
+Windows tray tool for cloud sync file operation failures
 ```
 
-## Last-checked: 2026-06-11
+## Disambiguation
+
+CloudLockFixer is not a generic file unlocker, antivirus utility, backup client,
+ransomware recovery tool, cloud-storage SDK, or sync provider replacement. It is
+a local-first delayed action queue for rename, move and delete operations that
+fail because Windows Cloud Files providers temporarily lock paths.
+
+## Last-checked: 2026-06-12