• Generar un archivo de spec.md
  • Solicitar al modelo que lo formatee como un md correcto
  • /init para que analice todo el codigo (previa configuracion de permisos)
  • Modificar el claude.md indicando al inicio que incluya en el contexto siempre el @spec.md, importante usar @ para indicar el archivo especifico
  • Finetunear el claude.md con instrucciones para que sea muy conciso y especifico.
  • Inicializar session

usar mcps

  • Son simplemente applicaciones que pueden ser usadas por el modelo
  • En claude se instalar usando comandos npx y se pueden visualizar con /mcp
  • Se puede indicar al modelo de forma explicitar usar el mcp
  • interesante que se puede publicar una aplicacion propia como mcp para poder ser usado por el modelo y usar la respuesta

sub agentes

  • Herramientas como claude code los soportan de forma nativa y usan sub agentes para delegar tareas
  • Lo importante es que un sub agente se lanza con un nuevo contexto y no ensucia el contexto original.
  • Es posible crear agentes custom, en .claude/agents.
  • Se trata de un fichero md con cabecera que indica el nombre del agente, descripcion, tools, model que usa
    • Despues es bastante conveniente agregar al claude.md una linea para explicitar al agente principal que para por ejemplo, tareas de buscar documentacion, use y delegue en el sub agente para documentacion.

skills

  • soportados por claude code/open code .claude/skills
  • se pone cada una en una carpeta diferente, y tiene que haber un skill.md
  • requiere agregar md metadata name y description
  • nombre igual que la carpeta
  • Solo la cabecera es cargada en el contexto principal, y el resto se carga solo si el agente principal decide usar la skill
  • Es posible ponerle mas metadata a parte de nombre y descripcion, y todo esta disponible en la doc de claude code.
  • Es preciso mantener las skills breves, ya que una vez que se cargan en el contexto principal se quedan ahi ocupando espacio
  • Las skills pueden cargar ademas mas contenido dinamico, La convencion para esto es crear una carpeta references dentro de la propia skill, y referenciarla en el documento principal indicando cuando puede necesitarse esa documentacion adicional. Esto evita cargar la skill completa para partes que podrian no ser necesarias siempre y que el agente decida si incluirlo en el contexto o no de forma totalmente dinamica.

Flujo de trabajo

  • Una vez configurado todo el proyecto especificar primera instruccion en plan mode
  • Validar el plan e iniciar implementacion limpiando el contexto
  • Si la siguiente tarea es diferente, limpiar contexto antes de planificar
  • De esta forma mantenemos el main context lo mas limpio posible

Commands

  • Similar a agentes y skills
  • Se instalan en .claude/comands tanto a nivel de proyecto como globalmente
  • metamd not required but nice to add a description and a allowed tools
  • acepta declarar argumentos tipo mode: $arguments