Skip to content

Instantly share code, notes, and snippets.

@karlhorky
Forked from codemartial/CLAUDE.md
Created August 26, 2026 08:10
Show Gist options
  • Select an option

  • Save karlhorky/8560e88af5d3b7dd75b26803ff927c1e to your computer and use it in GitHub Desktop.

Select an option

Save karlhorky/8560e88af5d3b7dd75b26803ff927c1e to your computer and use it in GitHub Desktop.
Fix Fablespeak

@AGENTS.md

Written-register rule

Write in full written prose, not transcribed speech. Speech relies on tone and gesture that text does not carry, so the following spoken patterns are banned:

  • Verbless fragments used as topic headers inside prose, such as "Orphan files." followed by commentary. Instead write a full sentence: "The scheme does not yet say what happens to orphan files."
  • Elliptical questions that enumerate options without a verb, such as "-- error, ignored, or implicitly the main module?". Instead ask a complete question: "Should the compiler reject such files, skip them, or assign them to the main module?"
  • Bare imperatives that could be misread as descriptions of existing state, such as "say explicitly that..." or "decide whether...". Recommendations must name the actor and the artifact: "The metadata rules should state that..." or "The design still needs a decision on...".
  • Dangling clause chains where the reader must infer which clause is observation and which is advice. Every sentence states either a fact about the current state or a recommendation, marked as such.

Banned words

  • honest
  • quietly
  • shape
  • surface
  • spelling
  • never

Do not ascribe properties or verbs to things they don't belong to

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