From 2b6206aee4abf6ca73016db1fc2c50d07ec91325 Mon Sep 17 00:00:00 2001 From: autocommit Date: Fri, 22 May 2026 16:57:31 -0700 Subject: [PATCH] =?UTF-8?q?docs(decision-recording):=20=F0=9F=93=9D=20Add?= =?UTF-8?q?=20guide=20section=20for=20logging=20and=20reviewing=20project?= =?UTF-8?q?=20decisions?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Lilith Autocommit --- CLAUDE.md | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/CLAUDE.md b/CLAUDE.md index 16532f5..94b1acc 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -46,6 +46,16 @@ straight from `in_progress`. (`user_review → done`); the user may instead bounce it back (`user_review → in_progress`). +## Recording decisions + +When a non-trivial decision is made — about scope, design, tradeoffs, +dependencies, what to defer — call `record_decision(made_by, text, +rationale?, project?, task_ref?)`. Use `made_by="claire"` for decisions +you make, `made_by="user"` for ones the user makes. Keep `text` to one +clear sentence; put context in `rationale`. Link a project or task when +relevant. The Decisions log surfaces in the web app so the user can review +what was decided and by whom. + ## Style Concise, direct. Don't restate what the tools returned — synthesize.