Skip to content

bond v1.7.0

Choose a tag to compare

@github-actions github-actions released this 28 Oct 13:40
· 204 commits to main since this release

Memoria de decisiones de los agentes: en un repo con bond, las decisiones, los encargos a otros
agentes y lo que respondieron quedan por escrito en el repo, para auditar después qué hizo cada
uno. La escritura la hace bond, no el modelo: funciona también con modelos locales que no
siguen formatos a mano.

  • Se activa por repo con la sección [decisions] de .bond/bond.toml (dir = "docs/decisions",
    ajustable dentro del repo). bond init la propone cuando eliges la skill decision-record,
    marcada por defecto; al reinicializar, una sección que ya tuvieras se conserva. bond sync
    crea <dir>/README.md con el formato si falta; después es del repo. Sin [decisions], nada
    cambia.
  • bond decisions add registra una decisión: el agente pasa el título, el contexto, la decisión
    y, si las hay, alternativas, consecuencias y enlaces (por flags o JSON con --stdin), y bond
    escribe <dir>/<YYYY-MM-DD-slug>.md con su frontmatter, la rama y el HEAD. La autoría la pone
    bond: en un panel de Herdr, el agente de ese panel (agent:pi/kevin); fuera, user. Siempre
    entra como proposed.
  • bond decisions accept, reject y supersede son del usuario: piden terminal interactiva y
    confirmación, y se niegan desde el shell de un agente. Evita aceptaciones por descuido; no es
    una medida de seguridad (la integridad la da git).
  • Para auditar: bond decisions lista (--status, --agent, --json), show <id> enseña una
    decisión o un run, runs lista los encargos y check valida frontmatter, ids, sustituciones y
    trailers Decision: (sale con 1 si hay errores). bond doctor añade una fila con los errores
    y las decisiones pendientes de aceptar.
  • En pi, la herramienta record_decision (Bond Extensions) llama a bond decisions add.
  • Encargos e informes: con la memoria activa, bond team prompt guarda el encargo exacto en
    <dir>/runs/ antes de mandarlo (--no-record para no guardarlo; si falla al escribir, avisa
    y manda el prompt igual) y le pide al agente que commitee en su rama lo que registre. La nueva
    bond team collect <rama> guarda en el run la última respuesta del agente (de su fichero de
    sesión o, si no se puede, del panel sin el banner de arranque), el estado, los commits de la
    rama y las decisiones de ese agente; se niega mientras el agente trabaja o espera una respuesta
    y repetirlo no duplica nada. Con --request y --agent sirve también para delegaciones sin
    equipo.
  • Las decisiones viajan con la rama y se revisan con el código; no hay un índice compartido que
    dé conflictos entre agentes en paralelo.
  • Skills: decision-record es nueva; plan-create, plan-execute, git-conventional-commit,
    delivery-review-github y convention-document registran y enlazan sus decisiones con la
    herramienta; bond-team, plan-team y bond-delegate guardan encargos e informes con
    prompt y collect. Con la memoria activa, los commits pueden llevar los trailers opcionales
    Agent: y Decision:; sin ella, las skills no firman nada. Una regla global de bond setup
    pide usar la memoria en los repos que la tienen.
  • bond catalog check falla si el frontmatter de una skill no es YAML válido (por ejemplo, una
    description sin comillas con : dentro), que pi se niega a cargar aunque Claude Code lo
    tolere.

Instalar

curl -fsSL https://raw.githubusercontent.com/jmanuelcorral/bond/main/install.sh | sh

Windows: irm https://raw.githubusercontent.com/jmanuelcorral/bond/main/install.ps1 | iex