crear_diagrama_proyecto

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No hay anotaciones, así que la descripción asume toda la carga, y revela el comportamiento esencial: lee el proyecto, sintetiza su arquitectura y escribe un archivo .html autónomo e interactivo, incluyendo la ubicación por defecto (docs/diagrama_interactivo.html), lo que transparenta el efecto secundario de escritura. No obstante, omite comportamientos ante casos límite como rutas inválidas, proyectos no soportados o tiempos de análisis en proyectos grandes.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Is the description appropriately sized, front-loaded, and free of redundancy?

Aproximadamente 70 palabras: una frase principal que promete el valor clave (análisis + generación directa) seguida de una lista Args consistente y escaneable. Cada oración aporta información no redundante y el contenido más importante está al frente.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Existe output schema, por lo que los valores de retorno están cubiertos, y los parámetros quedan totalmente aclarados en la descripción. Faltan elementos relevantes para una herramienta de análisis compleja: criterios de selección frente a los hermanos, tipos de proyecto/lenguajes soportados, y comportamiento ante errores o proyectos no analizables.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Con 0% de cobertura en el esquema, la descripción compensa completamente documentando los tres parámetros con significado, opcionalidad y valores por defecto: project_path como ruta absoluta, output_path con su destino y default, y titulo con su fallback al nombre de la carpeta del proyecto. Esto supera ampliamente la línea base exigible cuando el esquema no aporta nada.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Does the description clearly state what the tool does and how it differs from similar tools?

La descripción usa un verbo específico ('genera') sobre un recurso claro (diagrama interactivo .html) y detalla el flujo completo: analiza, detecta capas, sintetiza arquitectura y produce el archivo. El calificativo 'Todo en Uno' y la generación 'directamente' la diferencian de los hermanos analizar_proyecto (solo análisis), generar_diagrama_desde_mermaid (requiere mermaid) y convertir_archivo_mermaid (solo conversión).

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Does the description explain when to use this tool, when not to, or what alternatives exist?

La etiqueta 'Herramienta integral Todo en Uno' y el adverbio 'directamente' transmiten por implicación que esta herramienta es para obtener el diagrama completo desde una ruta de proyecto, en contraste con las herramientas hermanas que cubren pasos aislados. Sin embargo, no hay criterios explícitos de cuándo usarla ni exclusiones del tipo 'si ya tienes mermaid, usa generar_diagrama_desde_mermaid'; el agente debe inferir la ruta de decisión.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.