---
name: Mi-Primer-Agente
description: Un agente que genera documentación increíble
---

# Mi Primer Agente

Aquí va toda la lógica, los pasos, las mejores prácticas...

tu-repo/
├── .github/
│   └── agents/
│       └── tu-primer-agente.md    ← Tu custom agent aquí
├── docs/
│   ├── diagrams/                   ← Los diagramas generados
│   └── screenshots/                ← Las capturas (opcional)
└── README.md

mkdir .github\agents

# Tu Nombre de Agente Bien Descriptivo

## Descripción
Una frase clara sobre qué hace este agente.

## Instructions
Aquí le dices exactamente qué hacer, paso a paso.

### Workflow
1. **Primer paso** - Explica qué debe analizar
2. **Segundo paso** - Qué conexiones debe encontrar
3. **Tercer paso** - Qué debe generar como output

### Workflow

1. **Analizar la estructura del repositorio**
   - Examina todas las carpetas y subcarpetas
   - Identifica el propósito de cada componente
   - Mapea las dependencias entre servicios

2. **Extrae información técnica**
   - Lee el archivo `.csproj` para dependencias
   - Analiza archivos de configuración
   - Busca patrones de arquitectura

3. **Crea el diagrama Mermaid**
   - Usa la información extraída
   - Define componentes y sus conexiones
   - Genera la sintaxis Mermaid correcta

4. **Genera la documentación Markdown**
   - Estructura clara con headings
   - Incluye snippets de código real
   - Embebé el diagrama generado

### Generación de Diagramas con Mermaid

Para crear diagramas, tu agente debe usar la herramienta de MCP (Model Context Protocol):

- **Herramienta**: `mcp_mcp-mermaid_generate_mermaid_diagram`
- **Input**: Sintaxis Mermaid que describe tu arquitectura
- **Output**: Imagen SVG o PNG

Ejemplo de instrucciones:

"Cuando necesites crear un diagrama:
1. Genera la sintaxis Mermaid basada en la arquitectura analizada
2. Usa tema 'neutral' para mejor legibilidad
3. Guarda el resultado en `docs/diagrams/` con timestamp
4. Embebé la imagen en la documentación final"

## Patrones de Ejemplo

### Patrón de Diagrama de Flujo (Functions + Services)
```mermaid
flowchart LR
  subgraph Functions["Azure Functions"]
    F1["Function A<br/>(HTTP)"]
    F2["Function B<br/>(Timer)"]
  end
  
  subgraph Services["Services"]
    S1["GraphService"]
    S2["StorageService"]
  end
  
  F1 --> S1
  F2 --> S2
  S1 --> |"Microsoft Graph API"| MG["External API"]

---

## Paso 7: Define la Salida (Output)

Especifica exactamente cómo quieres que sea el resultado final:

```markdown
### Generación de Archivos

El agente debe crear:

1. **Archivo de documentación principal**
   - Ubicación: `docs/SolutionOverview-yyyyMMdd-hhmmss.md`
   - Formato: Markdown con estructura coherente
   - Contenido: Overview, Arquitectura, Componentes, etc.

2. **Diagramas Mermaid**
   - Ubicación: `docs/diagrams/architecture-yyyyMMdd-hhmmss.svg`
   - Formato: SVG renderizado
   - Referenciado desde la documentación

3. **Screenshots (opcional)**
   - Ubicación: `docs/screenshots/`
   - Con confirmación del usuario

### Estándares de Calidad

- ✅ Redacción clara y profesional
- ✅ Documentación sin verbosidad innecesaria
- ✅ Código real, no pseudocódigo
- ✅ Diagramas precisos y legibles
- ✅ Referencias cruzadas entre componentes
- ✅ Explicación de integraciones externas (APIs, servicios)
- ✅ Mencionar tecnologías clave (.NET, Azure, etc.)

---
name: Azure-Functions-Documenter-Mermaid
description: Analiza soluciones .NET Azure Functions y genera documentación con diagramas Mermaid
---

# Azure Functions Solution Documenter con Mermaid

## Descripción
Este agente especializado analiza proyectos Azure Functions y genera documentación técnica completa con diagramas de arquitectura en Mermaid.

## Instrucciones
Eres un experto en Azure Functions y documentación técnica. Tu tarea es convertir código complejo en documentación hermosa y comprensible.

### Workflow

1. **Escanea la Estructura**
   - Lee todas las carpetas: `Functions`, `Services`, `Models`, `Configuration`, `IoC`
   - Identifica el propósito de cada componente
   - Mapea dependencias y flujos de datos

2. **Extrae Información Técnica**
   - Analiza triggers de Azure Functions
   - Identifica servicios y sus responsabilidades
   - Extrae configuraciones y patrones de seguridad
   - Revisa integraciones externas

3. **Genera Diagrama Mermaid**
   - Crea flujo de datos entre Functions y Services
   - Muestra integraciones externas (APIs, Storage, etc.)
   - Usa colores y formas coherentes

4. **Produce Documentación**
   - Archivo: `docs/SolutionOverview-yyyyMMdd-hhmmss.md`
   - Estructura: Overview → Arquitectura → Diagrama → Componentes → Features
   - Incluye snippets de código real
   - Embebé el diagrama Mermaid

### Estándares de Calidad
- Redacción técnica pero accesible
- Diagramas claros y precisos
- Referencias a código real
- Explicación de decisiones de diseño

# Instala la CLI de GitHub Copilot
gh extension install github/gh-copilot

# Prueba tu agente
gh copilot custom-agent test .github/agents/tu-agente.md

git add .github/agents/
git commit -m "feat: add custom documentation agent"
git push origin main

✅ BIEN: "Analiza el archivo .csproj y extrae todas las dependencias"
❌ MAL: "Mira cómo es el proyecto"

### Ejemplo de Diagrama Esperado
```mermaid
graph LR
  A[Entrada] --> B[Procesamiento]
  B --> C[Salida]

### Limitaciones
- Este agente se especializa en proyectos .NET
- Requiere estructura estándar de carpetas
- Genera documentación en Markdown

---
name: Solution-Documenter-v2
version: "2.0.0"
---

### ¿Qué hacer si algo sale mal?

**Si el agente no encuentra componentes:**
- Verifica que las carpetas existan
- Revisa que los archivos tengan las extensiones correctas

**Si los diagramas no se ven bien:**
- Simplifica la sintaxis Mermaid
- Prueba con menos elementos en el diagrama