Skip to content

docs(changelog): the review workspace, decisions, flow and ask-the-agent #56

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
myrk-kale merged 1 commit into from
Nov 7, 2026
+19 −0
Merged

docs(changelog): the review workspace, decisions, flow and ask-the-agent #56

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
19 changes: 19 additions & 0 deletions CHANGELOG.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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/<snapshot>.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
Expand Down
Loading