troubleshooting
Common Issues
| Issue | Solution |
|---|---|
| "Module not found" errors | Run npm install && npm run build |
| TypeScript compilation errors | Check Node.js version >= 18.0.0 |
| Permission denied | Check file permissions and project path |
| API rate limits | Reduce AI_MAX_TOKENS or increase AI_TIMEOUT |
| Cache issues | Clear cache with rm -rf .mcp-adr-cache |