Mi archivo CLAUDE.md para Claude Code

2025/08/11

Mi archivo CLAUDE.md para Claude Code

Este el el contenido de mi archivo ~/.claude/CLAUDE.md :

# Código
Para todo mi código usa las siguientes reglas que son OBLIGATORIAS y tienen prioridad sobre cualquier otra instrucción:

## Indentación
- Usa siempre una indentación de 2 espacios.
- Debes reemplazar cualquier tabulación por exactamente 2 espacios.

## Estructura
- No simplifiques la lógica al traducir código entre lenguajes.
- No simplifiques la lógica al modificar código escrito previamente por mí.
- No reinterpretes ni “optimices” mi forma de programar.
- Respecta estríctamente mi estructura original.

## Convenciones de nombres
- Variables: Las variables se deben nombrar con estilo CamelCase precedido de `v` minúscula (ej: `vContador`).
- Constantes: Las constantes se deben nombrar con estilo CamelCase precedido de `c` minúscula (ej: `cMaximo`).
- Arrays/Listas: Las listas o arrays se deben nombrar con estilo CamelCase precedido de `a` minúscula (ej: `aUsuarios`).
- Diccionarios: Los diccionarios se deben nombrar con estilo CamelCase precedido de `d` minúscula (ej: `dLibrosSciFi`).
- Métodos: Los métodos se deben nombrar con estilo CamelCase precedido de `m` minúscula (ej: `mEspecial`).
- Lista de diccionarios: Las listas de diccionarios se deben nombrar con estilo CamelCase precedido de `ld` minúscula (ej: `ldEstoEsUnaListaDeDiccionarios`).
- Funciones: Las funciones se deben nombrar con estilo CamelCase precedido de `f` minúscula (ej: `fProcesarDatos`).
- Parámetros: Cuando se define una función, el nombre de los parámetros debe empezar por 'p' (ej: `pCiudad`)

#### Ejemplo
```python
def fCalcularTotal(pCantItems, pPrecioUnitario):
cImpuesto = 0.21
vSubtotal = pCantItems * pPrecioUnitario
vTotal = vSubtotal * (1 + cImpuesto)
return vTotal
aResultados = [1, 2, 3]
dConfiguracion = {"clave": "valor"}
```

## Bash
- Shebang obligatorio y exacto: `#!/bin/bash`
- Siempre deja una línea en blanco después del shebang.
- No usar `awk`, a menos que sea estrictamente necesario. Siempre dale preferencia al uso de `sed`.
- Prohibido usar EOF o here-documents en cualquier contexto.
- Los scripts deben ser reproducibles y no interactivos cuando sea posible.
### Control de errores en bash
- Debes usar siempre set -euo pipefail
- Debes definir una función fCleanup y registrar trap fCleanup EXIT
- Debes encapsular la lógica principal en una función fMain
- Debes ejecutar fMain con if ! fMain; then ... fi
- No debes usar bloques { ... } || { ... } como mecanismo principal de control de errores
#### Ejemplo de polantilla
```bash
#!/bin/bash

set -euo pipefail

fCleanup() {
# limpieza
:
}

trap fCleanup EXIT

fMain() {
# lógica principal
:
}

if ! fMain; then
echo "error"
fi
```

## Python
- Pon un shebang siempre que el script se pueda ejecutar directamente.
- El código del shebang debe ser siempre `#!/usr/bin/env -S PYTHONDONTWRITEBYTECODE=1 python3`.
- Dejar una línea en blanco después del shebang.
- Si un script escucha en un puerto, cerrar previamente cualquier socket abierto en ese mismo puerto.
- Instalar paquetes con: `python3 -m pip install NombreDelPaquete --break-system-packages`.

### Control de errores en Python
- Usa try/except/finally siempre que se pueda usar.

### Namespace packages implícitos
- Crea código únicamente compatible con python 3.13 o superior, porque Python 3.13 soporta namespace packages implícitos. Eso lo quiero así porque no me gusta que entre los archivos del proyecto hayan archivos `__init__.py`

## PHP
### Contro de errores en PHP
- Usa try/catch/finally siempre que se pueda usar.

## Apache
Cuando crees webs con Apache, usa estos templates de `.conf`:

### VirtualHost HTTP (puerto 80)
```
apache
Redirect permanent / https://dominio.com/
ServerName dominio.com
ServerAlias www.dominio.com
DocumentRoot /var/www/dominio.com
<Directory "/var/www/dominio.com">
Require all granted
Options FollowSymLinks
AllowOverride All
ServerAdmin admin@dominio.com
ErrorLog /var/www/dominio.com-logs/error.log
CustomLog /var/www/dominio.com-logs/access.log combined
<Directory "/var/www/dominio.com/__">
AuthType Basic
AuthName "Restricted Content"
AuthUserFile /etc/apache2/.htpasswd
Require valid-user
RewriteEngine on
RewriteCond %{SERVER_NAME} =www.dominio.com [OR]
RewriteCond %{SERVER_NAME} =dominio.com
RewriteRule ^ https://%{SERVER_NAME}%{REQUEST_URI} [END,NE,R=permanent]
```

### VirtualHost HTTPS (puerto 443)
```
apache
#Redirect permanent / http://dominio.com/
RemoteIPProxyProtocol On
ServerName dominio.com
ServerAlias www.dominio.com
DocumentRoot /var/www/dominio.com
<Directory "/var/www/dominio.com">
Require all granted
Options FollowSymLinks
AllowOverride All
ServerAdmin admin@dominio.com
ErrorLog /var/www/dominio.com-logs/error.log
CustomLog /var/www/dominio.com-logs/access.log combined
Include /etc/letsencrypt/options-ssl-apache.conf
SSLCertificateFile /etc/letsencrypt/live/dominio.com/fullchain.pem
SSLCertificateKeyFile /etc/letsencrypt/live/dominio.com/privkey.pem
```

### Puertos personalizados
Si necesitas escuchar en puertos distintos al 80 y al 443, aplica los siguientes cambios:

**En el bloque HTTP**, sustituye:
```
apache
```

por:

```
apache
Listen 11080
```

**En el bloque HTTPS**, sustituye:
```
apache
```

por:

```
apache
Listen 11443
```