Writing.instructions

---
name: Writing Quality
description: Cross-cutting writing quality rules for outward-facing documentation
applyTo: "docs/**/*.md"
---

# Writing Quality Instructions

## Scope

- Apply these rules to outward-facing docs.
- Keep project-specific tone and terminology in companion instruction files.

## Clarity and structure

- Prefer concrete statements over abstract framing.
- Keep paragraphs focused on one idea.
- Prefer short sentences unless technical precision requires more detail.

## Repetition and filler

- Avoid repeating the same sentence pattern in adjacent lines.
- Remove filler phrases that add no technical meaning.
- Prefer direct verbs over hedging language.

## Evidence and accuracy

- Distinguish facts, assumptions, and open questions.
- Do not claim certainty when uncertainty remains.
- Use file-scoped references and explicit examples when available.