200 lines
5.6 KiB
Markdown
200 lines
5.6 KiB
Markdown
---
|
|
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
|