repo_Claude/.claude/commands/btw.md

version, updated, tags

version	updated	tags
1.0.0	2026-03-12	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

/btw [pregunta o tema de conversación]

Si no proporcionas un tema, entra en modo conversación libre.

Ejemplos

Ejemplo 1:

/btw qué opinas de la arquitectura core/shell/app?

Abre una conversación sobre la arquitectura del proyecto sin realizar cambios.

Ejemplo 2:

/btw

Entra en modo conversación libre para charlar sobre cualquier aspecto del repositorio.

Ejemplo 3:

/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