# Dev Fix

> Loop de diagnóstico disciplinado para bugs — sem PLAN.md, direto ao ponto. Constrói feedback loop reproduzível primeiro, ranqueia hipóteses falsificáveis, instrumenta um probe por hipótese, corrige com teste de regressão e limpa os rastros. Tem modo rápido para bug trivial. Use quando o usuário disser "/dev-fix", "tem um bug", "está quebrado", "parou de funcionar", "dá esse erro", colar um stack…

- **Type:** Skill
- **Install:** `agentstack add skill-calneymgp-solodev-dev-fix`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [calneymgp](https://agentstack.voostack.com/s/calneymgp)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [calneymgp](https://github.com/calneymgp)
- **Source:** https://github.com/calneymgp/solodev/tree/main/skills/dev-fix

## Install

```sh
agentstack add skill-calneymgp-solodev-dev-fix
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# /dev-fix — Bug morre com método, não com tentativa

Bugfix não precisa de BRIEF nem PLAN. Precisa de **disciplina de diagnóstico** — a diferença entre 10 minutos e 3 horas é quase sempre a qualidade do feedback loop, não a dificuldade do bug.

## Triagem (primeiro turn)

Classifique em 1 linha e siga o caminho:

| Classe | Heurística | Caminho |
|--------|-----------|---------|
| **Trivial** | Causa evidente no erro (typo, import, null óbvio), fix de 1-5 linhas | **Modo rápido** ↓ |
| **Real** | Causa não evidente, comportamento intermitente, "funcionava ontem" | **Loop completo** ↓ |
| **Arquitetural** | O fix exigiria redesenho, toca contrato público ou 3+ módulos | Pare. Apresente diagnóstico + opções. Sugira `/dev-brainstorm` ou `/dev-plan`. |

## Modo rápido (bug trivial)

1. Leia o arquivo inteiro em volta do erro (não só a linha)
2. Aplique o fix mínimo
3. Rode o comando que falhava → veja passar
4. Se existir suite, rode os testes do módulo tocado
5. Reporte em 2 linhas: causa → fix

**Se o "trivial" não morrer no primeiro fix, ele não era trivial.** Promova para o loop completo — não tente um segundo palpite.

## Loop completo (6 fases)

### Phase 1 — Construa o feedback loop

O teste/script que reproduz o bug em ** log direcionado > log everything. Logs de debug com prefixo único (`[DEBUG-a4f2]`) para cleanup via grep no fim. Cada probe responde sim/não para UMA hipótese — probe que "olha geral" é ruído.

### Phase 5 — Fix + teste de regressão

Se há seam testável, escreva o teste de regressão **ANTES** do fix. Veja falhar → aplique o fix → veja passar. O teste fica; o bug nunca mais volta sem alarme.

### Phase 6 — Cleanup

Remova logs `[DEBUG-*]`, delete probes, confirme que o repro original não reproduz mais, rode a suite do módulo. Commit: `fix(): `.

## Regras do loop

- **Uma hipótese por vez.** Mudar 3 coisas e "ver se passa" destrói a informação de qual era a causa.
- **Falhou a hipótese? Risque e vá pra próxima.** Não "ajeite mais um pouquinho" a mesma teoria morta.
- **2 ciclos sem progresso → pare.** Apresente o que foi descartado e o que aprendeu. Pergunte ao usuário antes do 3º ciclo — domain knowledge dele vale mais que sua próxima teoria.
- **O fix muda behavior público?** Avise antes de aplicar — pode ser que o "bug" fosse contrato que alguém depende.

## Anti-padrões

- ❌ "Vou mudar isso e ver se passa" (tentativa ≠ diagnóstico)
- ❌ Corrigir o sintoma onde ele aparece em vez da causa onde ela nasce
- ❌ Mudar o teste para passar em vez de corrigir o código
- ❌ Fix sem repro confirmado ("acho que era isso")
- ❌ Deixar `console.log`/probe no código após o fix
- ❌ Refatorar "já que estou aqui" no meio do diagnóstico
- ❌ Terceiro palpite sem falar com o usuário

## Saída

Ao fechar, reporte em até 5 linhas:
- **Causa raiz:** 
- **Fix:** 
- **Regressão:** 
- **Vizinhos:**

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [calneymgp](https://github.com/calneymgp)
- **Source:** [calneymgp/solodev](https://github.com/calneymgp/solodev)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** yes
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-calneymgp-solodev-dev-fix
- Seller: https://agentstack.voostack.com/s/calneymgp
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.