# Nueva Feature

> Usar al implementar una funcionalidad nueva de principio a fin

- Skill: `majiayu000/nueva-feature` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/nueva-feature`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/nueva-feature/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/nueva-feature

---


## Cuándo usar esta skill

- Al implementar una nueva funcionalidad completa
- Cuando el usuario pida "añadir", "crear", "implementar" algo nuevo
- Para features que tocan múltiples capas (backend + frontend)

## Contexto necesario antes de empezar

1. Leer archivos relacionados con la feature
2. Identificar qué capas se verán afectadas
3. Verificar si hay patrones similares en el código existente
4. Comprobar dependencias necesarias

## Pasos

### 1. Planificación
- Definir scope exacto de la feature
- Listar archivos a crear/modificar
- Identificar dependencias externas (APIs, configs)

### 2. Backend (si aplica)
- Añadir configuración en `config.py` si es necesario
- Crear cliente en `blueprints/[servicio]_client.py` si hay API externa
- Añadir endpoint en `blueprints/main.py`
- Aplicar `@cache.cached()` si corresponde

### 3. Frontend (si aplica)
- Añadir método en `static/js/dashboard.js`
- Añadir estilos en `static/css/components.css` o `dashboard.css`
- Añadir HTML en template correspondiente

### 4. Validación
```bash
ruff check .
ruff format --check .
python -c "from app import app"
```

### 5. Test manual
- Verificar que la feature funciona en navegador
- Comprobar logs de Flask

### 6. Commit
- Usar skill `@commit` para generar mensaje

<patrones_criticos>
SIEMPRE:
- Seguir patrones existentes en el código
- Añadir logging con `current_app.logger`
- Documentar nuevas variables de entorno en README

NUNCA:
- Instalar dependencias sin preguntar
- Hardcodear valores que deberían ir en config
- Crear archivos fuera de la estructura existente

PREFERENTEMENTE:
- Reutilizar componentes CSS existentes
- Usar `utils.fetchJSON()` en frontend
- Cache para endpoints de lectura
</patrones_criticos>

## Sobre versiones y documentación

Al implementar esta skill, si usas APIs de Flask, requests, o Flask-Caching:
- Verifica la versión en `requirements.txt`
- Consulta el código existente para ver cómo se usa
- Si hay dudas sobre una API, indica qué versión asumes

## Checklist de validación

- [ ] `ruff check .` pasa sin errores
- [ ] `ruff format --check .` pasa
- [ ] La app arranca sin errores
- [ ] La feature funciona en navegador
- [ ] No se han tocado archivos fuera del scope
- [ ] Variables de entorno documentadas si las hay