Artifact SUBAGENT: define un agente especialista

El contrato de dos partes

El manifest declara artifact_type SUBAGENT y content.entrypoint. El archivo entrypoint contiene instrucciones del agente: rol, límites, inputs, output esperado y comportamiento ante fallos.

Mantén el entrypoint como texto plano o markdown UTF-8. HubBound lo lee del bundle y escribe metadata de agente específica del provider; no ejecuta el archivo.

{ "entrypoint": "agent.md" }

Escribe instrucciones útiles

Un buen archivo de subagent dice qué posee el agente y qué no debe hacer. Declara la tarea, el contexto confiable, las herramientas o archivos que debe inspeccionar, el formato de salida y cuándo pedir ayuda.

• Dale una responsabilidad estable y específica, como auditar dependencias o redactar release notes.
• No embebas credenciales, prompts ocultos ni paths absolutos de una máquina.
• Usa ejemplos para el formato de output, no para secretos ni comandos destructivos sin revisar.
• Mantén referencias de apoyo en el mismo paquete e inclúyelas en files.

Entrada de manifest de ejemplo

El deployment apunta a un archivo de agente relativo. El paquete puede tener referencias adicionales, pero el entrypoint debe estar en el snapshot.

{
  "release-notes-agent": {
    "kind": "artifact",
    "path": "packages/release-notes-agent",
    "tag": "vendor/release-notes-agent",
    "version": "1.0.0",
    "visibility": "org",
    "artifact_type": "SUBAGENT",
    "content": { "entrypoint": "agent.md" },
    "files": ["agent.md", "references/**"]
  }
}

Comportamiento por provider

Claude Code y Codex usan el entrypoint como developer instructions de un agente nombrado. Otros providers pueden materializar un archivo de agente en su formato o reportar que todavía no soportan el tipo. Por eso el tipo es neutral, pero el reporte de install es la autoridad.