Markdown discipline

Apply to docs, READMEs, briefs, and any markdown content. The goal: high-signal text that reads well as both a doc and as context for an LLM.

Banned

• Emoji in any markdown (unless explicitly requested by the user)
• Marketing adjectives ("robust", "powerful", "comprehensive", "seamless", "world-class", "leverage" as verb)
• Welcome banners + celebration emoji + "Let's dive in!" energy
• Triple-cataloging ("fast, simple, and reliable")
• Antithesis pattern ("It's not X; it's Y")
• Soft closes ("Hope this helps!" / "Let me know if you have questions")
• Title Case headings
• Em dash overuse (sparingly, < 2 per page)
• Excessive bold (one bolded phrase per paragraph max)
• Block quotes used as warning callouts
• Multiple H1s per file
• Sentence fragments for emphasis