docs: fix cross-references after move to docs/

Update all markdown cross-references to point to new locations:
- Root files (README, TODO, CLAUDE) now reference docs/
- Files in docs/ use relative paths (./ or ../)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

Author: lucaspimentel

CLAUDE.md

@@ -17,7 +17,7 @@ PowerShell completion module combining Tab completion (NativeAOT) + inline predi
 
 **Supported Commands**: git, gh, gt (Graphite), az, azd, func, code, scoop, winget, wt (Windows Terminal), chezmoi, tre, lsd, dust, cd/Set-Location
 
-For completed work history, see COMPLETED.md.
+For completed work history, see docs/COMPLETED.md.
 
 ## Architecture
 - **ArgumentCompleter** (`pscue-completer.exe`): NativeAOT exe, <10ms startup, computes completions locally with full dynamic arguments support
@@ -152,7 +152,7 @@ Invoke-PCD [path]                                  # Long-form function name
 Test-PSCueCompletion -InputString <string>         # Test completions
 Get-PSCueModuleInfo [-AsJson]                      # Module diagnostics
 
-# See DATABASE-FUNCTIONS.md for detailed database query examples
+# See docs/DATABASE-FUNCTIONS.md for detailed database query examples
 ```
 
 ## Key Technical Decisions
@@ -212,8 +212,8 @@ public void TestLearningAccess()
 ## Documentation
 - **Implementation status**:
   - Active work: See `TODO.md` (includes detailed Phase 18 workflow improvements roadmap)
-  - Completed phases: See `COMPLETED.md` (Phases 1-13, 15, 17.1-17.7, 18.1-18.2 archived)
-- **Database functions**: See `DATABASE-FUNCTIONS.md` for detailed SQLite query examples and schema
+  - Completed phases: See `docs/COMPLETED.md` (Phases 1-13, 15, 17.1-17.7, 18.1-18.2 archived)
+- **Database functions**: See `docs/DATABASE-FUNCTIONS.md` for detailed SQLite query examples and schema
 - Full details: See `docs/ARCHITECTURE.md` and `docs/TROUBLESHOOTING.md`
 - Bug fix history: See git log and commit messages
 - API docs: [ICommandPredictor](https://learn.microsoft.com/powershell/scripting/dev-cross-plat/create-cmdlet-predictor), [IFeedbackProvider](https://learn.microsoft.com/powershell/scripting/dev-cross-plat/create-feedback-provider)
@@ -268,5 +268,7 @@ $env:PSCUE_IGNORE_PATTERNS = "aws *,terraform *,*custom-secret*"
 - **Release Assets**: PSCue-win-x64.zip, PSCue-linux-x64.tar.gz, checksums.txt
 - **Key Features**: Multi-word predictions, dynamic workflow learning, smart directory navigation (pcd)
 
+# Misc
 When adding support for new commands, add the completer registration in module/PSCue.psm1
-- don't mention TODO phases in code (like "// Add multi-word suggestions (Phase 17.4)")
+- don't mention TODO phases in code (like "// Add multi-word suggestions (Phase 17.4)")
+- when running ./scripts/install-local.ps1, always use -Force

README.md

@@ -299,7 +299,7 @@ Patterns use wildcards: `*` matches any characters.
 
 PSCue uses a two-component architecture optimized for both speed and intelligence.
 
-> **For detailed technical information**, including caching strategy and implementation notes, see [TECHNICAL_DETAILS.md](TECHNICAL_DETAILS.md).
+> **For detailed technical information**, including caching strategy and implementation notes, see [TECHNICAL_DETAILS.md](docs/TECHNICAL_DETAILS.md).
 
 ### ArgumentCompleter (Short-lived)
 - **Binary**: `pscue-completer.exe` (NativeAOT)
@@ -640,7 +640,7 @@ Write-Host "In memory: $inMemory | In database: $inDb"
 - Windows: `%LOCALAPPDATA%\PSCue\learned-data.db`
 - Linux: `~/.local/share/PSCue/learned-data.db`
 
-For detailed documentation on database functions, schema, and use cases, see [DATABASE-FUNCTIONS.md](DATABASE-FUNCTIONS.md).
+For detailed documentation on database functions, schema, and use cases, see [DATABASE-FUNCTIONS.md](docs/DATABASE-FUNCTIONS.md).
 
 ### Workflow Management
 
@@ -784,9 +784,9 @@ Special thanks to the PowerShell team for the `ICommandPredictor` and `IFeedback
 - **Releases**: https://github.com/lucaspimentel/PSCue/releases
 - **Project Documentation**:
   - [TODO.md](TODO.md) - Current work and future plans
-  - [COMPLETED.md](COMPLETED.md) - Completed implementation phases (Phases 1-13, 15)
+  - [COMPLETED.md](docs/COMPLETED.md) - Completed implementation phases (Phases 1-13, 15)
   - [CLAUDE.md](CLAUDE.md) - Quick reference for AI agents
-  - [DATABASE-FUNCTIONS.md](DATABASE-FUNCTIONS.md) - Database query functions and schema
+  - [DATABASE-FUNCTIONS.md](docs/DATABASE-FUNCTIONS.md) - Database query functions and schema
 - **PowerShell API Documentation**:
   - [ICommandPredictor API](https://learn.microsoft.com/powershell/scripting/dev-cross-plat/create-cmdlet-predictor)
   - [IFeedbackProvider API](https://learn.microsoft.com/powershell/scripting/dev-cross-plat/create-feedback-provider)

TODO.md

@@ -2,7 +2,7 @@
 
 **Last Updated**: 2025-11-09
 
-This document tracks active and planned work for PSCue. For architectural details, see [TECHNICAL_DETAILS.md](TECHNICAL_DETAILS.md). For completed work, see [COMPLETED.md](COMPLETED.md).
+This document tracks active and planned work for PSCue. For architectural details, see [TECHNICAL_DETAILS.md](docs/TECHNICAL_DETAILS.md). For completed work, see [COMPLETED.md](docs/COMPLETED.md).
 
 ---
 
@@ -465,7 +465,7 @@ PS> █  # Press Tab
 - ✅ Time delta tracking in database
 - ✅ Confidence adjustments based on timing (1.5× to 0.8× boost)
 
-**See**: [COMPLETED.md](COMPLETED.md) for detailed implementation notes
+**See**: [COMPLETED.md](docs/COMPLETED.md) for detailed implementation notes
 
 ### Phase 18.3: Workflow Chains (3+ Commands)
 **Status**: Planned
@@ -1120,11 +1120,11 @@ git push origin main vX.Y.Z
 
 ### Key Files
 - **Task Tracking**: `TODO.md` (this file)
-- **Architecture**: `TECHNICAL_DETAILS.md`
+- **Architecture**: `docs/TECHNICAL_DETAILS.md`
 - **AI Agent Guide**: `CLAUDE.md`
 - **User Guide**: `README.md`
-- **Database Functions**: `DATABASE-FUNCTIONS.md`
-- **Completed Phases**: `COMPLETED.md`
+- **Database Functions**: `docs/DATABASE-FUNCTIONS.md`
+- **Completed Phases**: `docs/COMPLETED.md`
 
 ### Build & Test Commands
 ```bash
@@ -1163,5 +1163,5 @@ Test-PSCueCompletion, Get-PSCueModuleInfo
 - This is a living document - update as tasks progress
 - Check off items as completed
 - Add new items as discovered
-- Move completed phases to COMPLETED.md
-- Move large architectural details to TECHNICAL_DETAILS.md
+- Move completed phases to docs/COMPLETED.md
+- Move large architectural details to docs/TECHNICAL_DETAILS.md

COMPLETED.md docs/COMPLETED.mdCOMPLETED.md renamed to docs/COMPLETED.md

@@ -416,7 +416,7 @@ For current and future work, see [TODO.md](TODO.md).
 - [x] Update CLAUDE.md with new tool capabilities
 - [x] Update README.md with debugging tool section
 - [x] Add examples of using debug tool for troubleshooting
-- [x] Document IPC protocol extensions (TECHNICAL_DETAILS.md updated)
+- [x] Document IPC protocol extensions (./TECHNICAL_DETAILS.md updated)
 - [x] Document IPC server race condition fix
 - [x] Document PowerShell process discovery feature
 
@@ -988,7 +988,7 @@ Features:
 
 - Updated CLAUDE.md with PowerShell function documentation
 - Updated README.md with database management examples
-- Created DATABASE-FUNCTIONS.md with detailed query examples
+- Created ./DATABASE-FUNCTIONS.md with detailed query examples
 - Updated installation scripts to copy Functions directory
 - Comprehensive help for all 10 functions
 
@@ -1016,9 +1016,9 @@ Features:
 - test-cache-debug.ps1, test-pscue-debug.ps1
 
 **Documentation Updated**:
-- README.md: Removed IPC references, updated architecture diagram
-- TECHNICAL_DETAILS.md: Removed IPC sections, updated key decisions
-- CLAUDE.md: Updated to reflect Phase 16 completion
+- ../README.md: Removed IPC references, updated architecture diagram
+- ./TECHNICAL_DETAILS.md: Removed IPC sections, updated key decisions
+- ../CLAUDE.md: Updated to reflect Phase 16 completion
 
 **Verification**:
 - `dotnet build` succeeds (fixed PSCue.slnx folder paths)
@@ -1089,7 +1089,7 @@ Features:
 6. ✅ Direct in-process access (no IPC overhead)
 7. ✅ Export/Import functions enable backup/migration
 8. ✅ All 315 tests passing
-9. ✅ Documentation updated (README, CLAUDE.md, TECHNICAL_DETAILS.md)
+9. ✅ Documentation updated (../README.md, ../CLAUDE.md, ./TECHNICAL_DETAILS.md)
 10. ✅ PSCue.Debug completely removed
 11. ✅ IPC layer completely removed
 12. ✅ 44 IPC tests removed

DATABASE-FUNCTIONS.md docs/DATABASE-FUNCTIONS.mdDATABASE-FUNCTIONS.md renamed to docs/DATABASE-FUNCTIONS.md

@@ -682,7 +682,7 @@ cherry-pick     Apply the changes introduced by some existing commits
 
 **References**:
 - [PSReadLine #4029](https://github.com/PowerShell/PSReadLine/issues/4029) - Feature request to make timeout configurable
-- See `ML-PREDICTIONS.md` for architectural strategies to handle this constraint
+- See `./ML-PREDICTIONS.md` for architectural strategies to handle this constraint
 
 **Note:** Simplified architecture provides faster, more reliable performance.
 
@@ -782,7 +782,7 @@ PSCue works seamlessly across platforms:
 **Implication for ML Features**:
 - ML predictions in inline suggestions require background pre-computation
 - ML predictions in Tab completion can be synchronous (no timeout)
-- See `ML-PREDICTIONS.md` for detailed architectural strategies
+- See `./ML-PREDICTIONS.md` for detailed architectural strategies
 
 ### Project References