Skip to content

feat(rules): add clear technical prose to Manner layer - #2

Merged
beettlle merged 1 commit into
mainfrom
cursor/clear-prose-ste-manner-73fb
Jul 30, 2026
Merged

feat(rules): add clear technical prose to Manner layer#2
beettlle merged 1 commit into
mainfrom
cursor/clear-prose-ste-manner-73fb

Conversation

@beettlle

Copy link
Copy Markdown
Owner

Summary

Adds a dense Clear Technical Prose rule under Grice Manner, inspired by Orwell-style brevity and Boeing’s public STE digest, while rejecting full ASD-STE100 dictionaries and caveman-style article-dropping fragments.

  • New §9.8a in general-llm-anti-patterns.mdc: active voice, short full sentences, one claim per sentence, cut filler/pleasantries, keep code/paths/APIs/errors exact, expand for security/irreversible/ambiguous steps
  • Quick-ref Manner row + AGENTS.md / engineering-philosophy / cursor-integration cross-refs to §9.6–9.8a
  • Light Ollama Modelfile tone sync (same Manner cues)

Test plan

  • python3 scripts/validate-rules.py — 0 errors
  • Spot-check §9.8a Bad/Good against CONTRIBUTING template
  • Confirm Quantity still wins for architecture/audit asks (full sentences, more depth)
  • Confirm epistemic hedging (verification pending) remains allowed

Risks

  • Always-on token budget grows slightly (general-llm-anti-patterns.mdc +~17 lines). Mitigated by dense Bad/Good format and no new always-on file.
  • No STE/caveman compliance claims; style guidance only for agent↔user and review prose.
Open in Web Open in Cursor 

Extend Grice Manner with active voice, short full sentences, filler
cuts, and exact preservation of code/paths/APIs/errors—without STE
compliance claims or caveman-style fragment defaults.

Co-authored-by: Cesar Delgado <beettlle@users.noreply.github.com>
@beettlle
beettlle marked this pull request as ready for review July 30, 2026 19:23
@beettlle
beettlle merged commit 3bda268 into main Jul 30, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants