From 3e58f3de11abfef29db5f8a097c94d7396f437c2 Mon Sep 17 00:00:00 2001 From: Mikael de Souza Silva Date: Sat, 7 Nov 2026 12:33:59 -0300 Subject: [PATCH] docs(changelog): the review workspace, decisions, flow and ask-the-agent Co-Authored-By: Claude Sonnet 5.5 --- CHANGELOG.md | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) diff --git a/CHANGELOG.md b/CHANGELOG.md index d0b504f..7e3647f 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -6,6 +6,25 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), ## [Unreleased] +### Added + +- **A review workspace.** A list on the left (the queue, the structure tree or a flat list of changed files, keys `1` to `3`) and the code of the selected unit on the right, which follows the cursor. `K` opens a symbol panel with the typed signature, the documentation comment and the reasons for the priority. The lists are cards, the sections have headers instead of boxes, and `ui.density` (`comfortable` or `compact`) sets how much air the rows get. +- **Decisions window (`4`).** An agent writes `.klaub/decisions/.json`, the technical decisions of the change, each told for a reader who knows nothing about it. The reader shows one decision per full screen: approve (`a`), reject (`d`) or comment (`c`), and send the rejected and commented ones back to the agent (`f`). `klaub decisions` validates and shows the document. A document for another snapshot is not shown. New `[decisions]` configuration. +- **Flow window (`5`).** A form (focus, kind, detail, reach, size, start, errors, externals) builds the request for the agent; the diagram shows when the agent saves it. `klaub flow prompt` takes the same choices as flags. +- **Ask the agent (`t`, in `klaub wrap`).** Puts the file, flow or decision on screen in the agent's input as context for a question. It never presses `Enter`. `integration.ask_agent_confirms` makes it ask first. +- `Shift+←` goes to the agent and `Shift+→` to the reviewer in a wrapped session, with no prefix. + +### Changed + +- The requests Klaub puts in the agent's input are self-contained and fit one line of at most 3800 characters; the decisions skill is not needed. +- The reader is a reader only. The Impact, Comments, Context, Tests, Follow-up and Coverage screens, and everything that wrote feedback from the reader (commenting a line, finishing a review, delivering to the agent), are gone from it. The review session, the stored reviews and the `feedback`, `tests`, `flow` and `reviews` commands are unchanged. `klaub review --wait` can only report a draft. +- `3` opens the file list; the code has no key of its own (`Enter`, `Tab` or `F4`). A `[keys]` table that moves a removed action is rejected like any unknown id. +- In `klaub wrap`, `Prefix+I`, `C`, `T`, `B` and `L` are gone: they opened removed screens. + +### Removed + +- `integration.paste_requires_confirmation`: nothing read it. It is still accepted in a config file so earlier configs load. + ## [0.6.2] - 2026-11-02 ### Added