# grounded-copy

[](https://github.com/HiroHyun/grounded-copy/actions/workflows/copy-lint.yml) [](LICENSE)

A style gate for marketing and web copy. It enforces one rule: every value proposition states what the subject IS or DOES — a feature, a number, a mechanism. It detects contrast framing in its documented forms, plus hype vocabulary and vague attribution. English gets full per-shape coverage and eight more languages get trigger lists, at the depths the table below sets. A deterministic Python linter backs the rules and blocks the task until the copy complies.

In Claude Code, two hooks carry the same rules into every session, so chat replies follow them alongside landing pages and locale files.

## The off switch

The profile controls whether the hooks inject the rules. Set `off` for source text that must retain its supplied wording:

```shell /grounded-copy:grounded off ```

Write the text, then `/grounded-copy:grounded chat` (or `copy`) to switch back. The topics that need it: legal disclaimers, terms of service, regulatory copy, billing facts, and translations of source text someone supplied. The stored value survives restarts, so a switch left at `off` stays there until you set it back. Outside Claude Code the linter is a command you run, so the same escape is running it on the files you choose.

## Before and after

| Draft | After grounded-copy | |---|---| | Vague task-tracker slogan | The tracker links every task to its pull request and posts a status digest to Slack each morning. | | Hidden-fee slogan | The listed price is the complete price; the invoice adds nothing. | | Unnamed expert claim | Acme holds 34% of the segment, per Gartner's 2025 market report. |

Same information, carried by specifics. `references/patterns.md` holds a rewrite for every shape.

## How it works

Paths named below