Skip to content

docs(rules): adopt RFC 2119 keywords consistently across rule files - #47

Merged
galimba merged 3 commits into
mainfrom
docs/rfc2119-rules
Jul 8, 2026
Merged

docs(rules): adopt RFC 2119 keywords consistently across rule files#47
galimba merged 3 commits into
mainfrom
docs/rfc2119-rules

Conversation

@galimba

@galimba galimba commented Jul 7, 2026

Copy link
Copy Markdown
Owner

Summary

Implements #15 — a language-only pass over the rule files:

  • RFC 2119 reference statement added at the top of both hard-rules.md and soft-rules.md
  • Hard rules state requirements exclusively with bolded MUST / MUST NOT; soft rules with SHOULD / SHOULD NOT / MAY, bolded on every occurrence
  • CLAUDE.md / AGENTS.md summaries aligned only where they contradicted the reworded text
  • No rule semantics, numbering, or thresholds changed — the adversarial review diffed every normative sentence before/after specifically hunting semantic drift and passed with zero findings

Merge note

Merge this PR last in the batch — it rewords soft-rules.md and hard-rules.md, which the SR-016 (#44-series namespacing) and index-maintenance (#41) PRs also touch; I'll rebase it over the final rules text after the others land so the keyword pass covers SR-016 and the new HR-004/HR-008 wording too.

Closes #15

🤖 Generated with Claude Code

galimba and others added 3 commits July 7, 2026 16:56
Language-only pass: hard rules now state requirements exclusively with
bolded MUST / MUST NOT, soft rules with SHOULD / SHOULD NOT / MAY, per
RFC 2119, with the standard reference statement added at the top of
both files. CLAUDE.md and AGENTS.md rule summaries aligned where they
contradicted the reworded text. No rule semantics, numbering, or
thresholds changed.

Closes #15

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@galimba
galimba merged commit 5d4bfdd into main Jul 8, 2026
7 checks passed
@galimba
galimba deleted the docs/rfc2119-rules branch July 8, 2026 17:36
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.

docs(rules): adopt RFC 2119 keywords (MUST/SHOULD/MAY) consistently

1 participant