no-slop-writing
Eliminates AI slop, corporate buzzwords, filler transitions, and ungrounded claims from technical documents, PRDs, and agent outputs. Use as a strict quality gate for high-density engineering and product writing.
No-Slop High-Density Writing Gate
Zero filler, zero buzzword salads, and 100% claim-to-evidence grounding for engineering docs and PRDs.
Quick Start
# Ban-list scanner that flags high-entropy AI slop and corporate filler phrases
SLOP_PHRASES = (
"delve into", "testament to", "tapestry of", "paradigm shift",
"synergistic", "holistic approach", "unlock the full potential",
"инновационные решения", "синергия", "комплексный подход", "вывести на новый уровень",
)
def scan_for_slop(text: str) -> list[str]:
low = text.lower()
return [phrase for phrase in SLOP_PHRASES if phrase in low]
assert scan_for_slop("Deploy CloudNativePG with 3 replicas across 3 AZs for RPO=0.") == []# High-Density Claim Rule: [Subject] + [Exact Action] + [Quantified Effect] + [Verification]
- Bad (Slop): "Our next-gen platform utilizes holistic caching to dramatically boost performance."
- Good (Dense): "Redis Cache-Aside with a 60s jittered TTL serves 85% of product reads in 1.8ms, reducing PostgreSQL CPU from 78% to 19%."When to Use
- Auditing technical RFCs, architecture decision records (ADRs), PRDs, or READMEs for fluff and empty corporate slogans
- Enforcing strict token efficiency and factual precision in LLM system prompts and agent outputs
- Removing repetitive meta-announcements ('In this section we will explore...', 'In conclusion, it is clear that...')
- Ensuring every technical recommendation includes trade-offs, failure modes, and verification commands
Best Practices
- Lead every section with the answer or decision in sentence 1; never bury the conclusion at the bottom of a long preamble.
- Ban meta-roadmaps ('Below is a breakdown of...', 'Let us now turn our attention to...') — let headings do the routing.
- Require every architecture choice to state what it sacrifices (e.g., 'Synchronous replication guarantees RPO=0 at the cost of +1.5ms write latency').
- Replace bullet lists of single abstract nouns ('Scalability', 'Security', 'Reliability') with declarative assertion headers.
- Delete any sentence that remains true if you insert 'not' (e.g., 'We care about quality' -> nobody claims they hate quality).
- Keep word count tight: if a 600-word RFC can state the exact same schema, API contract, and rollback plan in 250 words, cut the 350.
Dependencies
# Run automated slop and word-density checks
python3 --versionExamples
# Calculate information density ratio (numbers, code tokens, and concrete identifiers per 100 words)
import re
def info_density_per_100_words(text: str) -> float:
words = text.split()
if not words:
return 0.0
signals = re.findall(r"(`[^`]+`|\b\d+[a-zA-Z%/.:-]*\b|\b[A-Z]{2,}\b)", text)
return round(len(signals) / len(words) * 100.0, 1)
assert info_density_per_100_words("Set `max_connections=200` on PostgreSQL 16 and route via PgBouncer on port 6432 for <2ms p99.") >= 25.0# Declarative Section Headers (Assertion-Evidence Pattern)
- Weak header: "Database Architecture"
- Strong header: "CloudNativePG 3-Node Quorum Guarantees RPO=0 and <10s Failover"Step-by-Step
1. Run scan_for_slop() across the draft and delete every flagged phrase and surrounding filler clause.
2. Strip introductory throat-clearing and closing 'In Conclusion / Key Takeaways' recaps that repeat earlier bullets verbatim.
3. Rewrite generic topic headings into declarative assertions containing the core metric or architectural decision.
4. Check info_density_per_100_words() and replace hand-wavy claims with exact configuration keys, numbers, or links.
5. Add an explicit 'Trade-offs & Failure Modes' bullet for every proposed tool or architecture.
Validation
1. scan_for_slop() returns zero matches across the entire document
2. info_density_per_100_words() is >= 12.0 on technical specification sections
3. Zero sections begin with meta-announcements ('Below is...', 'In this section...')
4. Every architectural recommendation states both its quantified benefit and its operational cost/trade-off
Troubleshooting
- Document feels too terse for newcomers — add a 2-sentence concrete context example at the top rather than padding every paragraph with adjectives.
- Writer struggles to find exact metrics — state the target threshold or SLA contract ('p99 < 200ms at 5,000 RPS') rather than leaving qualitative fluff.
- AI keeps re-introducing filler words — include the explicit ban-list inside the system prompt or CLAUDE.md.
- Tables repeat the exact same text as bullet lists — delete the duplicate bullet list and let the Markdown table carry the comparison.
No-Slop High-Density Writing Gate (Защита текста от ИИ-воды и штампов)
Жесткий фильтр против нейросетевой «воды», корпоративных штампов и голословных утверждений в документации и ТЗ.
Быстрый старт
# Ban-list scanner that flags high-entropy AI slop and corporate filler phrases
SLOP_PHRASES = (
"delve into", "testament to", "tapestry of", "paradigm shift",
"synergistic", "holistic approach", "unlock the full potential",
"инновационные решения", "синергия", "комплексный подход", "вывести на новый уровень",
)
def scan_for_slop(text: str) -> list[str]:
low = text.lower()
return [phrase for phrase in SLOP_PHRASES if phrase in low]
assert scan_for_slop("Deploy CloudNativePG with 3 replicas across 3 AZs for RPO=0.") == []# High-Density Claim Rule: [Subject] + [Exact Action] + [Quantified Effect] + [Verification]
- Bad (Slop): "Our next-gen platform utilizes holistic caching to dramatically boost performance."
- Good (Dense): "Redis Cache-Aside with a 60s jittered TTL serves 85% of product reads in 1.8ms, reducing PostgreSQL CPU from 78% to 19%."Когда использовать
- Проверка технических спецификаций (RFC, ADR, PRD), статей и README на наличие «воды» и корпоративных лозунгов
- Повышение информационной плотности системных промптов и ответов ИИ-агентов без потери смысла
- Удаление пустых мета-анонсов («В данном разделе мы рассмотрим...», «Подводя итоги, можно с уверенностью сказать...»)
- Контроль того, чтобы каждое архитектурное решение сопровождалось компромиссами (trade-offs) и командой проверки
Лучшие практики
- Начинайте каждый раздел сразу с решения или главного вывода в первом предложении без вводных абзацев.
- Запретите мета-анонсы («Ниже представлена таблица...», «В этом разделе мы разберем...») — заголовок уже говорит, о чем блок.
- Для каждого технического выбора указывайте его цену («Синхронная репликация дает RPO=0 ценой +1.5 мс к записи»).
- Заменяйте пустые заголовки-существительные («Масштабируемость», «Безопасность») на тезисные утверждения («Горизонтальное масштабирование до 30k RPS через KEDA»).
- Удаляйте трюизмы: если отрицание фразы звучит абсурдно («Мы делаем качественный продукт»), значит фраза не несет информации.
- Сжимайте объем без потери фактов: оставляйте схемы, контракты API, пороговые цифры и план отката.
Зависимости
# Run automated slop and word-density checks
python3 --versionПримеры
# Calculate information density ratio (numbers, code tokens, and concrete identifiers per 100 words)
import re
def info_density_per_100_words(text: str) -> float:
words = text.split()
if not words:
return 0.0
signals = re.findall(r"(`[^`]+`|\b\d+[a-zA-Z%/.:-]*\b|\b[A-Z]{2,}\b)", text)
return round(len(signals) / len(words) * 100.0, 1)
assert info_density_per_100_words("Set `max_connections=200` on PostgreSQL 16 and route via PgBouncer on port 6432 for <2ms p99.") >= 25.0# Declarative Section Headers (Assertion-Evidence Pattern)
- Weak header: "Database Architecture"
- Strong header: "CloudNativePG 3-Node Quorum Guarantees RPO=0 and <10s Failover"Пошаговое руководство
1. Прогоните черновик через scan_for_slop() и удалите все найденные штампы вместе с вводными конструкциями.
2. Вырежьте вступительные разогревы и финальные блоки «В заключение / Подводя итоги», дублирующие уже сказанное.
3. Перепишите назывные заголовки в форму тезисных утверждений с главной цифрой или архитектурным выбором.
4. Измерьте плотность фактов через info_density_per_100_words() и замените общие слова на параметры конфигов и метрики.
5. Добавьте явный пункт «Компромиссы и сценарии отказа» для каждого предлагаемого технического решения.
Валидация
1. Функция scan_for_slop() возвращает 0 совпадений по всему тексту документа
2. Плотность фактов info_density_per_100_words() составляет не менее 12.0 на технических разделах
3. Ни одна секция не начинается с пустых анонсов («Ниже приведена...», «В данном разделе...»)
4. Каждая рекомендация содержит как оцифрованную выгоду, так и цену решения (trade-off)
Устранение неполадок
- Текст кажется слишком сухим для новичков — добавьте в начале короткий жизненный пример на 2 предложения вместо разбавления каждого абзаца водой.
- Нет точных исторических цифр — укажите целевой инженерный норматив или SLA («латентность p99 < 200 мс при 5000 RPS»).
- Модель продолжает вставлять клише — добавьте явный стоп-лист слов в системный промпт или файл AGENTS.md.
- Список буллетов дословно повторяет соседнюю таблицу — удалите дублирующий список и оставьте только компактную таблицу.