---
name: journal-suggestions
description: Load it when you would propose a change nobody asked for. An accepted or adjusted suggestion becomes a to-do that cites it; a decline files nothing.
keywords: suggestions, suggestion
commands: suggestions
---

# Suggestions

An accepted or adjusted suggestion becomes a to-do that cites it; a decline files nothing.

When you see a change worth making that nobody asked for, do not mention it in your reply: file it with journal suggestion suggest "<the change>" --brief "<what you saw, what it costs now and later>". Nothing waits on it.

It shows in the chat as a card, and one still unanswered after suggestions.window_after hours opens once in a window, but only suggestions.start_grace minutes after the journal started. The user accepts, adjusts or declines it in the viewer. An accept or an adjust files a to-do that carries the suggestion's title and brief, or the user's own words when adjusted, and auto mode works it like any other. A decline is a ruling: never propose the same change again in other words. If something has changed since, say so with --set despite=true --set because="<what changed>". At most five wait at a time; when a sequence step has more, write the rest into its report and link it. Withdraw one that stopped being true with journal suggestion withdraw <n> --why "<why>".

Its lines and guards are for the main agent only; none reach a subagent.
