docs(guidelines): adopt semantic line breaks (SemBr) across repository - #1108
Open
onlyarnav wants to merge 1 commit into
Open
docs(guidelines): adopt semantic line breaks (SemBr) across repository#1108onlyarnav wants to merge 1 commit into
onlyarnav wants to merge 1 commit into
Conversation
ppkarwasz
requested changes
Aug 21, 2026
onlyarnav
force-pushed
the
docs/adopt-sembr
branch
from
August 21, 2026 18:07
60582f9 to
694fd8d
Compare
Adopt the SemBr (Semantic Line Breaks) standard for formatting prose across skills, documentation, and canned responses. This ensures that single-sentence modifications result in clean, minimal diffs without reflow issues. Generated-by: Antigravity
onlyarnav
force-pushed
the
docs/adopt-sembr
branch
from
August 21, 2026 18:15
694fd8d to
a08663a
Compare
There was a problem hiding this comment.
Pull request overview
Adopts Semantic Line Breaks (SemBr) as repository-wide prose guidance, addressing #1094.
Changes:
- Documents sentence- and clause-boundary formatting.
- Adds SemBr guidance to contributor and skill-authoring workflows.
- Updates the editorial guidelines TOC.
Reviewed changes
Copilot reviewed 4 out of 4 changed files in this pull request and generated 2 comments.
| File | Description |
|---|---|
AGENTS.md |
Adds repository-wide SemBr instructions. |
CONTRIBUTING.md |
Adds SemBr as an English-code convention. |
docs/editorial-guidelines.md |
Defines SemBr rules and rationale. |
skills/write-skill/SKILL.md |
Requires SemBr when authoring skills. |
Suppressed comments (1)
AGENTS.md:868
- This modified sentence still has arbitrary hard wraps, including splitting the quoted phrase after
theand separatinglives infrom its link. Reflow the full sentence at semantic boundaries; since it has no useful clause split beyond list commas, a single source line follows the new rule most clearly.
semantic line breaks, and the CVE / tracker-issue / PR link formats — lives in
💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.
| [`tools/dev/check-placeholders.sh`](../../tools/dev/check-placeholders.sh) | ||
| prek hook catches the obvious cases but it is a backstop, not a | ||
| substitute for getting the placeholder right at write time. | ||
| - **Semantic line breaks ([SemBr](https://sembr.org)).** |
Comment on lines
+858
to
+859
| Format prose across the repository (skills, docs, canned responses) using | ||
| **semantic line breaks** ([SemBr](https://sembr.org)). |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
AGENTS.mdanddocs/editorial-guidelines.mdrequiring one-sentence-per-line formatting for clear, minimal git diffs.CONTRIBUTING.md(English as code) andskills/write-skill/SKILL.md(skill authoring guidelines).Type of change
docs/,README.md,CONTRIBUTING.md)RFC-AI-0004 compliance
<PROJECT>,<tracker>,<upstream>,<security-list>) used in all skill / tool prose.Linked issues
Closes #1094
Generated-by: Claude Code (Opus 5)