kiro-kit 0.2.2 → 0.2.4

package/dist/presets/backend/skills/claude-code/references/configuration.md

@@ -1,480 +0,0 @@
-# Configuration and Settings
-
-Configure Claude Code behavior with settings hierarchy, model selection, and output styles.
-
-## Settings Hierarchy
-
-Settings are applied in order of precedence:
-
-1. **Command-line flags** (highest priority)
-2. **Environment variables**
-3. **Project settings** (`.kiro/settings.json`)
-4. **Global settings** (`~/.kiro/settings.json`)
-
-## Settings File Format
-
-### Global Settings
-`~/.kiro/settings.json`:
-```json
-{
-  "model": "claude-sonnet-4-5-20250929",
-  "maxTokens": 8192,
-  "temperature": 1.0,
-  "thinking": {
-    "enabled": true,
-    "budget": 10000
-  },
-  "outputStyle": "default",
-  "memory": {
-    "enabled": true,
-    "location": "global"
-  }
-}
-```
-
-### Project Settings
-`.kiro/settings.json`:
-```json
-{
-  "model": "claude-sonnet-4-5-20250929",
-  "maxTokens": 4096,
-  "sandboxing": {
-    "enabled": true,
-    "allowedPaths": ["/workspace"]
-  },
-  "memory": {
-    "enabled": true,
-    "location": "project"
-  }
-}
-```
-
-## Key Settings
-
-### Model Configuration
-
-**model**: Claude model to use
-- `claude-sonnet-4-5-20250929` (default, latest Sonnet)
-- `claude-opus-4-20250514` (Opus for complex tasks)
-- `claude-haiku-4-20250408` (Haiku for speed)
-
-**Model aliases:**
-- `sonnet`: Latest Claude Sonnet
-- `opus`: Latest Claude Opus
-- `haiku`: Latest Claude Haiku
-- `opusplan`: Opus with extended thinking for planning
-
-```json
-{
-  "model": "sonnet"
-}
-```
-
-### Token Settings
-
-**maxTokens**: Maximum tokens in response
-- Default: 8192
-- Range: 1-200000
-
-```json
-{
-  "maxTokens": 16384
-}
-```
-
-**temperature**: Randomness in responses
-- Default: 1.0
-- Range: 0.0-1.0
-- Lower = more focused, higher = more creative
-
-```json
-{
-  "temperature": 0.7
-}
-```
-
-### Thinking Configuration
-
-**Extended thinking** for complex reasoning:
-
-```json
-{
-  "thinking": {
-    "enabled": true,
-    "budget": 10000,
-    "mode": "auto"
-  }
-}
-```
-
-**Options:**
-- `enabled`: Enable extended thinking
-- `budget`: Token budget for thinking (default: 10000)
-- `mode`: `auto` | `manual` | `disabled`
-
-### Sandboxing
-
-Filesystem and network isolation:
-
-```json
-{
-  "sandboxing": {
-    "enabled": true,
-    "allowedPaths": [
-      "/workspace",
-      "/home/user/projects"
-    ],
-    "networkAccess": "restricted",
-    "allowedDomains": [
-      "api.example.com",
-      "*.trusted.com"
-    ]
-  }
-}
-```
-
-**Options:**
-- `enabled`: Enable sandboxing
-- `allowedPaths`: Filesystem access paths
-- `networkAccess`: `full` | `restricted` | `none`
-- `allowedDomains`: Whitelisted domains
-
-### Memory Management
-
-Control how Claude remembers context:
-
-```json
-{
-  "memory": {
-    "enabled": true,
-    "location": "project",
-    "ttl": 86400
-  }
-}
-```
-
-**location options:**
-- `global`: Share memory across all projects
-- `project`: Project-specific memory
-- `none`: Disable memory
-
-**ttl**: Time to live in seconds (default: 86400 = 24 hours)
-
-### Output Styles
-
-Customize Claude's behavior:
-
-```json
-{
-  "outputStyle": "technical-writer"
-}
-```
-
-**Built-in styles:**
-- `default`: Standard coding assistant
-- `technical-writer`: Documentation focus
-- `code-reviewer`: Review-focused
-- `minimal`: Concise responses
-
-### Logging
-
-Configure logging behavior:
-
-```json
-{
-  "logging": {
-    "level": "info",
-    "file": ".kiro/logs/session.log",
-    "console": true
-  }
-}
-```
-
-**Levels:** `debug`, `info`, `warn`, `error`
-
-## Model Configuration
-
-### Using Model Aliases
-
-```bash
-# Use Sonnet (default)
-claude
-
-# Use Opus for complex task
-claude --model opus "architect a microservices system"
-
-# Use Haiku for speed
-claude --model haiku "fix typo in README"
-
-# Use opusplan for planning
-claude --model opusplan "plan authentication system"
-```
-
-### In Settings File
-
-```json
-{
-  "model": "opus",
-  "thinking": {
-    "enabled": true,
-    "budget": 20000
-  }
-}
-```
-
-### Model Selection Guide
-
-**Sonnet** (claude-sonnet-4-5-20250929):
-- Balanced performance and cost
-- Default choice for most tasks
-- Good for general development
-
-**Opus** (claude-opus-4-20250514):
-- Highest capability
-- Complex reasoning and planning
-- Use for architecture, design, complex debugging
-
-**Haiku** (claude-haiku-4-20250408):
-- Fastest, most cost-effective
-- Simple tasks (typos, formatting)
-- High-volume operations
-
-**opusplan**:
-- Opus + extended thinking
-- Deep planning and analysis
-- Architecture decisions
-
-## Output Styles
-
-### Creating Custom Output Style
-
-Create `~/.kiro/output-styles/my-style.md`:
-
-```markdown
-You are a senior software architect focused on scalability.
-
-Guidelines:
-- Prioritize performance and scalability
-- Consider distributed systems patterns
-- Include monitoring and observability
-- Think about failure modes
-- Document trade-offs
-```
-
-### Using Custom Output Style
-
-```bash
-claude --output-style my-style
-```
-
-Or in settings:
-```json
-{
-  "outputStyle": "my-style"
-}
-```
-
-### Example Output Styles
-
-**technical-writer.md:**
-```markdown
-You are a technical writer creating clear documentation.
-
-Guidelines:
-- Use simple, clear language
-- Provide examples
-- Structure with headings
-- Include diagrams when helpful
-- Focus on user understanding
-```
-
-**code-reviewer.md:**
-```markdown
-You are a senior code reviewer.
-
-Guidelines:
-- Check for bugs and edge cases
-- Review security vulnerabilities
-- Assess performance implications
-- Verify test coverage
-- Suggest improvements
-```
-
-## Environment Variables
-
-### API Configuration
-```bash
-export ANTHROPIC_API_KEY=sk-ant-xxxxx
-export ANTHROPIC_BASE_URL=https://api.anthropic.com
-```
-
-### Proxy Configuration
-```bash
-export HTTP_PROXY=http://proxy.company.com:8080
-export HTTPS_PROXY=http://proxy.company.com:8080
-export NO_PROXY=localhost,127.0.0.1
-```
-
-### Custom CA Certificates
-```bash
-export NODE_EXTRA_CA_CERTS=/path/to/ca-bundle.crt
-```
-
-### Debug Mode
-```bash
-export CLAUDE_DEBUG=1
-export CLAUDE_LOG_LEVEL=debug
-```
-
-## Command-Line Flags
-
-### Common Flags
-
-```bash
-# Set model
-claude --model opus
-
-# Set max tokens
-claude --max-tokens 16384
-
-# Set temperature
-claude --temperature 0.8
-
-# Enable debug mode
-claude --debug
-
-# Use specific output style
-claude --output-style technical-writer
-
-# Disable memory
-claude --no-memory
-
-# Set project directory
-claude --project /path/to/project
-```
-
-### Configuration Commands
-
-```bash
-# View current settings
-claude config list
-
-# Set global setting
-claude config set model opus
-
-# Set project setting
-claude config set --project maxTokens 4096
-
-# Get specific setting
-claude config get model
-
-# Reset to defaults
-claude config reset
-```
-
-## Advanced Configuration
-
-### Custom Tools
-
-Register custom tools:
-
-```json
-{
-  "tools": [
-    {
-      "name": "custom-tool",
-      "description": "Custom tool",
-      "command": "./scripts/custom-tool.sh",
-      "parameters": {
-        "arg1": "string"
-      }
-    }
-  ]
-}
-```
-
-### Rate Limiting
-
-Configure rate limits:
-
-```json
-{
-  "rateLimits": {
-    "requestsPerMinute": 100,
-    "tokensPerMinute": 100000,
-    "retryStrategy": "exponential"
-  }
-}
-```
-
-### Caching
-
-Prompt caching configuration:
-
-```json
-{
-  "caching": {
-    "enabled": true,
-    "ttl": 3600,
-    "maxSize": "100MB"
-  }
-}
-```
-
-## Best Practices
-
-### Project Settings
-- Keep project-specific in `.kiro/settings.json`
-- Commit to version control
-- Document custom settings
-- Share with team
-
-### Global Settings
-- Personal preferences only
-- Don't override project settings unnecessarily
-- Use for API keys and auth
-
-### Security
-- Never commit API keys
-- Use environment variables for secrets
-- Enable sandboxing in production
-- Restrict network access
-
-### Performance
-- Use appropriate model for task
-- Set reasonable token limits
-- Enable caching
-- Configure rate limits
-
-## Troubleshooting
-
-### Settings Not Applied
-```bash
-# Check settings hierarchy
-claude config list --all
-
-# Verify settings file syntax
-cat .kiro/settings.json | jq .
-
-# Reset to defaults
-claude config reset
-```
-
-### Environment Variables Not Recognized
-```bash
-# Verify export
-echo $ANTHROPIC_API_KEY
-
-# Check shell profile
-cat ~/.bashrc | grep ANTHROPIC
-
-# Reload shell
-source ~/.bashrc
-```
-
-## See Also
-
-- Model selection: https://docs.claude.com/about-claude/models
-- Output styles: `references/best-practices.md`
-- Security: `references/enterprise-features.md`
-- Troubleshooting: `references/troubleshooting.md`