Añadidos arhcivos basicos de repos

.claude/commands/btw.md

@@ -0,0 +1,199 @@
+---
+version: 1.0.0
+updated: 2026-03-12
+tags: [conversation, read-only, discussion, opinion]
+---
+
+# Command: btw
+
+Permite conversar, preguntar y opinar sobre el repositorio en modo **read-only**. Este comando desactiva completamente la capacidad de escribir código o modificar archivos, permitiendo únicamente análisis, discusión y consultas.
+
+## Para el usuario
+
+### Cuándo usar este comando
+
+Usa `/btw` cuando necesites:
+
+- Charlar casualmente sobre el código sin riesgo de cambios accidentales
+- Pedir opiniones sobre arquitectura o diseño sin implementar
+- Hacer preguntas exploratorias sobre el codebase
+- Discutir ideas antes de comprometerte a implementarlas
+- Revisar código sin modificarlo
+- Analizar problemas sin aplicar fixes automáticamente
+
+### Sintaxis
+
+```bash
+/btw [pregunta o tema de conversación]
+```
+
+Si no proporcionas un tema, entra en modo conversación libre.
+
+### Ejemplos
+
+**Ejemplo 1:**
+```bash
+/btw qué opinas de la arquitectura core/shell/app?
+```
+
+Abre una conversación sobre la arquitectura del proyecto sin realizar cambios.
+
+**Ejemplo 2:**
+```bash
+/btw
+```
+
+Entra en modo conversación libre para charlar sobre cualquier aspecto del repositorio.
+
+**Ejemplo 3:**
+```bash
+/btw crees que deberíamos usar interfaces para el workspace manager?
+```
+
+Discute opciones de diseño sin implementar nada todavía.
+
+## Para Claude
+
+### Precondiciones
+
+Verificar antes de ejecutar:
+
+- [ ] El usuario quiere conversar SIN modificar código
+- [ ] No hay expectativa de cambios inmediatos en el repositorio
+- [ ] Es una consulta exploratoria o discusión de ideas
+
+### Inputs
+
+Se necesitan los siguientes datos. Si no se proporcionan, preguntar al usuario:
+
+- `topic` (opcional): tema o pregunta específica sobre el repositorio
+  - Si no se proporciona: modo conversación libre
+
+### Flujo obligatorio
+
+#### 1. Activar modo read-only estricto
+
+**IMPORTANTE:** Durante toda la ejecución de este comando:
+
+- **NUNCA** uses las herramientas: `Write`, `Edit`, `NotebookEdit`, `Bash` (excepto para lectura)
+- **SOLO** puedes usar: `Read`, `Glob`, `Grep`, `Task` (con agentes read-only)
+- **NO** crees, modifíes ni elimines ningún archivo
+- **NO** ejecutes comandos que alteren el sistema de archivos
+- **NO** hagas commits, pushes ni cambios en git
+
+Si el usuario pide hacer cambios durante la conversación, recuérdale amablemente:
+
+```
+Estamos en modo /btw (read-only). Si quieres implementar cambios,
+sal de este comando y úsame normalmente.
+```
+
+#### 2. Identificar el tema de conversación
+
+Si el usuario proporcionó un `topic`:
+- Analiza qué información necesitas del repositorio
+- Lee los archivos relevantes usando `Read`, `Glob`, `Grep`
+- Responde basándote en el código actual
+
+Si NO proporcionó `topic`:
+- Pregunta: "¿Sobre qué aspecto del repositorio quieres charlar?"
+- Espera su respuesta
+- Procede según el tema indicado
+
+#### 3. Mantener conversación read-only
+
+Durante la conversación:
+
+- **Lee** archivos si es necesario para fundamentar respuestas
+- **Analiza** código existente
+- **Opina** sobre diseño, arquitectura, mejoras
+- **Sugiere** alternativas sin implementarlas
+- **Explica** conceptos y patrones del proyecto
+- **Discute** trade-offs y decisiones de diseño
+
+**NUNCA:**
+- Modifiques código
+- Crees archivos de ejemplo
+- Ejecutes comandos que cambien el estado
+- Hagas refactors automáticos
+
+#### 4. Salida del modo read-only
+
+La conversación termina cuando:
+
+- El usuario escribe otro comando (ej: `/factory:fix-issue`)
+- El usuario dice explícitamente "listo", "gracias", "suficiente"
+- El usuario pide implementar algo (recordarle que salga del modo `/btw`)
+
+Al finalizar, confirmar:
+
+```
+Conversación en modo read-only completada.
+Si quieres implementar algo de lo discutido, úsame normalmente (sin /btw).
+```
+
+### Verificación final
+
+No hay verificación de cambios porque este comando NO modifica nada.
+
+Informar al usuario:
+
+```
+✓ Modo conversación read-only activo
+
+Puedes preguntarme lo que quieras sobre el repositorio.
+No realizaré ningún cambio en el código.
+
+Para salir: usa otro comando o pide "listo"
+```
+
+## Convenciones
+
+- **No modificación**: Absolutamente ningún cambio en archivos, commits ni git
+- **Solo lectura**: Únicamente herramientas de lectura y análisis
+- **Conversación natural**: Responde como en una charla casual de code review
+- **Fundamenta en código**: Si opinas, referencia líneas específicas del código actual
+
+## Troubleshooting
+
+### Error: "Accidentalmente modifiqué un archivo"
+
+**Causa:** Claude olvidó que está en modo `/btw`
+
+**Solución:**
+1. Deshaz el cambio inmediatamente
+2. Recuerda las reglas del comando `/btw`
+3. Si el usuario quería ese cambio, sugiérele salir del modo `/btw`
+
+### Usuario pide implementar durante /btw
+
+**Causa:** El usuario olvidó que está en modo read-only
+
+**Solución:**
+Responde amablemente:
+
+```
+Estamos en modo /btw (solo lectura). Para implementar esto:
+1. Di "listo" para salir del modo /btw
+2. Luego pídeme que implemente el cambio normalmente
+```
+
+### Necesitas ejecutar tests para responder
+
+**Causa:** El usuario pregunta algo que requiere ejecutar código
+
+**Solución:**
+Explica que en modo `/btw` no se ejecuta código:
+
+```
+Para responder eso necesitaría ejecutar código, pero estamos en modo read-only.
+¿Quieres que salga del modo /btw y ejecute los tests?
+```
+
+## Reglas críticas
+
+- **NUNCA MODIFICAR ARCHIVOS** - Este es el propósito central del comando
+- **Solo herramientas read-only** - Read, Glob, Grep, Task (exploratorio)
+- **Recordatorio constante** - Si el usuario pide cambios, recordar que estamos en modo `/btw`
+- **Conversación fundamentada** - Basar opiniones en código real, no suposiciones
+- **Salida clara** - Confirmar cuando se sale del modo read-only