Skip to content

Instantly share code, notes, and snippets.

@teocci
Created August 15, 2026 09:01
Show Gist options
  • Select an option

  • Save teocci/31fc02f5df8ac20bfedb98ece2422b83 to your computer and use it in GitHub Desktop.

Select an option

Save teocci/31fc02f5df8ac20bfedb98ece2422b83 to your computer and use it in GitHub Desktop.
name no-hard-wrapped-markdown
description Never hard-wrap Markdown prose or simple list items to a fixed column; one logical unit per source line
metadata
type
feedback

Do not hard-wrap Markdown prose or list-item text to a fixed column width (80/100/120/etc.). Keep each logical paragraph and each simple bullet item on a single source line and let the renderer/editor wrap it visually. Preserve line breaks only where Markdown structure or source semantics require them: code and command examples, fenced blocks, table rows, nested content, and hard-break-bearing constructs.

Stated by the user as a user-level rule — it applies to every generated Markdown artifact, in any project, not just this repo: plan files, SKILL.md, docs, phase docs, READMEs, reports.

Why: hard wraps are a rendering decision baked into the source. They produce noisy diffs where a one-word edit reflows a whole paragraph, they fight the reader's viewport, and they make every later edit a re-wrapping chore.

How to apply: write the paragraph or bullet as one continuous line regardless of length. Do not "tidy" a long line by breaking it. This is broader than this repo's rules/common/skill-crafting.md, which asks for unwrapped prose but explicitly lets bullets keep their line structure — the user's rule extends it to simple bullet text, so follow the user's rule when both are in scope.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment