> ## Documentation Index
> Fetch the complete documentation index at: https://adminroletesting-justin-client-exports.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Escribe documentación con Claude Code

> Configura Claude Code con instrucciones de proyecto en CLAUDE.md para escribir, revisar y actualizar tu documentación de Mintlify siguiendo tu guía de estilo.

Claude Code es una herramienta de línea de comandos con capacidades agentivas que te ayuda a mantener tu documentación. Puede redactar contenido nuevo, revisar páginas existentes y mantener la documentación actualizada.

Puedes entrenar a Claude Code para que comprenda tus estándares y flujos de trabajo de documentación añadiendo un archivo `CLAUDE.md` a tu proyecto y refinándolo con el tiempo.

<div id="getting-started">
  ## Introducción
</div>

**Requisitos previos:**

* Suscripción activa a Claude (Pro, Max o acceso a la API)

**Configuración:**

1. Instala Claude Code:

```bash theme={null}
  npm install -g @anthropic-ai/claude-code
```

2. Ve a tu directorio de docs.
3. (Opcional) Añade el archivo `CLAUDE.md` a tu proyecto.
4. Ejecuta `claude` para empezar.

<div id="claudemd-template">
  ## Plantilla CLAUDE.md
</div>

Guarda un archivo `CLAUDE.md` en la raíz de tu directorio de documentación para ayudar a Claude Code a comprender tu proyecto. Este archivo entrena a Claude Code en tus estándares de documentación, preferencias y flujos de trabajo. Consulta [Manage Claude's memory](https://docs.anthropic.com/en/docs/claude-code/memory) en la documentación de Anthropic para obtener más información.

Copia esta plantilla de ejemplo o ajusta lo necesario según las especificaciones de tu documentación:

```mdx theme={null}
# Documentación de Mintlify

## Relación de trabajo
- Puedes cuestionar ideas: esto puede llevar a una mejor documentación. Cita fuentes y explica tu razonamiento cuando lo hagas
- SIEMPRE pide aclaraciones en lugar de hacer suposiciones
- NUNCA mientas, adivines o inventes nada

## Contexto del proyecto
- Formato: archivos MDX con frontmatter YAML
- Configuración: docs.json para navigation, tema, configuraciones
- Componentes: componentes de Mintlify

## Estrategia de contenido
- Documenta lo justo para el éxito del usuario: ni demasiado, ni muy poco
- Prioriza la precisión y usabilidad
- Haz el contenido duradero cuando sea posible
- Busca contenido existente antes de agregar algo nuevo. Evita la duplicación a menos que se haga por una razón estratégica
- Verifica patrones existentes para mantener consistencia
- Comienza haciendo los cambios más pequeños y razonables

## docs.json

- Consulta el [esquema de docs.json](https://mintlify.com/docs.json) al construir el archivo docs.json y la navigation del sitio

## Requisitos de frontmatter para páginas
- title: Título de página claro y descriptivo
- description: Resumen conciso para SEO/navigation

## Estándares de escritura
- Voz en segunda persona ("tú")
- Prerrequisitos al inicio del contenido procedimental
- Prueba todos los ejemplos de código antes de publicar
- Coincide con el estilo y formato de páginas existentes
- Incluye casos de uso básicos y avanzados
- Etiquetas de lenguaje en todos los bloques de código
- Texto alternativo en todas las imágenes
- Rutas relativas para enlaces internos

## Flujo de trabajo de Git
- NUNCA uses --no-verify al hacer confirmaciones
- Pregunta cómo manejar cambios no confirmados antes de comenzar
- Crea un nuevo branch cuando no exista un branch claro para los cambios
- Haz confirmaciones frecuentemente durante el desarrollo
- NUNCA omitas o deshabilites los hooks de pre-commit

## No hagas
- Omitir frontmatter en ningún archivo MDX
- Usar URLs absolutas para enlaces internos
- Incluir ejemplos de código no probados
- Hacer suposiciones: siempre pide aclaraciones
```

<div id="sample-prompts">
  ## Ejemplos de indicaciones
</div>

Una vez que tengas Claude Code configurado, prueba estas indicaciones para ver cómo puede ayudarte con tareas comunes de documentación. Puedes copiar y pegar estos ejemplos directamente o adaptarlos a tus necesidades específicas.

<div id="convert-notes-to-polished-docs">
  ### Convierte notas en documentación de calidad
</div>

Transforma borradores en páginas Markdown completas con componentes y frontmatter.

**Ejemplo de solicitud:**

```text wrap theme={null}
Convierte este texto en una página MDX con el formato correcto: [pega tu texto aquí]
```

<div id="review-docs-for-consistency">
  ### Revisa la documentación para mantener la coherencia
</div>

Obtén sugerencias para mejorar el estilo, el formato y el uso de componentes.

**Ejemplo de solicitud:**

```text wrap theme={null}
Revisa los archivos en docs/ y sugiere mejoras para mantener la consistencia y claridad
```

<div id="update-docs-when-features-change">
  ### Actualiza la documentación cuando cambian las funcionalidades
</div>

Mantén la documentación al día a medida que tu producto evoluciona.

**Ejemplo:**

```text wrap theme={null}
Nuestra API ahora requiere un parámetro de versión. Actualiza nuestra documentación para incluir version=2024-01 en todos los ejemplos
```

<div id="generate-comprehensive-code-examples">
  ### Genera ejemplos de código completos
</div>

Crea ejemplos en varios lenguajes con manejo de errores.

**Ejemplo de indicación:**

```text wrap theme={null}
Crea ejemplos de código para [tu endpoint de API] en JavaScript, Python y cURL con manejo de errores
```

<div id="extend-claude-code">
  ## Ampliar Claude Code
</div>

Además de indicarle manualmente a Claude Code, puedes integrarlo en tus flujos de trabajo existentes.

<div id="automate-with-github-actions">
  ### Automatiza con GitHub Actions
</div>

Ejecuta Claude Code automáticamente cuando haya cambios en el código para mantener la documentación actualizada. Puedes activar revisiones de documentación en solicitudes de extracción o actualizar ejemplos cuando se detecten cambios en la API.

<div id="multi-instance-workflows">
  ### Flujos de trabajo con múltiples instancias
</div>

Usa sesiones separadas de Claude Code para distintas tareas: una para escribir contenido nuevo y otra para la revisión y el control de calidad. Esto ayuda a mantener la coherencia y a detectar problemas que una sola sesión podría pasar por alto.

<div id="team-collaboration">
  ### Colaboración en equipo
</div>

Comparte con tu equipo el archivo `CLAUDE.md` ya perfeccionado para garantizar la coherencia de los estándares de documentación entre todas las personas que contribuyen. Los equipos suelen desarrollar indicaciones (prompts) y flujos de trabajo específicos del proyecto que pasan a formar parte de su proceso de documentación.

<div id="custom-commands">
  ### Comandos personalizados
</div>

Crea comandos de barra diagonal reutilizables en `.claude/commands/` para tareas de documentación frecuentes específicas de tu proyecto o equipo.

<div id="frequently-asked-questions">
  ## Preguntas frecuentes
</div>

<AccordionGroup>
  <Accordion title="¿Necesito un archivo CLAUDE.md para usar Claude Code con Mintlify?">
    No, pero mejora significativamente la calidad del resultado. Sin un CLAUDE.md, Claude Code trabaja a partir del contexto general y puede no seguir tu guía de estilo específica, tus preferencias de componentes o tu terminología. Un archivo CLAUDE.md entrena a Claude Code en los estándares de tu proyecto para que no necesites volver a explicarlos en cada indicación.
  </Accordion>

  <Accordion title="¿En qué se diferencia Claude Code de Cursor o Devin Desktop para documentación?">
    Claude Code es una herramienta de línea de comandos diseñada para tareas agentivas y de múltiples pasos en un repositorio completo. Es ideal para tareas como auditar todas las páginas en busca de texto alternativo faltante, actualizar el nombre de un parámetro en todos los ejemplos de código o revisar un conjunto de archivos para verificar su consistencia. Cursor y Devin Desktop son herramientas basadas en IDE más adecuadas para editar archivos individuales con sugerencias en línea. Ambos enfoques funcionan: la elección correcta depende de si tu trabajo es archivo por archivo o abarca todo el repositorio.
  </Accordion>

  <Accordion title="¿Puedo usar Claude Code para generar documentación a partir de código automáticamente?">
    Sí. Claude Code puede leer tu código fuente y generar la documentación correspondiente. Apúntalo a un endpoint de API, un archivo de configuración o un conjunto de funciones y pídele que produzca documentación que siga los estándares de tu CLAUDE.md. Revisa y refina el resultado: la generación automatizada funciona mejor cuando tratas a Claude Code como un autor de primer borrador, no como un editor final.
  </Accordion>

  <Accordion title="¿Cómo comparto mi configuración de CLAUDE.md con mi equipo?">
    Haz commit del archivo CLAUDE.md en tu repositorio de documentación. Cualquier persona que clone el repositorio y ejecute Claude Code usará automáticamente la configuración de tu proyecto. Esto hace que los estándares de documentación sean consistentes entre los colaboradores sin necesidad de que cada persona configure su propio contexto.
  </Accordion>
</AccordionGroup>