claudeguide-engineer 1.14.8

package/.claude/skills/claude-code/references/ide-integration.md

@@ -0,0 +1,316 @@
+# IDE Integration
+
+Use Claude Code with Visual Studio Code and JetBrains IDEs.
+
+## Visual Studio Code
+
+### Installation
+
+1. Open VS Code
+2. Go to Extensions (Ctrl+Shift+X)
+3. Search for "Claude Code"
+4. Click Install
+5. Authenticate with API key
+
+### Features
+
+**Inline Chat**
+- Press Ctrl+I (Cmd+I on Mac)
+- Ask questions about code
+- Get suggestions in context
+- Apply changes directly
+
+**Code Actions**
+- Right-click on code
+- Select "Ask Claude"
+- Get refactoring suggestions
+- Fix bugs and issues
+
+**Diff View**
+- See proposed changes
+- Accept/reject modifications
+- Review before applying
+- Staged diff comparison
+
+**Terminal Integration**
+- Built-in Claude terminal
+- Run commands via Claude
+- Execute tools directly
+- View real-time output
+
+### Configuration
+
+**.vscode/settings.json:**
+```json
+{
+  "claude.apiKey": "${ANTHROPIC_API_KEY}",
+  "claude.model": "claude-sonnet-4-5-20250929",
+  "claude.maxTokens": 8192,
+  "claude.autoSave": true,
+  "claude.inlineChat.enabled": true,
+  "claude.terminalIntegration": true
+}
+```
+
+### Keyboard Shortcuts
+
+**Default shortcuts:**
+- `Ctrl+I`: Inline chat
+- `Ctrl+Shift+C`: Open Claude panel
+- `Ctrl+Shift+Enter`: Submit to Claude
+- `Escape`: Close Claude chat
+
+**Custom shortcuts (.vscode/keybindings.json):**
+```json
+[
+  {
+    "key": "ctrl+alt+c",
+    "command": "claude.openChat"
+  },
+  {
+    "key": "ctrl+alt+r",
+    "command": "claude.refactor"
+  }
+]
+```
+
+### Workspace Integration
+
+**Project-specific Claude settings:**
+
+.vscode/claude.json:
+```json
+{
+  "skills": [".claude/skills/project-skill"],
+  "commands": [".claude/commands"],
+  "mcpServers": ".claude/mcp.json",
+  "outputStyle": "technical-writer"
+}
+```
+
+### Common Workflows
+
+**Explain Code:**
+1. Select code
+2. Right-click → "Ask Claude"
+3. Type: "Explain this code"
+
+**Refactor:**
+1. Select function
+2. Press Ctrl+I
+3. Type: "Refactor for better performance"
+
+**Fix Bug:**
+1. Click on error
+2. Press Ctrl+I
+3. Type: "Fix this error"
+
+**Generate Tests:**
+1. Select function
+2. Right-click → "Ask Claude"
+3. Type: "Write tests for this"
+
+## JetBrains IDEs
+
+Supported IDEs:
+- IntelliJ IDEA
+- PyCharm
+- WebStorm
+- PhpStorm
+- GoLand
+- RubyMine
+- CLion
+- Rider
+
+### Installation
+
+1. Open Settings (Ctrl+Alt+S)
+2. Go to Plugins
+3. Search "Claude Code"
+4. Click Install
+5. Restart IDE
+6. Authenticate with API key
+
+### Features
+
+**AI Assistant Panel**
+- Dedicated Claude panel
+- Context-aware suggestions
+- Multi-file awareness
+- Project understanding
+
+**Inline Suggestions**
+- As-you-type completions
+- Contextual code generation
+- Smart refactoring hints
+- Error fix suggestions
+
+**Code Reviews**
+- Automated code reviews
+- Security vulnerability detection
+- Best practice recommendations
+- Performance optimization tips
+
+**Refactoring Support**
+- Smart rename
+- Extract method
+- Inline variable
+- Move class
+
+### Configuration
+
+**Settings → Tools → Claude Code:**
+```
+API Key: [Your API Key]
+Model: claude-sonnet-4-5-20250929
+Max Tokens: 8192
+Auto-complete: Enabled
+Code Review: Enabled
+```
+
+**Project Settings (.idea/claude.xml):**
+```xml
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="ClaudeSettings">
+    <option name="model" value="claude-sonnet-4-5-20250929" />
+    <option name="skillsPath" value=".claude/skills" />
+    <option name="autoReview" value="true" />
+  </component>
+</project>
+```
+
+### Keyboard Shortcuts
+
+**Default shortcuts:**
+- `Ctrl+Shift+A`: Ask Claude
+- `Alt+Enter`: Quick fixes with Claude
+- `Ctrl+Alt+L`: Format with Claude suggestions
+
+**Custom shortcuts (Settings → Keymap → Claude Code):**
+```
+Ask Claude: Ctrl+Shift+C
+Refactor with Claude: Ctrl+Alt+R
+Generate Tests: Ctrl+Alt+T
+Code Review: Ctrl+Alt+V
+```
+
+### Integration with IDE Features
+
+**Version Control:**
+- Review commit diffs with Claude
+- Generate commit messages
+- Suggest PR improvements
+- Analyze merge conflicts
+
+**Debugger:**
+- Explain stack traces
+- Suggest fixes for errors
+- Debug complex issues
+- Analyze variable states
+
+**Database Tools:**
+- Generate SQL queries
+- Optimize database schema
+- Write migration scripts
+- Explain query plans
+
+### Common Workflows
+
+**Generate Boilerplate:**
+1. Right-click in editor
+2. Select "Generate" → "Claude Code"
+3. Choose template type
+
+**Review Changes:**
+1. Open Version Control panel
+2. Right-click on changeset
+3. Select "Review with Claude"
+
+**Debug Error:**
+1. Hit breakpoint
+2. Right-click in debugger
+3. Select "Ask Claude about this"
+
+## CLI Integration
+
+Use Claude Code from IDE terminal:
+
+```bash
+# In VS Code terminal
+claude "explain this project structure"
+
+# In JetBrains terminal
+claude "add error handling to current file"
+```
+
+## Best Practices
+
+### VS Code
+
+**Workspace Organization:**
+- Use workspace settings for team consistency
+- Share .vscode/claude.json in version control
+- Document custom shortcuts
+- Configure output styles per project
+
+**Performance:**
+- Limit inline suggestions in large files
+- Disable auto-save for better control
+- Use specific prompts
+- Close unused editor tabs
+
+### JetBrains
+
+**Project Configuration:**
+- Enable Claude for specific file types only
+- Configure inspection severity
+- Set up custom code review templates
+- Use project-specific skills
+
+**Performance:**
+- Adjust auto-complete delay
+- Limit scope of code analysis
+- Disable for binary files
+- Configure memory settings
+
+## Troubleshooting
+
+### VS Code
+
+**Extension Not Loading:**
+```bash
+# Check extension status
+code --list-extensions | grep claude
+
+# Reinstall
+code --uninstall-extension anthropic.claude-code
+code --install-extension anthropic.claude-code
+```
+
+**Authentication Issues:**
+- Verify API key in settings
+- Check environment variable
+- Re-authenticate in extension
+- Review proxy settings
+
+### JetBrains
+
+**Plugin Not Responding:**
+```
+File → Invalidate Caches / Restart
+Settings → Plugins → Claude Code → Reinstall
+```
+
+**Performance Issues:**
+- Increase IDE memory (Help → Edit Custom VM Options)
+- Disable unused features
+- Clear caches
+- Update plugin version
+
+## See Also
+
+- VS Code extension: https://marketplace.visualstudio.com/items?itemName=anthropic.claude-code
+- JetBrains plugin: https://plugins.jetbrains.com/plugin/claude-code
+- Configuration: `references/configuration.md`
+- Troubleshooting: `references/troubleshooting.md`

package/.claude/skills/claude-code/references/mcp-integration.md

@@ -0,0 +1,386 @@
+# MCP Integration
+
+Model Context Protocol (MCP) integration for connecting Claude Code to external tools and services.
+
+## What is MCP?
+
+Model Context Protocol enables Claude Code to:
+- Connect to external tools and services
+- Access resources (files, databases, APIs)
+- Use custom tools
+- Provide prompts and completions
+
+## Configuration
+
+MCP servers are configured in `.claude/mcp.json`:
+
+### Basic Configuration
+```json
+{
+  "mcpServers": {
+    "server-name": {
+      "command": "command-to-run",
+      "args": ["arg1", "arg2"],
+      "env": {
+        "VAR_NAME": "value"
+      }
+    }
+  }
+}
+```
+
+### Example Configuration
+```json
+{
+  "mcpServers": {
+    "filesystem": {
+      "command": "npx",
+      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/allowed/path"],
+      "env": {}
+    },
+    "github": {
+      "command": "npx",
+      "args": ["-y", "@modelcontextprotocol/server-github"],
+      "env": {
+        "GITHUB_TOKEN": "${GITHUB_TOKEN}"
+      }
+    },
+    "postgres": {
+      "command": "npx",
+      "args": ["-y", "@modelcontextprotocol/server-postgres"],
+      "env": {
+        "DATABASE_URL": "postgresql://user:pass@localhost:5432/db"
+      }
+    }
+  }
+}
+```
+
+## Common MCP Servers
+
+### Filesystem Access
+```json
+{
+  "filesystem": {
+    "command": "npx",
+    "args": [
+      "-y",
+      "@modelcontextprotocol/server-filesystem",
+      "/path/to/allowed/files"
+    ]
+  }
+}
+```
+
+**Capabilities:**
+- Read/write files
+- List directories
+- File search
+- Path restrictions for security
+
+### GitHub Integration
+```json
+{
+  "github": {
+    "command": "npx",
+    "args": ["-y", "@modelcontextprotocol/server-github"],
+    "env": {
+      "GITHUB_TOKEN": "${GITHUB_TOKEN}"
+    }
+  }
+}
+```
+
+**Capabilities:**
+- Repository access
+- Issues and PRs
+- Code search
+- Workflow management
+
+### PostgreSQL Database
+```json
+{
+  "postgres": {
+    "command": "npx",
+    "args": ["-y", "@modelcontextprotocol/server-postgres"],
+    "env": {
+      "DATABASE_URL": "${DATABASE_URL}"
+    }
+  }
+}
+```
+
+**Capabilities:**
+- Query execution
+- Schema inspection
+- Transaction management
+- Connection pooling
+
+### Brave Search
+```json
+{
+  "brave-search": {
+    "command": "npx",
+    "args": ["-y", "@modelcontextprotocol/server-brave-search"],
+    "env": {
+      "BRAVE_API_KEY": "${BRAVE_API_KEY}"
+    }
+  }
+}
+```
+
+**Capabilities:**
+- Web search
+- News search
+- Local search
+- Result filtering
+
+### Puppeteer (Browser Automation)
+```json
+{
+  "puppeteer": {
+    "command": "npx",
+    "args": ["-y", "@modelcontextprotocol/server-puppeteer"]
+  }
+}
+```
+
+**Capabilities:**
+- Browser automation
+- Screenshots
+- PDF generation
+- Web scraping
+
+## Remote MCP Servers
+
+Connect to MCP servers over HTTP/SSE:
+
+### Basic Remote Server
+```json
+{
+  "mcpServers": {
+    "remote-service": {
+      "url": "https://api.example.com/mcp"
+    }
+  }
+}
+```
+
+### With Authentication
+```json
+{
+  "mcpServers": {
+    "remote-service": {
+      "url": "https://api.example.com/mcp",
+      "headers": {
+        "Authorization": "Bearer ${API_TOKEN}",
+        "X-Custom-Header": "value"
+      }
+    }
+  }
+}
+```
+
+### With Proxy
+```json
+{
+  "mcpServers": {
+    "remote-service": {
+      "url": "https://api.example.com/mcp",
+      "proxy": "http://proxy.company.com:8080"
+    }
+  }
+}
+```
+
+## Environment Variables
+
+Use environment variables for sensitive data:
+
+### .env File
+```bash
+# .claude/.env
+GITHUB_TOKEN=ghp_xxxxx
+DATABASE_URL=postgresql://user:pass@localhost/db
+BRAVE_API_KEY=BSAxxxxx
+API_TOKEN=token_xxxxx
+```
+
+### Reference in mcp.json
+```json
+{
+  "mcpServers": {
+    "github": {
+      "command": "npx",
+      "args": ["-y", "@modelcontextprotocol/server-github"],
+      "env": {
+        "GITHUB_TOKEN": "${GITHUB_TOKEN}"
+      }
+    }
+  }
+}
+```
+
+## Testing MCP Servers
+
+### Inspector Tool
+```bash
+npx @modelcontextprotocol/inspector
+```
+
+Opens web UI for testing MCP servers:
+- List available tools
+- Test tool invocations
+- View resources
+- Debug connections
+
+### Manual Testing
+```bash
+# Test server command
+npx -y @modelcontextprotocol/server-filesystem /tmp
+
+# Check server output
+echo '{"jsonrpc":"2.0","method":"initialize","params":{}}' | \
+  npx -y @modelcontextprotocol/server-filesystem /tmp
+```
+
+## Creating Custom MCP Servers
+
+### Python Server
+```python
+from mcp.server import Server
+from mcp.server.stdio import stdio_server
+
+server = Server("my-server")
+
+@server.tool()
+async def my_tool(arg: str) -> str:
+    """Tool description"""
+    return f"Result: {arg}"
+
+if __name__ == "__main__":
+    stdio_server(server)
+```
+
+### Configuration
+```json
+{
+  "mcpServers": {
+    "my-server": {
+      "command": "python",
+      "args": ["path/to/server.py"]
+    }
+  }
+}
+```
+
+### Node.js Server
+```javascript
+import { Server } from "@modelcontextprotocol/server-node";
+
+const server = new Server("my-server");
+
+server.tool({
+  name: "my-tool",
+  description: "Tool description",
+  parameters: { arg: "string" }
+}, async ({ arg }) => {
+  return `Result: ${arg}`;
+});
+
+server.listen();
+```
+
+## Security Considerations
+
+### Filesystem Access
+- Restrict to specific directories
+- Use read-only access when possible
+- Validate file paths
+- Monitor access logs
+
+### API Credentials
+- Use environment variables
+- Never commit credentials
+- Rotate keys regularly
+- Implement least-privilege access
+
+### Network Access
+- Whitelist allowed domains
+- Use HTTPS only
+- Implement timeouts
+- Rate limit requests
+
+### Remote Servers
+- Validate server certificates
+- Use authentication
+- Implement request signing
+- Monitor for anomalies
+
+## Troubleshooting
+
+### Server Not Starting
+```bash
+# Check server command
+npx -y @modelcontextprotocol/server-filesystem /tmp
+
+# Verify environment variables
+echo $GITHUB_TOKEN
+
+# Check logs
+cat ~/.claude/logs/mcp-*.log
+```
+
+### Connection Errors
+```bash
+# Test network connectivity
+curl https://api.example.com/mcp
+
+# Verify proxy settings
+echo $HTTP_PROXY
+
+# Check firewall rules
+```
+
+### Permission Errors
+```bash
+# Verify file permissions
+ls -la /path/to/allowed/files
+
+# Check user permissions
+whoami
+groups
+```
+
+### Tool Not Found
+- Verify server is running
+- Check server configuration
+- Inspect server capabilities
+- Review tool registration
+
+## Best Practices
+
+### Configuration Management
+- Use environment variables for secrets
+- Document server purposes
+- Version control mcp.json (without secrets)
+- Test configurations thoroughly
+
+### Performance
+- Use local servers when possible
+- Implement caching
+- Set appropriate timeouts
+- Monitor resource usage
+
+### Maintenance
+- Update servers regularly
+- Monitor server health
+- Review access logs
+- Clean up unused servers
+
+## See Also
+
+- MCP specification: https://modelcontextprotocol.io
+- Creating MCP servers: `references/api-reference.md`
+- Security best practices: `references/best-practices.md`
+- Troubleshooting: `references/troubleshooting.md`