trombonet12/Rally-Copilot / .claude/skills/bugfix-flow
bugfix-flow
Verifiedbugfix-flow
Flujo para el bug $ARGUMENTS. Lo ejecuta un agente de ingeniería [sonnet]; si no hay uno cargado: general-purpose + modelo sonnet.
Cuándo usarla
- Hay un comportamiento incorrecto reproducible que debe corregirse (app, motor
motor/, datos o esquema Room).
Cuándo NO usarla
- Intermitente (pasa a veces) → usa
test-debug-flaky. - Comportamiento nuevo o cambio de diseño → usa
design-feature. - Una nota mal generada por calibración (grado discutible, no un fallo de código) → revisión con el agente
copiloto-reviewery registro endocs/DECISIONES.md.
Precondiciones
$ARGUMENTScon descripción, pasos y resultado esperado vs. obtenido. Si falta, pedirlos y parar.- Leer
docs/ESTADO.mdy el hito activo deROADMAP.md; el bug debe caer dentro de él o registrarse si no.
Pasos
- Reproducir: localizar el fallo en local con el menor caso posible (test existente, traza con
gps-replay, dispositivo). Anotar el comando exacto. - Escribir primero un test que falle por la razón correcta (ver
test-write; dobles contest-create-double). Ejecutarlo y confirmar el rojo:- Motor:
./gradlew :motor:test --tests "<clase>". - Android:
./gradlew testDebugUnitTest --tests "<clase>".
- Motor:
- Buscar la causa raíz (no el síntoma): leer el flujo y contrastar hipótesis con el test; no parchear con condiciones ad hoc.
- Corregir con el cambio mínimo. El test debe pasar (verde).
- Regresión: gate qa fast. Si otro test cae, entender por qué antes de tocarlo; nunca desactivarlo.
- Documentar la causa raíz: mensaje de commit
fix(<ámbito>): <resumen>con causa, arreglo y test añadido (lo hace el agente principal) y entrada endocs/ESTADO.mdvíasession-handoff. - Si el bug revela un hueco más amplio (validación, permisos, migración Room), anotarlo como pendiente en ESTADO.md; no ampliar el alcance.
Validaciones / tests
- El test nuevo falla antes del arreglo y pasa después (evidenciar ambos).
- Gate qa fast (skill
qa).
Definition of Done
- Bug reproducido con comando documentado.
- Test de regresión añadido, visto en rojo y luego en verde.
- Cambio mínimo, sin tests desactivados ni errores ignorados.
- Causa raíz en el commit y en
docs/ESTADO.md. - Gate qa fast en verde.
Docs a actualizar
- docs/ESTADO.md (skill
session-handoff) · docs de la feature afectada si el comportamiento esperado se aclara.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 193k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 193k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 193k | Updated | Claude CodeCodex | Verified | Install |