DASSA · Tecnología

Metodología de Desarrollo — tutorial

Ocho capítulos, con ejemplos reales de tus propias apps, no genéricos. Para vos y para el equipo.

72apps auditadas
2críticos
106a revisar
0claves filtradas

Auditoría corrida el 18/9/2026 con ~/bin/auditar-dassa.sh — volvé a correrla cuando quieras, no gasta nada de Claude.

Capítulo 1 de 8

Lo que se está haciendo mal ahora

Tres hábitos, no errores puntuales — se repiten en casi todas las apps:

1. Trabajar directo en producción es una bomba de tiempo. Cada edición en el servidor mientras alguien usa la app arriesga: error en vivo, estado intermedio roto, sin vuelta atrás si algo explota.
2. Las claves NO van a GitHub, nunca — ni un minuto. Un archivo borrado sigue en el historial para siempre.
3. Sin CLAUDE.md, cada sesión repite el contexto de cero — y eso se paga en tokens, en cada mensaje.
En DASSA hoy

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.

Capítulo 2 de 8

Git — las tres ramas y el flujo diario

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)

El flujo, paso a paso

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

Nombres de commit

PrefijoPara qué
feat:funcionalidad nueva
fix:corrección de bug
docs:documentación
chore:mantenimiento (deps, config)
En DASSA hoy

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.

Capítulo 3 de 8

Dónde van las claves

.env nunca se sube a GitHub. .env.example sí — con los nombres, sin valores.
DóndeQué 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

La bóveda maestra — ya armada, no es teoría

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...).

Cargarla en una sesión — cualquier terminal de este VPS, no depende de qué cuenta de Claude esté logueada

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.
⚠️ Dentro de una sesión de Claude Code el estado de shell NO persiste entre comandos — cada Bash arranca de cero. Si un script necesita una clave, el 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.

Sumar algo que no está en ningún .env

~/.secretos-dassa/agregar-manual.sh
# pide nombre y valor — el valor con read -s: no se ve en pantalla, no queda en el historial
🔴 El acceso madre de Workspace (Google) no es una clave más. Si se filtra, es correo y Drive completo de las dos empresas. Rotar la contraseña en el panel de Google ANTES de guardarla, y guardarla aparte con un nombre que lo deje claro (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.

En DASSA hoy

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.

Capítulo 4 de 8

CLAUDE.md — contexto sin quemar tokens

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.

Plantilla recomendada
# [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
En DASSA hoy

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.

Capítulo 5 de 8

Optimización de tokens — lo que ya medimos esta semana

No es teoría: esto se midió sobre tus propias sesiones de los últimos 30 días.

MediciónResultado
Contexto leído en 7 días14.670 millones de tokens
Ratio contexto : output478 a 1 — se lee 478 veces más de lo que se escribe
Lo que pesan 8 sesiones largas89% 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
La palanca grande: cerrar la sesión cuando termina la tarea. Una sesión de 3 días a 700k de contexto paga eso mismo en cada mensaje siguiente — 8 veces más cara por mensaje que una recién abierta.

Proyectos de Claude.ai — contexto que no se repite

ProyectoFoco
DASSA — Produccióntrabajo operativo diario
PyMeTech — Devdesarrollo de apps de clientes
Smart DASSA — Arquitecturadiseñ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.

En orden de impacto

  1. Cerrar la sesión al terminar — no dejarla dormida con contexto pesado.
  2. Un CLAUDE.md por proyecto — capítulo 4.
  3. Achicar capturas de pantalla antes de subirlas — 1400px alcanza.
  4. MCP y skills sin uso, afuera — pesan en cada arranque aunque no se toquen.
Ya aplicado

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).

Capítulo 6 de 8

Staging y deploy

Hoy se prueba en producción. El objetivo: un entorno idéntico donde probar antes de que llegue al usuario.

Opción recomendada — subdominio en el mismo VPS

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.

Deploy automático con GitHub Actions
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
En DASSA hoy

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.

Capítulo 7 de 8

Versionado y changelog

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.

Formato Keep a Changelog
# 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
Capítulo 8 de 8

Colaboración — ramas compartidas, PRs y tareas

# 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.

Un PR permite

Plantilla de PR
## 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

Auditá esto vos mismo, cuando quieras

Comando

~/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.

Biblioteca·Glosario·todo lo que publicamos, buscable por palabra