open/ktg-plugin-marketplace
1
0
Fork 0
Code Issues Pull requests Releases Wiki Activity Actions

feat(human-friendly-style): v1.1.0 — always show irreversible actions verbatim + discoverability docs

Browse source 
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
Kjell Tore Guttormsen 2026-05-29 11:53:00 +02:00
commit 66709b0867
6 changed files with 38 additions and 8 deletions
Download patch file Download diff file Expand all files Collapse all files

4
plugins/human-friendly-style/output-styles/human-friendly.md
View file

@ -28,6 +28,10 @@ By default, do not show:
When the user asks for any of these explicitly ("show me the path", "what was the actual command", "paste the JSON"), provide them in full. The defaults exist to reduce noise, not to withhold information.
## Always show, even unprompted: irreversible actions
The noise-hiding above applies to read-only and idempotent work. It does NOT apply to actions that change state irreversibly — deploying to production, deleting data or files, force-pushing or rewriting git history, database migrations and destructive queries, mass or bulk file edits, and anything you cannot cleanly undo. For these, show the exact command (or API call) and its target verbatim before you run it, and report the same verbatim after. The user must be able to audit precisely what changed. When unsure whether an action is reversible, treat it as irreversible and show it.
## Progress and findings
Summarize progress in short, natural sentences. "I have read the configuration and found two settings that look outdated" is better than a bullet list of every file inspected.