# Refactor

> Mejora la estructura y la legibilidad del código SIN cambiar el comportamiento observable, en pasos pequeños y seguros guiados por las convenciones del proyecto, manteniendo los tests en verde. Úsalo cuando la persona pida refactorizar, limpiar, reestructurar o reducir la duplicación en el código sin añadir funcionalidades ni corregir errores (p. ej. "refactoriza este módulo", "limpia esta funció…

- **Type:** Skill
- **Install:** `agentstack add skill-brayandiazc-project-starter-template-es-ai-refactor`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [brayandiazc](https://agentstack.voostack.com/s/brayandiazc)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [brayandiazc](https://github.com/brayandiazc)
- **Source:** https://github.com/brayandiazc/project-starter-template-es-ai/tree/main/.claude/skills/refactor

## Install

```sh
agentstack add skill-brayandiazc-project-starter-template-es-ai-refactor
```

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

## About

Refactoriza el código indicado preservando el comportamiento.

1. Lee la guía relevante en `docs/conventions/` (estilo, arquitectura, nombres) y síguela — las convenciones definen qué significa "mejor estructura" aquí.
2. Establece primero una red de seguridad: identifica los tests que cubren el código objetivo y ejecútalos para confirmar que pasan antes de tocar nada. Si falta cobertura, anota el riesgo y considera añadir un test de caracterización.
3. Refactoriza en pasos pequeños que preserven el comportamiento, por ejemplo:
   - Renombra para mayor claridad; extrae una función/componente/módulo; integra (inline) indirecciones innecesarias.
   - Elimina duplicación; simplifica condicionales; ajusta los tipos.
   - Reduce el acoplamiento según las convenciones de arquitectura.
4. Después de CADA paso significativo, vuelve a ejecutar los tests (y el linter/formateador si están configurados) y mantenlos en verde. Revierte un paso que los rompa en lugar de parchear el comportamiento.
5. Resume qué cambió estructuralmente y confirma que las APIs públicas y el comportamiento observable no han cambiado.

NO cambies el comportamiento, las APIs públicas ni la salida — si parece necesario un cambio de comportamiento, detente y plantéalo por separado. NO mezcles nuevas funcionalidades ni correcciones de errores. NO hagas una reescritura gigante de una sola vez; prefiere incrementos revisables.

## Source & license

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

- **Author:** [brayandiazc](https://github.com/brayandiazc)
- **Source:** [brayandiazc/project-starter-template-es-ai](https://github.com/brayandiazc/project-starter-template-es-ai)
- **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:** no
- **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-brayandiazc-project-starter-template-es-ai-refactor
- Seller: https://agentstack.voostack.com/s/brayandiazc
- 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%.
