@the-bearded-bear/claude-craft 3.0.0

package/Infra/i18n/pt/Docker/commands/docker-debug.md

@@ -0,0 +1,227 @@
+---
+description: Diagnóstico Docker
+argument-hint: [arguments]
+---
+
+# Diagnóstico Docker
+
+Você é um especialista em debugging Docker. Você deve diagnosticar e resolver problemas relacionados a containers.
+
+## Argumentos
+$ARGUMENTS
+
+Argumentos:
+- Sintoma ou mensagem de erro
+- (Opcional) Nome do container
+- (Opcional) Contexto (dev/prod)
+
+Exemplo: `/docker:debug "Container sai com código 137"` ou `/docker:debug app "Connection refused"`
+
+## MISSÃO
+
+### Passo 1: Coletar Informações
+
+```bash
+# Estado do container
+docker ps -a
+
+# Logs recentes
+docker logs <container> --tail 100 2>&1
+
+# Inspeção completa
+docker inspect <container>
+
+# Recursos
+docker stats --no-stream
+```
+
+### Passo 2: Identificar o Problema
+
+```
+══════════════════════════════════════════════════════════════
+🔍 DIAGNÓSTICO DOCKER
+══════════════════════════════════════════════════════════════
+
+Container: {nome}
+Imagem: {imagem}
+Estado: {running|exited|restarting}
+Tempo ativo: {duração}
+
+──────────────────────────────────────────────────────────────
+🚨 SINTOMA REPORTADO
+──────────────────────────────────────────────────────────────
+
+{descrição do problema}
+
+──────────────────────────────────────────────────────────────
+📋 ANÁLISE
+──────────────────────────────────────────────────────────────
+```
+
+### Passo 3: Árvores de Decisão
+
+#### Container Não Inicia
+
+| Código de Saída | Significado | Ações |
+|-----------------|-------------|-------|
+| 0 | Terminou normalmente | Verificar CMD/ENTRYPOINT |
+| 1 | Erro de aplicação | Analisar logs |
+| 126 | Permissão negada | Verificar permissões |
+| 127 | Comando não encontrado | Verificar PATH e binário |
+| 137 | SIGKILL (OOM ou stop) | Verificar memória |
+| 139 | SIGSEGV | Debugar código |
+
+```bash
+# Verificar código de saída
+docker inspect --format='{{.State.ExitCode}}' <container>
+
+# Verificar OOM
+docker inspect --format='{{.State.OOMKilled}}' <container>
+
+# Logs detalhados
+docker logs <container> 2>&1
+```
+
+#### Problemas de Rede
+
+```bash
+# Resolução DNS
+docker exec <container> nslookup <servico>
+docker exec <container> cat /etc/resolv.conf
+
+# Conectividade
+docker exec <container> ping -c 3 <host>
+docker exec <container> nc -zv <host> <porta>
+
+# Configuração de rede
+docker network inspect <rede>
+docker inspect --format='{{json .NetworkSettings.Networks}}' <container>
+```
+
+#### Problemas de Recursos
+
+```bash
+# Monitoramento em tempo real
+docker stats <container>
+
+# Processos no container
+docker exec <container> ps aux
+docker exec <container> top -bn1
+
+# Memória detalhada
+docker exec <container> free -m
+docker exec <container> cat /proc/meminfo
+```
+
+#### Problemas de Volumes
+
+```bash
+# Mudanças no sistema de arquivos
+docker diff <container>
+
+# Espaço em disco
+docker exec <container> df -h
+
+# Permissões
+docker exec <container> ls -la /caminho/dados
+
+# Inspecionar volume
+docker volume inspect <volume>
+```
+
+### Passo 4: Soluções Comuns
+
+```
+──────────────────────────────────────────────────────────────
+💡 HIPÓTESES E SOLUÇÕES
+──────────────────────────────────────────────────────────────
+
+### Hipótese 1: [Mais Provável]
+**Causa**: {descrição}
+**Verificação**:
+\`\`\`bash
+{comando de diagnóstico}
+\`\`\`
+**Solução**:
+\`\`\`bash
+{comando de resolução}
+\`\`\`
+
+### Hipótese 2: [Alternativa]
+**Causa**: {descrição}
+**Verificação**:
+\`\`\`bash
+{comando}
+\`\`\`
+**Solução**:
+\`\`\`bash
+{comando}
+\`\`\`
+```
+
+### Passo 5: Relatório Final
+
+```
+══════════════════════════════════════════════════════════════
+📊 RELATÓRIO DE DIAGNÓSTICO
+══════════════════════════════════════════════════════════════
+
+──────────────────────────────────────────────────────────────
+🎯 CAUSA IDENTIFICADA
+──────────────────────────────────────────────────────────────
+
+{Descrição da causa raiz}
+
+──────────────────────────────────────────────────────────────
+✅ SOLUÇÃO APLICADA
+──────────────────────────────────────────────────────────────
+
+{Passos de resolução}
+
+──────────────────────────────────────────────────────────────
+🛡️ PREVENÇÃO
+──────────────────────────────────────────────────────────────
+
+Para evitar este problema no futuro:
+- [ ] {Recomendação 1}
+- [ ] {Recomendação 2}
+- [ ] {Recomendação 3}
+
+──────────────────────────────────────────────────────────────
+🔧 COMANDOS ÚTEIS
+──────────────────────────────────────────────────────────────
+
+# Recriar container
+docker compose up -d --force-recreate <servico>
+
+# Rebuild completo
+docker compose build --no-cache <servico>
+
+# Limpar recursos
+docker system prune -af
+
+# Verificar estado
+docker compose ps
+docker compose logs -f <servico>
+```
+
+## Checklist de Diagnóstico
+
+### Informações Básicas
+- [ ] Mensagem de erro exata anotada
+- [ ] Timestamp do problema
+- [ ] Mudanças recentes identificadas
+- [ ] Reprodutibilidade verificada
+
+### Ambiente
+- [ ] Versão do Docker (`docker version`)
+- [ ] Sistema operacional host verificado
+- [ ] Recursos disponíveis
+- [ ] Modo (Compose/Swarm)
+
+### Verificações Realizadas
+- [ ] Logs analisados
+- [ ] Estado do container verificado
+- [ ] Recursos verificados
+- [ ] Rede testada (se aplicável)
+- [ ] Volumes verificados (se aplicável)

package/Infra/install-infra-rules.sh

@@ -0,0 +1,425 @@
+#!/bin/bash
+# Multilingual installation script for Claude Code Infrastructure rules (Docker)
+# Version: 1.0.0
+# Usage: ./install-infra-rules.sh [OPTIONS] [PROJECT_DIR]
+#
+# Installs Docker agents and commands for containerized infrastructure
+
+set -e
+
+# ============================================================================
+# CONSTANTS
+# ============================================================================
+VERSION="1.0.0"
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+I18N_DIR="${SCRIPT_DIR}/i18n"
+TECH_NAME="Docker"
+TECH_NAMESPACE="docker"
+lang="en"
+
+# ============================================================================
+# COLORS
+# ============================================================================
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m' # No Color
+
+# ============================================================================
+# FUNCTIONS
+# ============================================================================
+
+show_help() {
+    cat << 'EOF'
+Usage: install-infra-rules.sh [OPTIONS] [PROJECT_DIR]
+
+Install/Update Docker agents and commands for Claude Code.
+
+Options:
+    --install       Full installation (new files)
+    --update        Update agents and commands only
+    --force         Overwrite all files (automatic backup)
+    --dry-run       Show actions without executing
+    --backup        Create backup before modifications
+    --lang=XX       Language (en, fr, es, de, pt)
+    --version       Show version
+    --help          Show this help
+
+Arguments:
+    PROJECT_DIR     Project directory (default: current directory)
+
+Examples:
+    ./install-infra-rules.sh --install ./my-project
+    ./install-infra-rules.sh --update
+    ./install-infra-rules.sh --lang=fr --install ./project
+    ./install-infra-rules.sh --dry-run
+
+Description:
+    This script installs Docker agents and commands for Claude Code.
+
+    5 agents:
+    - @docker-dockerfile    - Dockerfile expert
+    - @docker-compose       - Docker Compose expert
+    - @docker-debug         - Docker debugging expert
+    - @docker-cicd          - CI/CD pipeline expert
+    - @docker-architect     - Docker architecture expert
+
+    4 commands:
+    - /docker:compose-setup    - Setup docker-compose environment
+    - /docker:debug            - Diagnose Docker issues
+    - /docker:cicd-pipeline    - Generate CI/CD pipeline
+    - /docker:architecture     - Design Docker architecture
+EOF
+}
+
+show_version() {
+    echo "install-infra-rules.sh version ${VERSION}"
+    echo "Docker agents and commands for Claude Code"
+}
+
+log_info() {
+    echo -e "${BLUE}[INFO]${NC} $1"
+}
+
+log_success() {
+    echo -e "${GREEN}[OK]${NC} $1"
+}
+
+log_warning() {
+    echo -e "${YELLOW}[WARN]${NC} $1"
+}
+
+log_error() {
+    echo -e "${RED}[ERROR]${NC} $1"
+}
+
+log_dry_run() {
+    echo -e "${YELLOW}[DRY-RUN]${NC} $1"
+}
+
+# Get source directory (i18n)
+get_source_dir() {
+    local i18n_src="$I18N_DIR/$lang/$TECH_NAME"
+    if [[ -d "$i18n_src" ]]; then
+        echo "$i18n_src"
+    else
+        # Fallback to English
+        echo "$I18N_DIR/en/$TECH_NAME"
+    fi
+}
+
+# Verify source files exist
+verify_source_files() {
+    local src_dir
+    src_dir=$(get_source_dir)
+
+    if [ ! -d "$src_dir/agents" ]; then
+        log_error "Source directory missing: $src_dir/agents"
+        exit 1
+    fi
+
+    if [ ! -d "$src_dir/commands" ]; then
+        log_error "Source directory missing: $src_dir/commands"
+        exit 1
+    fi
+
+    log_success "Source files verified: $src_dir"
+}
+
+# Detect existing installation
+detect_installation() {
+    local target_dir="$1"
+
+    if [ -d "${target_dir}/.claude/commands/${TECH_NAMESPACE}" ]; then
+        echo "existing"
+    elif [ -d "${target_dir}/.claude" ]; then
+        echo "partial"
+    else
+        echo "none"
+    fi
+}
+
+# Create backup
+create_backup() {
+    local target_dir="$1"
+    local dry_run="$2"
+    local backup_dir="${target_dir}/.claude-backup-infra-$(date +%Y%m%d-%H%M%S)"
+
+    if [ -d "${target_dir}/.claude/commands/${TECH_NAMESPACE}" ] || [ -d "${target_dir}/.claude/agents" ]; then
+        if [ "$dry_run" = "true" ]; then
+            log_dry_run "Backup Docker files to ${backup_dir}"
+        else
+            mkdir -p "${backup_dir}/commands"
+            mkdir -p "${backup_dir}/agents"
+            cp -r "${target_dir}/.claude/commands/${TECH_NAMESPACE}" "${backup_dir}/commands/" 2>/dev/null || true
+            # Only backup docker-related agents
+            for agent in docker-dockerfile docker-compose docker-debug docker-cicd docker-architect; do
+                if [ -f "${target_dir}/.claude/agents/${agent}.md" ]; then
+                    cp "${target_dir}/.claude/agents/${agent}.md" "${backup_dir}/agents/"
+                fi
+            done
+            log_success "Backup created: ${backup_dir}"
+        fi
+    fi
+}
+
+# Create directory structure
+create_directory_structure() {
+    local target_dir="$1"
+    local dry_run="$2"
+
+    local dirs=(
+        ".claude"
+        ".claude/commands"
+        ".claude/commands/${TECH_NAMESPACE}"
+        ".claude/agents"
+    )
+
+    for dir in "${dirs[@]}"; do
+        if [ "$dry_run" = "true" ]; then
+            log_dry_run "Create directory: ${target_dir}/${dir}"
+        else
+            mkdir -p "${target_dir}/${dir}"
+        fi
+    done
+}
+
+# Copy agents
+copy_agents() {
+    local target_dir="$1"
+    local dry_run="$2"
+    local src_dir
+    src_dir=$(get_source_dir)
+    local agt_dir="${src_dir}/agents"
+
+    if [ -d "$agt_dir" ]; then
+        if [ "$dry_run" = "true" ]; then
+            log_dry_run "Copy: agents/*.md"
+        else
+            local count=0
+            for agent_file in "${agt_dir}/"*.md; do
+                if [ -f "$agent_file" ]; then
+                    cp "$agent_file" "${target_dir}/.claude/agents/"
+                    ((++count))
+                fi
+            done
+            log_success "${count} Docker agents copied"
+        fi
+    fi
+}
+
+# Copy commands
+copy_commands() {
+    local target_dir="$1"
+    local dry_run="$2"
+    local src_dir
+    src_dir=$(get_source_dir)
+    local cmd_dir="${src_dir}/commands"
+
+    if [ -d "$cmd_dir" ]; then
+        if [ "$dry_run" = "true" ]; then
+            log_dry_run "Copy: commands/*.md"
+        else
+            local count=0
+            for cmd_file in "${cmd_dir}/"*.md; do
+                if [ -f "$cmd_file" ]; then
+                    cp "$cmd_file" "${target_dir}/.claude/commands/${TECH_NAMESPACE}/"
+                    ((++count))
+                fi
+            done
+            log_success "${count} Docker commands copied"
+        fi
+    fi
+}
+
+# Show installation summary
+show_summary() {
+    local target_dir="$1"
+    local mode="$2"
+
+    # Count installed files
+    local commands_count=0
+    local agents_count=0
+    if [ -d "${target_dir}/.claude/commands/${TECH_NAMESPACE}" ]; then
+        commands_count=$(ls -1 "${target_dir}/.claude/commands/${TECH_NAMESPACE}/"*.md 2>/dev/null | wc -l)
+    fi
+    # Count only Docker agents
+    for agent in docker-dockerfile docker-compose docker-debug docker-cicd docker-architect; do
+        if [ -f "${target_dir}/.claude/agents/${agent}.md" ]; then
+            ((++agents_count))
+        fi
+    done
+
+    echo ""
+    echo "=========================================="
+    echo "Installation complete!"
+    echo "=========================================="
+    echo ""
+    echo "Structure created:"
+    echo "  ${target_dir}/"
+    echo "  |-- .claude/"
+    echo "  |   |-- commands/"
+    echo "  |   |   |-- ${TECH_NAMESPACE}/       (${commands_count} commands)"
+    echo "  |   |-- agents/             (${agents_count} Docker agents)"
+    echo ""
+
+    # List available commands
+    if [ $commands_count -gt 0 ]; then
+        echo "Available Docker commands:"
+        for cmd_file in "${target_dir}/.claude/commands/${TECH_NAMESPACE}/"*.md; do
+            if [ -f "$cmd_file" ]; then
+                local cmd_name=$(basename "$cmd_file" .md)
+                echo "  - /${TECH_NAMESPACE}:${cmd_name}"
+            fi
+        done
+        echo ""
+    fi
+
+    # List available agents
+    if [ $agents_count -gt 0 ]; then
+        echo "Available Docker agents:"
+        for agent in docker-dockerfile docker-compose docker-debug docker-cicd docker-architect; do
+            if [ -f "${target_dir}/.claude/agents/${agent}.md" ]; then
+                echo "  - @${agent}"
+            fi
+        done
+        echo ""
+    fi
+
+    echo "Usage examples:"
+    echo "  @docker-dockerfile    Analyze and optimize a Dockerfile"
+    echo "  @docker-architect     Design complete Docker architecture"
+    echo "  /docker:debug         Diagnose Docker issues"
+    echo "  /docker:cicd-pipeline Generate CI/CD pipeline"
+    echo ""
+}
+
+# ============================================================================
+# MAIN
+# ============================================================================
+
+main() {
+    # Default variables
+    local mode=""
+    local force="false"
+    local dry_run="false"
+    local backup="false"
+    local target_dir="."
+
+    # Parse arguments
+    while [[ $# -gt 0 ]]; do
+        case $1 in
+            --install)
+                mode="install"
+                shift
+                ;;
+            --update)
+                mode="update"
+                shift
+                ;;
+            --force)
+                force="true"
+                shift
+                ;;
+            --dry-run)
+                dry_run="true"
+                shift
+                ;;
+            --backup)
+                backup="true"
+                shift
+                ;;
+            --lang=*)
+                lang="${1#--lang=}"
+                shift
+                ;;
+            --version)
+                show_version
+                exit 0
+                ;;
+            --help|-h)
+                show_help
+                exit 0
+                ;;
+            -*)
+                log_error "Unknown option: $1"
+                echo "Use --help to see available options"
+                exit 1
+                ;;
+            *)
+                target_dir="$1"
+                shift
+                ;;
+        esac
+    done
+
+    # Resolve absolute path
+    if [ "$target_dir" != "." ]; then
+        if [ ! -d "$target_dir" ]; then
+            log_error "Directory does not exist: $target_dir"
+            exit 1
+        fi
+        target_dir="$(cd "${target_dir}" && pwd)"
+    else
+        target_dir="$(pwd)"
+    fi
+
+    echo ""
+    echo "=========================================="
+    echo "Installing Docker rules for Claude Code"
+    echo "=========================================="
+    echo ""
+    echo "Version: ${VERSION}"
+    echo "Language: ${lang}"
+    echo "Target directory: ${target_dir}"
+
+    # Verify source files
+    verify_source_files
+
+    # Auto-detect mode if not specified
+    if [ -z "$mode" ]; then
+        local installation_status=$(detect_installation "$target_dir")
+        case $installation_status in
+            existing)
+                log_info "Existing installation detected -> update mode"
+                mode="update"
+                ;;
+            partial|none)
+                log_info "No Docker installation detected -> install mode"
+                mode="install"
+                ;;
+        esac
+    fi
+
+    echo "Mode: ${mode}"
+    if [ "$dry_run" = "true" ]; then
+        echo "Dry-run mode: no modifications will be made"
+    fi
+    echo ""
+
+    # Create backup if requested or in force mode
+    if [ "$backup" = "true" ] || [ "$force" = "true" ]; then
+        create_backup "$target_dir" "$dry_run"
+    fi
+
+    # Execute according to mode
+    case $mode in
+        install|update)
+            log_info "Installing Docker agents and commands..."
+            create_directory_structure "$target_dir" "$dry_run"
+            copy_agents "$target_dir" "$dry_run"
+            copy_commands "$target_dir" "$dry_run"
+            ;;
+    esac
+
+    # Show summary
+    if [ "$dry_run" = "false" ]; then
+        show_summary "$target_dir" "$mode"
+    else
+        echo ""
+        log_dry_run "Simulation complete. No modifications made."
+    fi
+}
+
+main "$@"

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 TheBeardedCTO
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.