existential-birds/langgraph-code-review

¿Qué hace langgraph-code-review?

Revisa código de LangGraph en busca de errores, antipatrones y mejoras. Úsalo al revisar código que utiliza StateGraph, nodos, aristas, checkpointing u otras características de LangGraph. Detecta errores comunes en la gestión de estado, estructura del grafo y patrones asíncronos.

¿Qué revisa?

• StateGraph: definición correcta del estado, tipado y adición de nodos/aristas.
• Nodos: implementación como funciones o callables, errores de parámetros y de retorno.
• Aristas: conexiones correctas entre nodos, aristas condicionales y su lógica.
• Checkpointing: uso adecuado de puntos de control y persistencia de estado.
• Patrones asíncronos: manejo de async/await en nodos y ejecución concurrente.
• Antipatrones comunes: como mutación de estado fuera del grafo, dependencias circulares o errores de serialización.

Cómo usarlo

1. Selecciona el código que deseas revisar (por ejemplo, un archivo .py que defina un grafo LangGraph).
2. Ejecuta el comando: /review o escribe "Revisa este código de LangGraph" como prompt.
3. La habilidad generará un informe con hallazgos clasificados por severidad: error, advertencia y sugerencia.

Ejemplo de salida

## Revisión de LangGraph Code Review
### Error
- **Nodo `process_data`**: falta el parámetro `state` requerido por el contrato de nodo LangGraph.
### Advertencia
- **Arista condicional**: la función `route_decision` no retorna un valor válido para las rutas definidas.
### Sugerencia
- **Checkpointing**: considera habilitar `checkpointer` para habilitar reinicio en caso de fallo.

Compatibilidad

• Plataformas: Claude Code, Cursor, Codex.
• Lenguaje: Python (compatible con LangGraph v0.1+).
• Dependencias: Ninguna externa; usa la lógica de revisión basada en reglas de LangGraph.

Notas

• Esta habilidad complementa herramientas de linting como mypy y pylint, pero se especializa en reglas de LangGraph.
• Para habilitar el modo automático, activa la revisión en cada commit con un hook de pre-commit.
• Reporta problemas o sugiere mejoras en el repositorio oficial de la habilidad.