Ocho capítulos, con ejemplos reales de tus propias apps, no genéricos. Para vos y para el equipo.
Auditoría corrida el 18/9/2026 con ~/bin/auditar-dassa.sh — volvé a correrla cuando quieras, no gasta nada de Claude.
Tres hábitos, no errores puntuales — se repiten en casi todas las apps:
Nada apareció filtrado (bien) — pero 68 de 72 apps se tocan directo en main, sin rama de trabajo, y 33 de 72 no tienen CLAUDE.md. Los capítulos 2 y 4 son exactamente para esto.
main → producción (solo recibe merges, nunca commits directos) develop → staging (integración antes de subir a main) feature/xxx → trabajo (una rama por cada cambio)
git checkout develop && git pull origin develop git checkout -b feature/nombre-descriptivo # ... cambios, comiteando seguido ... git add -p # mirás qué subís git commit -m "feat: descripción breve" git push origin feature/nombre-descriptivo # PR a develop → probar en staging → PR de develop a main
| Prefijo | Para qué |
|---|---|
feat: | funcionalidad nueva |
fix: | corrección de bug |
docs: | documentación |
chore: | mantenimiento (deps, config) |
68 de 72 apps están paradas en main ahora mismo — sólo fortaleza y marketing-agency trabajan en una rama propia. No es que esté prohibido: es que hoy nadie más lo hace. Empezar por una sola app la próxima vez que toques código es el paso más chico posible.
.env nunca se sube a GitHub. .env.example sí — con los nombres, sin valores.| Dónde | Qué va ahí |
|---|---|
| Repo (GitHub) | .env.example, CLAUDE.md, README.md — nunca un valor real |
| Tu máquina | .env con los valores, en .gitignore |
| El VPS (producción) | variables de entorno del sistema, no un archivo commiteado |
| CI/CD (si lo usás) | GitHub Settings → Secrets — no vuelven a mostrarse una vez guardadas |
Vive en ~/.secretos-dassa/bovéda.env.gpg, fuera de todo repo git — un solo archivo cifrado (AES256) con una passphrase que solo sabe Santi. Junta los .env de las 72 apps, prefijados por app para no pisar nombres repetidos (ORDEN__SUPABASE_URL, KIDDO__SUPABASE_URL...).
source ~/bin/cargar-boveda.sh # pide la passphrase la primera vez por terminal — gpg-agent la cachea un rato # después, cualquier comando de esa terminal tiene las variables: $ORDEN__ORDEN_PG_DSN, etc.
source va DENTRO de ese mismo comando, no una vez "al principio": source ~/bin/cargar-boveda.sh && mi-script.sh. gpg-agent evita que vuelva a pedir la passphrase cada vez.~/.secretos-dassa/agregar-manual.sh
# pide nombre y valor — el valor con read -s: no se ve en pantalla, no queda en el historial
WORKSPACE_MADRE_DASSA_PASSWORD) — no mezclada con una API key cualquiera.Si más adelante suma fricción compartirla con el equipo, 1Password o Bitwarden hacen lo mismo con roles por persona — decisión de herramienta, no de método.
Ninguna clave real apareció commiteada en las 72 apps — ni ahora, ni en el historial. Sí hay 2 apps con una contraseña de base de datos local escrita en un comentario de script (no en .env): bajo riesgo porque es solo accesible desde el propio servidor, pero se corrige igual. El comando del final del tutorial te dice cuáles.
Un archivo en la raíz del repo que Claude lee solo al arrancar. El equivalente a un onboarding de 30 segundos: en vez de explicarle todo de nuevo cada sesión, lo lee él.
# [Nombre del proyecto] — CLAUDE.md ## Contexto de negocio [1-3 oraciones: qué hace, quién la usa, para qué] ## Stack tecnológico - Frontend / Backend / Deploy / CI-CD ## Estructura de carpetas clave /app /components /lib /api ## Variables de entorno necesarias (nombres, nunca valores) ## Tablas principales de la base ## Convenciones de código ## Estado actual ## Contacto y responsables
33 de 72 apps no tienen CLAUDE.md. Son 33 apps donde cada sesión repite desde cero quién sos y cómo funciona el stack — antes de escribir una sola línea útil.
No es teoría: esto se midió sobre tus propias sesiones de los últimos 30 días.
| Medición | Resultado |
|---|---|
| Contexto leído en 7 días | 14.670 millones de tokens |
| Ratio contexto : output | 478 a 1 — se lee 478 veces más de lo que se escribe |
| Lo que pesan 8 sesiones largas | 89% de un día — abren la jornada ya con 360k–818k de contexto |
| El arranque (system prompt + skills + MCP) | 19% del gasto — se paga en cada mensaje, no una vez |
| Proyecto | Foco |
|---|---|
| DASSA — Producción | trabajo operativo diario |
| PyMeTech — Dev | desarrollo de apps de clientes |
| Smart DASSA — Arquitectura | diseño de sistemas, planning |
Subís el CLAUDE.md del repo como archivo del proyecto una vez; todas las conversaciones de ese proyecto lo heredan solas.
CLAUDE.md por proyecto — capítulo 4.Se archivaron 197 sesiones dormidas, se sacó un MCP con 310 herramientas y 0 usos en 30 días, y se retiraron 15 skills nunca invocadas. El gasto diario bajó de 4.436 millones (13/9) a 167 millones (18/9).
Hoy se prueba en producción. El objetivo: un entorno idéntico donde probar antes de que llegue al usuario.
producción: app.dassa.com.ar ← rama main staging: staging.dassa.com.ar ← rama develop
Dos instancias en puertos distintos (ej. 3000 y 3001), nginx rutea según el subdominio. Costo adicional: $0.
name: Deploy to Production
on: { push: { branches: [main] } }
jobs:
deploy:
runs-on: ubuntu-latest
steps:
- uses: appleboy/ssh-action@master
with:
host: ${{ secrets.VPS_HOST }}
username: ${{ secrets.VPS_USER }}
key: ${{ secrets.VPS_SSH_KEY }}
script: |
cd /var/www/nombre-app
git pull origin main && npm install --production
npm run build && pm2 restart nombre-app
El deploy real es manual: git pull + pm2 restart por SSH. Funciona, pero es el mismo camino que el capítulo 1 dice que es riesgoso. No hace falta migrar las 72 apps — elegir una para probar el patrón alcanza.
Sin registro de versiones, cuando algo falla en producción no sabés qué cambió, cuándo, ni quién. Con CHANGELOG.md eso está claro en 10 segundos.
# Changelog — [Proyecto] ## [Sin publicar] - feat: nuevo módulo de reportes ## [1.3.0] — 2026-09-15 ### Agregado - Filtro por fecha en tabla de operaciones ### Corregido - Error en cálculo de saldo en dólares
Versión semántica simple: MAYOR.MENOR.PARCHE — mayor rompe compatibilidad, menor suma sin romper, parche es bugfix. Se actualiza en el mismo commit del cambio, nunca después.
git tag -a v1.3.0 -m "v1.3.0: filtros y exportación" git push origin v1.3.0
# Vos git checkout -b feature/nuevo-modulo git push origin feature/nuevo-modulo # El colega git fetch origin && git checkout feature/nuevo-modulo # ... sigue el trabajo ... git push origin feature/nuevo-modulo
Nadie pisa el trabajo del otro — Git trackea cada commit con autor y momento.
feat / fix / breaking-change)Closes #23)## Qué cambia este PR ## Por qué ## Cómo probar 1. [Paso 1] ## Checklist - [ ] Testé en staging - [ ] Actualicé CHANGELOG.md - [ ] No hay claves hardcodeadas - [ ] CLAUDE.md actualizado si cambió la estructura
~/bin/auditar-dassa.sh # las 72 apps ~/bin/auditar-dassa.sh orden # una sola
No usa tokens de Claude — es un script de bash. Revisa .env en git, claves hardcodeadas, .gitignore, CLAUDE.md, rama de trabajo, y el estado del servidor (disco, memoria, PM2).
Basado en la nota Metodología de Desarrollo DASSA del 17/9/2026, con los hallazgos reales de la auditoría del 18/9/2026 sobre dassa4/apps y pymetech/apps. Actualizalo corriendo el script de nuevo.