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

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

View file

@ -1,7 +1,9 @@
# Human-Friendly Style v1.0.0
# Human-Friendly Style v1.1.0
Shared output style for ktg-plugin-marketplace. Single deliverable: `output-styles/human-friendly.md`.
v1.1.0 added an **irreversible-action carve-out**: the hide-by-default noise reduction has one exception — destructive or unrecoverable operations (prod deploy, delete, force-push, git-history rewrite, DB migration, bulk file edits) are shown verbatim (command + target) before and after, even unprompted, so the user can approve and audit. Style stays nine directives, still zero commands/agents/hooks; the carve-out is best-effort model guidance, not an enforced guard (a hook would be a separate plugin).
## Purpose
Give every plugin in the marketplace a consistent, plain-language tone. Users install this once, activate via `/config`, and get the same conversational style regardless of which plugin they invoke.
@ -42,6 +44,6 @@ If `keep-coding-instructions` is removed or set to `false`, Claude Code will str
## Out of scope
- Per-plugin variants (code-focused, deep-technical, etc.) — would belong in a future v1.1 if there's real demand
- Per-plugin variants (code-focused, deep-technical, etc.) — would belong in a future v1.x if there's real demand
- Forcing the style on other plugins — it remains opt-in. Other plugins may reference it in their READMEs.
- Translation of the style file itself into Norwegian — defeats the purpose of language-agnostic instruction