@zalom/plastic 1.10.0 → 1.11.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/README.md CHANGED
@@ -139,7 +139,7 @@ Walk this once in
139
139
  | Intent | `plastic-continuing`, `plastic-intent-creating`, `plastic-intent-starting`, `plastic-intent-brainstorming`, `plastic-intent-grilling`, `plastic-intent-speccing`, `plastic-intent-planning`, `plastic-intent-executing`, `plastic-intent-ending`, `plastic-intent-continuing`, `plastic-intent-researching` |
140
140
  | Project and delivery | `plastic-project-creating`, `plastic-project-continuing`, `plastic-roadmap`, `plastic-roadmap-continuing`, `plastic-releasing` |
141
141
  | Skill | `plastic-skill-creating`, `plastic-skill-evaluating` |
142
- | Product | `plastic-install`, `plastic-update`, `plastic-uninstall`, `plastic-rollback`, `plastic-doctor`, `plastic-humanizer` |
142
+ | Product | `plastic-install`, `plastic-update`, `plastic-uninstall`, `plastic-rollback`, `plastic-doctor` |
143
143
 
144
144
  See [`docs/guides/index.md`](docs/guides/index.md) for task-oriented walkthroughs.
145
145
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@zalom/plastic",
3
- "version": "1.10.0",
3
+ "version": "1.11.0",
4
4
  "description": "Intent-driven idea development system for AI coding agents",
5
5
  "type": "module",
6
6
  "bin": {
@@ -57,11 +57,9 @@ CONSUMES the intent 74 report to WRITE the human briefing defined here. The two
57
57
 
58
58
  ## Brevity: point, don't repeat
59
59
 
60
- Surface rules (no em-dashes, plain words, no filler openers, and so on) are owned by the
61
- shipped `plastic-humanizer` skill and the always-on plain-language layer. This contract does not
62
- re-list that catalog. It restates only the hard bans as one line: no em-dashes, no "not X but Y",
63
- no rule of three, no hype words, no sycophancy, no over-bolding. Apply `plastic-humanizer` and the
64
- always-on layer for everything else.
60
+ Surface rules are owned by the `writing-style` skill. This contract does not restate them, in full
61
+ or in summary. It defines the report's shape only: what to say, in what order, and when to stop.
62
+ Apply the `writing-style` skill for the wording.
65
63
 
66
64
  ## Emission: guided vs auto
67
65
 
@@ -130,6 +130,6 @@ succession at a glance (last line = where we are).
130
130
  In auto mode the orchestrator briefs the human at every lifecycle stage boundary in a fixed,
131
131
  impact-first shape (the EM-to-CTO report contract): State, then Risk, then Call. This is the
132
132
  depth at M and L; at S the briefing fires once, at How. It leads with
133
- what changed and why it matters, names one risk, and leaves the decision to the human. Separately,
134
- the `plastic-humanizer` skill cleans authored prose (specs, outcomes, READMEs, release notes) of
135
- AI tells and slop; it is for documents, not for every reply.
133
+ what changed and why it matters, names one risk, and leaves the decision to the human. Wording
134
+ rules for the briefing, and for authored prose such as specs, outcomes, READMEs, and release
135
+ notes, are owned by the `writing-style` skill, not by this contract.
@@ -1,40 +0,0 @@
1
- ---
2
- name: plastic-humanizer
3
- description: Use to clean authored prose so it reads human and clutter-free. Removes AI tells and slop from a document, spec, outcome, README, report, or release note. Use when the user says "humanize", "de-slop", "remove the AI tells", or "clean up the wording". For documents, not for every chat reply, and not for code.
4
- user-invocable: true
5
- ---
6
-
7
- # Humanizer
8
-
9
- Make writing read like a person wrote it: plain, direct, low-clutter. Run this as a pass over authored prose (specs, outcomes, README, reports). Do not run it on code or on every chat turn.
10
-
11
- ## Lead (house style)
12
- Reframe your answers and any questions you have for me like you are speaking to a well-educated non-English native person. Reduce slang, and rarely used words and terms in the general communication. And cut all the fancy words from explanations. Technical terms and concepts are fine and need no gloss.
13
-
14
- ## Voice
15
- Answer like a busy bartender or a senior support engineer who has seen almost every ticket. Help fast, give the fix first, earn the tip.
16
-
17
- ## Job 1 - remove these surface tells
18
- 1. Em-dashes and en-dashes - use a comma or a full stop.
19
- 2. "Not X but Y" (and "it's not just X, it's Y").
20
- 3. Rule of three - three items only for rhythm.
21
- 4. Hype / AI words - delve, robust, comprehensive, seamless, leverage, crucial, unlock, landscape.
22
- 5. Filler openers / signposting - "It's worth noting", "It's important to", "Let's dive in".
23
- 6. Hedging pile-up - might, could, perhaps, generally, when not needed.
24
- 7. Sycophancy - "Great question", "You're absolutely right".
25
- 8. Over-bolding - bold only what carries weight.
26
-
27
- ## Job 2 - fix the structure
28
- - Lead with the one main point.
29
- - Cut sentences that only restate.
30
- - Pick concrete words over abstract ones.
31
- - Match the user's voice when samples of their writing exist.
32
-
33
- ## Process
34
- Write, check once against the rules above, then send. On documents, run this pass last.
35
-
36
- ## Length
37
- Keep it short. If a sentence does not help the reader, cut it.
38
-
39
- ## More
40
- For before/after examples, read `references/examples.md`. To make the house style always-on in chat, see `references/always-on-snippet.md`. The full 33-pattern catalog and the research behind this skill live in intent 92's `resources/`. They are background and are not loaded here.
@@ -1,70 +0,0 @@
1
- {
2
- "skill_name": "plastic-humanizer",
3
- "notes": "Intent 92. Cleans authored prose: removes 8 surface tells and applies structural levers (one point, cut restatement, concrete words, match voice). Triggers on document-cleanup asks, not on code. Runner is intent 76; assertions are human for now.",
4
- "evals": [
5
- {
6
- "id": 1,
7
- "scope": "trigger",
8
- "set": "validation",
9
- "prompt": "Humanize this README - it reads like AI wrote it.",
10
- "expected_output": "Selects plastic-humanizer and runs the cleanup pass over the document.",
11
- "files": [],
12
- "assertions": [
13
- {
14
- "type": "human",
15
- "check": "plastic-humanizer is selected for a document-cleanup request",
16
- "observed": "description triggers on 'humanize' / 'reads like AI' for a document",
17
- "result": "pass"
18
- }
19
- ]
20
- },
21
- {
22
- "id": 2,
23
- "scope": "trigger",
24
- "set": "validation",
25
- "prompt": "Clean up the wording in this spec.",
26
- "expected_output": "Selects plastic-humanizer and cleans the spec prose.",
27
- "files": [],
28
- "assertions": [
29
- {
30
- "type": "human",
31
- "check": "plastic-humanizer is selected for 'clean up the wording'",
32
- "observed": "description triggers on 'clean up the wording'",
33
- "result": "pass"
34
- }
35
- ]
36
- },
37
- {
38
- "id": 3,
39
- "scope": "non-trigger",
40
- "set": "validation",
41
- "prompt": "Fix the failing test in foo.rb.",
42
- "expected_output": "Does NOT select plastic-humanizer; this is a code task, not prose cleanup.",
43
- "files": [],
44
- "assertions": [
45
- {
46
- "type": "human",
47
- "check": "plastic-humanizer is not selected for a code task",
48
- "observed": "description scopes the skill to documents, not code",
49
- "result": "pass"
50
- }
51
- ]
52
- },
53
- {
54
- "id": 4,
55
- "scope": "output",
56
- "set": "validation",
57
- "prompt": "Given a slop sample: 'It's worth noting that this is not just a fix, but a comprehensive, robust, and seamless improvement that will unlock real value.' Humanize it.",
58
- "expected_output": "Cleaned text has no em-dashes and none of the 8 tells, leads with one point, and drops restatement. For example: 'This fix makes X faster.'",
59
- "files": [],
60
- "assertions": [
61
- {
62
- "type": "human",
63
- "check": "output drops the 8 tells, leads with one point, cuts restatement",
64
- "observed": "no em-dashes; no 'not X but Y'; no rule-of-three; no hype words; no filler opener; one load-bearing point",
65
- "result": "pass"
66
- }
67
- ]
68
- }
69
- ]
70
- }
@@ -1,9 +0,0 @@
1
- # Always-on chat style (copy-paste)
2
-
3
- Paste this into your global `CLAUDE.md` (applies to all projects) or a project `AGENTS.md` (one project). It keeps the chat style on at near-zero cost. The full cleanup for documents is the `plastic-humanizer` skill.
4
-
5
- ```
6
- Reframe your answers and any questions like you are speaking to a well-educated person who is not a native English speaker. Reduce slang and rarely used words. Cut fancy words from explanations. Technical terms and concepts are fine.
7
-
8
- Answer like a busy bartender or a senior support engineer who has seen almost every ticket: help fast, give the fix first, earn the tip.
9
- ```
@@ -1,48 +0,0 @@
1
- # Examples - before and after
2
-
3
- Each pair shows a tell or a slop pattern, then the fix.
4
-
5
- ## 1. Em-dash
6
- Before: The release is ready - we just need sign-off.
7
- After: The release is ready. We just need sign-off.
8
- Why: Use a full stop or comma, not an em-dash.
9
-
10
- ## 2. "Not X but Y"
11
- Before: This is not just a config change, it's a rethink of the flow.
12
- After: This change reworks the flow.
13
- Why: State the point directly.
14
-
15
- ## 3. Rule of three
16
- Before: The tool is fast, robust, and powerful.
17
- After: The tool is fast.
18
- Why: Drop the list-for-rhythm; keep the claim you can back.
19
-
20
- ## 4. Hype / AI word
21
- Before: We leverage a comprehensive caching layer to unlock performance.
22
- After: We cache results to make it faster.
23
- Why: Plain verbs and nouns.
24
-
25
- ## 5. Filler opener / signposting
26
- Before: It's worth noting that the cache expires after five minutes.
27
- After: The cache expires after five minutes.
28
- Why: Say the thing; skip the runway.
29
-
30
- ## 6. Hedging pile-up
31
- Before: This might possibly help reduce cost in some cases, generally.
32
- After: This reduces cost.
33
- Why: One clear claim. Add a caveat only if it is real.
34
-
35
- ## 7. Sycophancy
36
- Before: Great question! That's a really insightful point. Here's the answer.
37
- After: Here's the answer.
38
- Why: Drop the praise; answer.
39
-
40
- ## 8. Structural fix (the mush)
41
- Before: There are several important considerations to keep in mind when thinking about how best to approach the broad and multifaceted topic of caching, each of which carries its own trade-offs.
42
- After: Cache reads, not writes. Reads repeat; writes do not.
43
- Why: One load-bearing point. Cut the restatement and the abstract throat-clearing.
44
-
45
- ## 9. Over-bolding
46
- Before: **Note:** the cache **expires** after **five minutes**, so **always** check it.
47
- After: The cache expires after five minutes, so check it first.
48
- Why: Bold nothing here; the sentence carries itself.