Standard for creating technical documentation in this repository. Use this when writing new documentation in docs/ to ensure consistent hierarchy and formatting.

2026-02-022

mermaid-diagrams

FullFran/Hybrid-RAG-example

Expert guidance on creating accurate, visually polished Mermaid diagrams for architecture documentation.

2026-02-022

mongodb

FullFran/Hybrid-RAG-example

Expert guidance on MongoDB implementation for RAG, including aggregation pipelines and search patterns.

2026-02-022

pydantic-ai

FullFran/Hybrid-RAG-example

Expert guidance on building agents and tools with Pydantic AI.

2026-02-022

python-async-patterns

FullFran/Hybrid-RAG-example

Best practices for async Python code, avoiding common pitfalls like await precedence bugs and sync-in-async anti-patterns.

2026-02-022

name	architecture-decision-record
description	Help the team document and maintain Architecture Decision Records (ADRs).

Architecture Decision Record (ADR) Skill

Esta skill permite al agente ayudar al equipo a documentar decisiones técnicas importantes para mantener un rastro histórico de la arquitectura.

Cuándo usar

Al elegir una nueva base de datos o framework.
Al cambiar un patrón de diseño global (ej: pasar de REST a GraphQL).
Al establecer convenciones de código obligatorias.

Estructura del ADR

Los archivos deben guardarse en docs/adr/NNNN-nombre-descriptivo.md con:

Título: Breve y claro.
Estatus: Propuesto, Aceptado, Superado o Rechazado.
Contexto: ¿Cuál es el problema y qué opciones hay?
Decisión: ¿Qué se ha elegido y por qué?
Consecuencias: ¿Qué ganamos y qué perdemos con esto?

Proceso

Ayuda al usuario a articular la decisión.
Genera el markdown siguiendo la plantilla.
Asegúrate de que el número sea correlativo al último ADR en docs/adr/.
Ejecuta npm run sync si la decisión afecta al framework de agentes.