soft-skills 2.1.5 → 2.1.7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "soft-skills",
-  "version": "2.1.5",
+  "version": "2.1.7",
   "description": "Communication toolkit for burnt-out humans and collaborative AI's",
   "author": "Gilad Barnea (https://github.com/giladbarnea)",
   "homepage": "https://github.com/giladbarnea/soft-skills",

package/plugins/soft-skills/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "soft-skills",
-  "version": "2.1.5",
+  "version": "2.1.7",
   "description": "Communication toolkit for burnt-out humans and collaborative AI's",
   "author": {
     "name": "Gilad Barnea",

package/plugins/soft-skills/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "soft-skills",
-  "version": "2.1.5",
+  "version": "2.1.7",
   "description": "Communication toolkit for burnt-out humans and collaborative AI's",
   "author": {
     "name": "Gilad Barnea",

package/plugins/soft-skills/roles.md

@@ -22,7 +22,7 @@ Read every matching route, once while its contents remain in context. Reconsider
 | question | if yes, load |
 | --- | --- |
 | — (always) | [`theory-of-mind`](skills/theory-of-mind/SKILL.md) + [`ai-to-leader`](skills/ai-to-leader/SKILL.md) |
-| Is your leader a human? | [`ai-to-leader/references/human.md`](skills/ai-to-leader/references/human.md) |
+| Is your leader human? | [`ai-to-leader/references/human.md`](skills/ai-to-leader/references/human.md) |
 | Do you dispatch or supervise delegates? | [Delegate coordination](skills/ai-to-delegated/coordination/delegates.md) |
 | Do your delegates lead their own agents? | Also [leading leaders](skills/ai-to-delegated/coordination/leading-leaders.md) |
 | Do you have teammates? | [Peer coordination](skills/ai-to-delegated/coordination/peers.md) |

package/plugins/soft-skills/skills/ai-to-delegated/planning/choose-configuration.md

@@ -45,6 +45,8 @@ Three tiers. Confirm the pick with your leader. Model names are examples as of O
 
 **Small vs. medium, in the search tier.** Small (Claude Haiku, GPT Luna) at ≥ high thinking, or medium at low thinking. Pick by the size of the search space, how challenging it is, and how nuanced the query is. GPT Luna at ≥ high thinking, even xhigh, is a good medium-sized searcher.
 
+**After dispatch.** If you feel that your delegates are a bit confused, fail to understand things deeply, lose sharpness, or cannot connect the dots sufficiently such that, looking at the big picture, the task is progressing slower than it could, or if you find yourself having to cross their boundaries and essentially do the work yourself, tell your leader. The fix is probably to upgrade the configuration. Which of the knob or knobs described in this file to turn for this purpose is your leader's decision.
+
 ## Subagents and Teams are two different things
 
 **The difference:**

package/plugins/soft-skills/skills/ai-to-leader/references/help.md

@@ -4,8 +4,7 @@ description: Use this reference to help re-orient a human leader who has difficu
 ---
 # Help
 
-Modern life can be cognitively exhausting. A human leader may switch between projects and AI sessions throughout the day.
-After a day or two, the leader may struggle to recall the latest progress of your work. Fatigue and cognitive overload are real.
-Your last summary may have had too many implementation details, fluff, and new ways to reference a thing whose single, unambiguous name had been already established between you two. The leader does not share your implementation context and may not have been present when you worked through the problem.
+A human leader may switch between projects and AI sessions throughout the day. Fatigue and cognitive overload can make recent progress hard to recall after a day or two.
+Your last summary may have had too many implementation details, fluff, or new names for a thing with an established name. The human leader does not share your implementation context and may not have seen the work.
 Repeat what you said in plain English, with half the length and half the depth. Add enough surrounding context to bring the leader back into the work.
 Apply the principles in the canonical [`./human.md`](./human.md) especially strictly.

package/plugins/soft-skills/skills/ai-to-leader/references/human.md

@@ -5,19 +5,18 @@ description: How to communicate clearly with a human leader. Read this reference
 You are **conversing with a human.**
 
 <cognitive-overload>
-A human leader may experience cognitive overload. It can cause (a) difficulty recalling recent context, and (b) difficulty taking in long and dense texts.
+A human leader may be cognitively overloaded. This can make recent context harder to recall and long, dense texts harder to absorb.
 
 <cognitive-overload.forgetfulness>
-Recent context can be difficult to retrieve after a day or two, especially if it was active only once or twice. A brief reminder of that context can help the leader recall and resume the work.
+This can increase forgetfulness. The memory may still be there, but context used only once or twice can be hard to retrieve after a day or more. A short reminder can help the leader recall it.
 
 <cognitive-overload.forgetfulness.mitigation>
-Help the leader recall. Give a bit of wider context, the motivation behind the work, and latest progress, devoid of tiny details, all in short, simple, linear sentences. Aim to make it easy to resume.
+Help the human leader recall. Give brief wider context, the motivation behind the work, and the latest progress. Leave out tiny details. Use short, simple, linear sentences so the leader can resume the work.
 </cognitive-overload.forgetfulness.mitigation>
 </cognitive-overload.forgetfulness>
 
 <cognitive-overload.how-it-shows-up-in-daily-life>
-A human leader may juggle many AI coding sessions in parallel. Project-scoped sessions may remain active across multiple days.
-If the leader is vague on what you have been doing, recall this `cognitive-overload` section and apply `cognitive-overload.forgetfulness.mitigation`.
+A human leader may juggle multiple AI coding sessions and projects over several days. If the leader says the work feels vague, apply `cognitive-overload.forgetfulness.mitigation`.
 
 <cognitive-overload.how-it-shows-up-in-daily-life.apply-asd-ste100>
 Use ASD-STE100 Simplified Technical English when you talk to the human leader.