personal_init

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

No hay anotaciones, así que la descripción asume la responsabilidad. Declara efectos importantes: crea o abre la BD, siembra tipos y Self, cachea el engine y es idempotente. No detalla posibles efectos sobre una BD ya existente, pero 'crea/abre' e 'idempotente' mitigan esa ambigüedad.

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?

Es concisa y va al grano, con la acción principal al inicio y detalles de implementación después. La referencia a 'D18' añade contexto interno pero no es esencial; en general cada frase aporta información útil.

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?

Para un solo parámetro y con esquema de salida presente, la descripción cubre el propósito, la idempotencia, el cacheo y la relación con el CLI. Podría precisar qué ocurre si la BD ya existe o si el sembrado de tipos es condicional, pero en conjunto es suficiente para invocarla correctamente.

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?

Aunque la cobertura del esquema es 0%, la descripción sí aclara el significado del único parámetro: path es la ubicación de la BD. Es suficiente para un parámetro string obligatorio, aunque no da más detalles sobre formato o restricciones.

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 y un recurso concreto: 'crea/abre la BD en path, siembra tipos y el Self'. Deja claro que es la inicialización del almacén personal y no se confunde con las operaciones de consulta o escritura de entidades que aparecen en los hermanos.

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?

Explica que comparte orquestación con el CLI 'hippocampus init', lo que ayuda a decidir cuándo usar esta herramienta en lugar de la CLI. También indica que añade comportamiento específico del servidor, aunque no menciona explícitamente cuándo no usarla frente a las demás herramientas personales.

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