From 9f1a2fd067326263771da212074777ffc4291a59 Mon Sep 17 00:00:00 2001 From: Ahmed ElMallah Date: Sun, 25 Oct 2026 12:53:07 -0700 Subject: [PATCH] docs(agents): an ADR request in an issue or plan is still held to the bar Issues written before the ADR cleanup ask for "an ADR under dev-docs/adr" in their acceptance lists, and an agent following them wrote two records (bomly-cli ADR-0050 and ADR-0051) that failed the bar and were folded back into ADR-0020 and ARCHITECTURE.md in bomly-cli#531. The rule now says such a request asks for the decision to be recorded, not for a new file: the bar still decides, and a passing decision revises the live record that owns the topic first. The same section appears in both repositories and changes in both. Co-Authored-By: Claude Opus 5.5 --- AGENTS.md | 9 +++++++-- 1 file changed, 7 insertions(+), 2 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index c0453fe..6bce812 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -54,8 +54,13 @@ is expensive (an output or wire contract, a cross-repository or security boundary, a public claim), and the reason is not visible from the code or a guard's message. About 300 words, never more than about 400, one decision per file, with the rejected alternative and what enforces it; revise in place -rather than appending amendments. Everything else is a doc comment on the code -or a paragraph in this file. The full rule is +rather than appending amendments. An issue, plan or acceptance checklist that +asks for an ADR is asking for the decision to be recorded, not for a new file, +and the bar above still decides: when the decision fails it, the reasoning +goes in a doc comment or a paragraph in this file and the pull request says +so; when it passes, revise the live record that owns the topic, and start a +new one only when none does. Everything else is a doc comment on the code or a +paragraph in this file. The full rule is [`bomly-cli/dev-docs/adr/README.md`](https://github.com/bomly-dev/bomly-cli/blob/main/dev-docs/adr/README.md); the same section appears in bomly-cli's `AGENTS.md`, so change both together.