CleanLanguage.ai

Before and after

How far the standard intervenes

These 9 examples show degree of intervention rather than fixed templates. Every revised version uses only facts present in its source. Where a stronger version needs a specific figure or actor, the source supplies it; the skill never invents one to replace a vague statement.

Note

This is the actual guidance the skill uses. Every pair on this page is generated from the skill’s example set. Read the exact source, examples.md, on GitHub (opens in a new tab).

Example 1

Lead with the conclusion

Before

It is worth noting that there are several areas where the current implementation could create challenges: unclear ownership, no rollback procedure, and an untested recovery path.

After

The current implementation has 3 unresolved points: unclear ownership, no rollback procedure, and an untested recovery path.

The hedge goes and the count leads. All 3 points survive unchanged.

Example 2

Delete the framing

Prefer deleting a framing phrase to replacing it with another. The facts already in the draft carry the message.

Before

I wanted to take a moment to flag that the vendor contract expires on 31 March.

After

The vendor contract expires on 31 March.

Before

As we navigate today's fast-moving threat landscape, the firewall rules have not been reviewed since January.

After

The firewall rules have not been reviewed since January.

Before

This section outlines the 3 issues we found: missing backups, an expired certificate, and an open admin port.

After

We found 3 issues: missing backups, an expired certificate, and an open admin port.

Example 3

Remove artificial balance

Before

The team has been working hard, but the process still lacks an accountable owner, an approval gate, and tested recovery.

After

The process lacks an accountable owner, an approval gate, and tested recovery.

Add progress or mitigating evidence only when it changes the assessment; a specific, material gain is a fact and stays.

Example 4

Preserve technical agency

Source

After the change review, the infrastructure team configured the firewall to block inbound connections from untrusted networks and confirmed that the firewall now blocks them.

Preferred when the configuration is the relevant fact

The firewall blocks inbound connections from untrusted networks.

Preferred when accountability is the relevant fact

The infrastructure team made that firewall change.

Either fact can lead, depending on which one matters.

Example 5

Preserve useful adverbs

Weak modifier

The system is extremely unreliable.

Preferred, when data supports it

The service dropped 14 percent of requests during the test window.

Use the specific figure only when the source or a measurement provides it; otherwise keep the statement qualitative and flag the missing measurement.

Legitimate modifier

The encryption keys are cryptographically isolated from the application workload.

Example 6

Executive request

Before

I wanted to reach out to see if we could align on the warehouse project: the owner, the critical path, the unresolved dependencies, and the recovery plan, before Thursday at 3 p.m.

After

Please confirm the warehouse project's owner, critical path, unresolved dependencies, and recovery plan before 3:00 p.m. Thursday.

The ask becomes explicit and the deadline exact. All 4 items are unchanged.

Example 7

Replace executive template phrasing

Before

The agenda looks highly relevant to my work, particularly the sessions on regulatory interoperability, cyber resilience, and audit readiness.

After

The agenda covers 3 areas I work on: regulatory interoperability, cyber resilience, and audit readiness.

Keep the same topics and state the writer's connection to them, rather than asserting relevance with an intensifier.

Abstract-noun frame

My main areas of interest are AI governance and cybersecurity.

Preferred, as a direct statement

I am interested in AI governance and cybersecurity.

Example 8

Incident status

Before

The situation appears to be under control, and the team is continuing to work diligently: the affected server is isolated, file transfers resumed at 06:40, the root cause is not yet confirmed, and the legacy environment still requires rebuild approval.

After

The affected server is isolated. File transfers resumed at 06:40. The root cause is not yet confirmed, and the legacy environment still requires rebuild approval.

The reassurance goes. The 4 facts stay, in the same order.

Example 9

Proofreading with minimal intervention

Source

The vendor have confirmed they will provide there response by Friday and we should be able to review it early next week.

After

The vendor has confirmed that it will respond by Friday. We should be able to review the response early next week.

The source is a flawed draft on purpose. “vendor have” and “there response” are the errors a proofreading pass catches; the corrected version fixes the agreement and rewrites the second as “respond”.

Without that, it reads as the object of confirmed; the inserted that marks it as the subject of a clause.

Do not restructure a proofreading request into an executive rewrite unless clarity requires it.

By channel

The same standard, tuned to the context

Clean Language applies the same precedence order everywhere, then adapts to the channel and document type. The rules for each of the 8 channels cover executive, technical, governance, incident, email, chat, report, and humorous writing.

Try it

Try it on your own writing

Copy a prompt and run it against your own draft, or install the skill so the standard is available in any chat.