A bordoMapa de misión
Antes de que el modelo lea tu description, lee el nombre. Si tenés 15 tools registradas y la intención del usuario es "agregale 50 unidades al stock", el modelo va a escanear los nombres primero. Las que matchean por verbo y sustantivo suben en la pila. las que no, se ignoran de entrada.
Por eso un buen nombre de tool ya es media descripción. No te ahorra escribir la description (es el contrato), pero te ahorra que el modelo nunca llegue a leerla.
verbo_sustantivo[_detalle]Ejemplos del repo de Forge:
lookup_crewmate (lee)assign_shift (escribe)notify_crewmate (efecto externo)add_inventory (escribe, suma)mark_item_low_stock (escribe, marca)cart_checkout (escribe, transición de estado)Patrón consistente. El modelo no tiene que adivinar si "shift" es verbo o sustantivo, porque siempre ve verbo_shift o shift_verbo.
| Intención | Verbo recomendado | Anti-ejemplo |
|---|---|---|
| Traer un item | get_ / lookup_ | find_ (ambiguo: ¿uno o varios?) |
| Traer varios | list_ / search_ | query_ (técnico, fuera de dominio) |
| Crear nuevo | create_ / add_ | do_ / new_ |
| Modificar existente | update_ / set_ | change_ (suena destructivo) |
| Borrar | delete_ / remove_ | clear_ (ambiguo: ¿uno o todos?) |
| Efecto externo | send_ / notify_ / publish_ | do_ |
| Marcar estado | mark_ / flag_ | set_status_ (verboso) |
Un nombre malo + una description buena gana a un nombre bueno + una description mala. pero un nombre bueno + una description buena gana a las dos. Tomate los 30 segundos para elegir bien el verbo.