> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ugps.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Desarrollo Raul

> Mapa interno de arquitectura IA, agentes, tools y runtime de Raul

## Para que sirve esta seccion

Usa esta seccion cuando necesites entender o cambiar la capa de IA de Raul.

Aqui viven las decisiones que mas impactan desarrollo diario:

* que agente existe y en que modulo corre
* que tools puede usar cada agente
* como se cargan prompts y modelos
* donde entra LangSmith, Foundry y el flujo de Autofix

<Note>
  Esta documentacion esta pensada como documentacion interna. La proteccion real la pone Mintlify Authentication; `hidden: true` no reemplaza auth.
</Note>

## Mapa rapido

<CardGroup cols={2}>
  <Card title="Arquitectura IA" icon="diagram-project" href="/development/ai-architecture">
    Vista general de modulos, runtime compartido y flujos principales.
  </Card>

  <Card title="Agentes" icon="bot" href="/development/agents-overview">
    Equipos, responsabilidades, entrypoints y bundles de tools por agente.
  </Card>

  <Card title="Catalogo de tools" icon="toolbox" href="/development/tool-catalog">
    Capability bundles, agentes autorizados y archivos fuente del registry.
  </Card>

  <Card title="Runtime y tracing" icon="cpu" href="/development/runtime-and-tracing">
    Model profiles, prompts, LangSmith, MCP y operacion local.
  </Card>

  <Card title="Autofix" icon="wand-magic-sparkles" href="/development/autofix-architecture">
    Grafo hibrido, critic loop y uso de Anthropic via Azure Foundry.
  </Card>
</CardGroup>

## Regla operativa

Si un PR cambia agentes, tools, prompts o runtime IA, actualiza esta seccion en el mismo PR.

<Warning>
  No documentes secretos, API keys ni SOPs sensibles aqui. Aunque el sitio sea interno, la documentacion debe seguir siendo segura para compartir dentro del equipo.
</Warning>

## Fuentes de verdad

* `apps/api-nestjs/src/modules/teams-bot`
* `apps/api-nestjs/src/modules/ai-support`
* `apps/api-nestjs/src/modules/quoter/ai`
* `apps/api-nestjs/src/modules/sentry-autofix`
* `apps/api-nestjs/src/modules/plataforma/agents/application/tool-registry`
* `apps/api-nestjs/src/shared/infrastructure/services`
* `.mcp.json`
* `scripts/langsmith-mcp.sh`
* `.agents/skills/microsoft-foundry`


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.