Repository navigation
bond v1.7.0
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 initla propone cuando eliges la skilldecision-record,
marcada por defecto; al reinicializar, una sección que ya tuvieras se conserva.bond sync
crea<dir>/README.mdcon el formato si falta; después es del repo. Sin[decisions], nada
cambia. bond decisions addregistra 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>.mdcon 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 comoproposed.bond decisions accept,rejectysupersedeson 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 decisionslista (--status,--agent,--json),show <id>enseña una
decisión o un run,runslista los encargos ycheckvalida frontmatter, ids, sustituciones y
trailersDecision:(sale con 1 si hay errores).bond doctorañade una fila con los errores
y las decisiones pendientes de aceptar. - En pi, la herramienta
record_decision(Bond Extensions) llama abond decisions add. - Encargos e informes: con la memoria activa,
bond team promptguarda el encargo exacto en
<dir>/runs/antes de mandarlo (--no-recordpara 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--requesty--agentsirve 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-recordes nueva;plan-create,plan-execute,git-conventional-commit,
delivery-review-githubyconvention-documentregistran y enlazan sus decisiones con la
herramienta;bond-team,plan-teamybond-delegateguardan encargos e informes con
promptycollect. Con la memoria activa, los commits pueden llevar los trailers opcionales
Agent:yDecision:; sin ella, las skills no firman nada. Una regla global debond setup
pide usar la memoria en los repos que la tienen. bond catalog checkfalla si el frontmatter de una skill no es YAML válido (por ejemplo, una
descriptionsin 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 | shWindows: irm https://raw.githubusercontent.com/jmanuelcorral/bond/main/install.ps1 | iex