Claude hooks auto-backup: manual (backup_20250720_091250)

docs/explanation/shadow-learner.md

@@ -55,14 +55,14 @@ Traditional ML models are trained once and deployed. Shadow learners improve inc
 The shadow learner identifies several types of patterns:
 
 **Command Patterns**: Which commands tend to succeed or fail in your environment
-- `pip install` fails 90% of the time → suggest `pip3 install`
-- `python script.py` fails on your system → suggest `python3 script.py`
-- `npm install` without `--save` in certain projects → warn about dependency tracking
+- `npm install` fails 90% of the time → suggest `npm ci` or check package-lock.json
+- `node script.js` fails on your system → suggest `node --version` check or use `npx`
+- `npm install` without `--save-dev` for dev dependencies → warn about production vs development packages
 
 **Sequence Patterns**: Common workflows and command chains
 - `git add . && git commit` often follows file edits
 - `npm install` typically precedes `npm test`
-- Reading config files often precedes configuration changes
+- Reading package.json often precedes dependency updates
 
 **Context Patterns**: Environmental factors that affect command success
 - Commands fail differently in Docker containers vs. native environments
@@ -70,9 +70,9 @@ The shadow learner identifies several types of patterns:
 - Time-of-day patterns (builds failing during peak hours due to resource contention)
 
 **Error Patterns**: Common failure modes and their solutions
-- "Permission denied" errors often require sudo or chmod
-- "Command not found" errors have specific alternative commands
-- Network timeouts suggest retry strategies
+- "Permission denied" errors often require sudo or npm config set prefix
+- "Command not found" errors suggest missing global packages or PATH issues
+- Network timeouts suggest retry strategies or alternative registries
 
 ### Confidence Building
 
@@ -100,8 +100,8 @@ The shadow learner doesn't just record patterns - it builds confidence scores ba
 
 The shadow learner develops deep knowledge about your specific development environment:
 
-- Which Python version is actually available
-- How package managers are configured
+- Which Node.js version is actually available
+- How npm/yarn/pnpm package managers are configured
 - What development tools are installed and working
 - How permissions are set up
 - What network restrictions exist