Brayancode Agent — Development skill for Claude Code

BrayanCode

Un agente de programación en Python para acompañar el video **Construí mi propio Claude Code desde cero**.

La idea es sencilla: poner un modelo de lenguaje dentro de un `while`, darle herramientas y devolverle los resultados de lo que pide. Este repositorio permite ver ese ciclo en una interfaz web y observar sus mensajes JSON en la terminal.

El cerebro y el arnés

El modelo es el cerebro: recibe una conversación y genera una respuesta. Esa respuesta puede ser texto para el usuario o una solicitud para usar una herramienta.

El arnés es el programa que conecta esa respuesta con tu máquina. Aquí está escrito en Python y ofrece tres herramientas:

Herramienta	Qué ejecuta Python
read_file	Lee un archivo del proyecto.
write_file	Crea o sobrescribe un archivo y calcula el diff.
run_terminal	Ejecuta un comando y captura su salida y código de retorno.

El modelo no abre archivos ni ejecuta comandos por sí mismo. Recibe un catálogo de funciones con sus argumentos y solicita una de ellas; Python se encarga de ejecutarla.

El bucle

flowchart LR
    U[Petición del usuario] --> M[Consultar al modelo con el historial y las herramientas]
    M -->|Solicita una herramienta| P[Python la ejecuta]
    P --> H[Agregar el resultado al historial]
    H --> M
    M -->|Responde sin herramientas| F[Mostrar respuesta y terminar]

Esta es una versión reducida de `run_real_agent_stream`, omitiendo la interfaz, la telemetría y el manejo de errores. `ejecutar_herramienta` representa el despacho a las tres funciones locales:

messages = [{"role": "system", "content": SYSTEM_PROMPT}] + historial
steps = 0

while steps < MAX_STEPS:
    steps += 1
    response = client.chat.completions.create(
        model=model,
        messages=messages,
        tools=TOOLS_SCHEMA,
    )
    assistant = response.choices[0].message
    messages.append(assistant)

    if not assistant.tool_calls:
        print(assistant.co