@vasilvestre/opencode-plain-style 1.1.1 → 1.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.opencode/plugins/plain-style.md +3 -2
- package/README.md +13 -1
- package/package.json +1 -1
|
@@ -32,8 +32,9 @@ descriptions, and your explanations in chat. Code itself is exempt.
|
|
|
32
32
|
14. Format code, commands, flags, file names, and paths in backticks.
|
|
33
33
|
15. Be concrete. Replace "handle errors appropriately" with what to do:
|
|
34
34
|
"log the error and return a 400 response".
|
|
35
|
-
16. End with
|
|
36
|
-
|
|
35
|
+
16. End with a "Next:" line that gives the next action as runnable commands.
|
|
36
|
+
Put the commands in a fenced code block, one command per line. Use prose
|
|
37
|
+
only when the action has no command form.
|
|
37
38
|
17. Do not use em dashes (—) or en dashes (–) as punctuation. Use commas,
|
|
38
39
|
colons, or parentheses. En dashes in numeric ranges like 2020–2026 are
|
|
39
40
|
the exception.
|
package/README.md
CHANGED
|
@@ -24,7 +24,7 @@ Rules include:
|
|
|
24
24
|
- `must` for requirements, stated as facts without softening.
|
|
25
25
|
- No vague intensifiers or words that signal laziness or condescension.
|
|
26
26
|
- Lists and headings over walls of text, conclusion first.
|
|
27
|
-
-
|
|
27
|
+
- A "Next:" line at the end that gives the next step as runnable commands in a fenced code block.
|
|
28
28
|
- No em dashes as punctuation, no "please" in instructions, no "etc.".
|
|
29
29
|
|
|
30
30
|
Because the injection happens per request, the rules survive context compaction.
|
|
@@ -206,6 +206,18 @@ For a hard guarantee, add deterministic linting (for example Vale) to CI.
|
|
|
206
206
|
The table shows the original 16-rule baseline. The current 19-rule rulebook
|
|
207
207
|
re-validated on the same model at +26.7 points (53.3% to 80.0%, 2026-08-03).
|
|
208
208
|
|
|
209
|
+
The 2026-10-20 rulebook (rule 16 rephrased: runnable commands in a fenced block)
|
|
210
|
+
re-validated on two free-tier models:
|
|
211
|
+
|
|
212
|
+
| Model | Control | Treatment | Delta |
|
|
213
|
+
| --------------------------------- | ------: | --------: | ----: |
|
|
214
|
+
| opencode/deepseek-v4.1-flash-free | 60.0% | 100.0% | +40.0 |
|
|
215
|
+
| opencode/glm-5.3-flash-free | 66.7% | 73.3% | +6.6 |
|
|
216
|
+
|
|
217
|
+
Free tiers stay inside the noise of their earlier runs; deepseek posts the
|
|
218
|
+
strongest treatment arm measured so far.
|
|
219
|
+
Full per-field numbers: [bench/README.md](bench/README.md).
|
|
220
|
+
|
|
209
221
|
Full details: [bench/BENCHMARK.md](bench/BENCHMARK.md).
|
|
210
222
|
|
|
211
223
|
## Customize the rules
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@vasilvestre/opencode-plain-style",
|
|
3
|
-
"version": "1.
|
|
3
|
+
"version": "1.2.0",
|
|
4
4
|
"description": "Plain-language writing rules for opencode agents, injected into every system prompt. Enforces ISO 24495-1 principles on commits, comments, docs, and chat prose.",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"opencode-plugin",
|