soft-skills 2.1.14 → 2.1.16

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "soft-skills",
-  "version": "2.1.14",
+  "version": "2.1.16",
   "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.14",
+  "version": "2.1.16",
   "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.14",
+  "version": "2.1.16",
   "description": "Communication toolkit for burnt-out humans and collaborative AI's",
   "author": {
     "name": "Gilad Barnea",

package/plugins/soft-skills/skills/ai-to-delegated/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: ai-to-delegated
-description: Best practices for getting a step-function leap in performance from other AI agents when instructing or communicating with them. Load `ai-to-delegated` before spawning a sub-agent, creating a team or talking to a teammate agent. Trigger words include “dispatch an agent”, “spawn a team”, and “talk with another ai”.
+description: Best practices for getting a step-function leap in productivity when working with other AI’s. Load `ai-to-delegated` before spawning a sub-agent, creating a team, talking to a teammate agent, or writing a doc likely read by other agents. Trigger words include “dispatch an agent”, “spawn a team”, and “fork the session to ...”.
 ---
 
 # AI → Delegated
@@ -11,7 +11,6 @@ For relationship definitions, see the plugin's [roles map](../../roles.md).
 
 | Current situation | Read |
 | --- | --- |
-| Your context window or another agent’s is tight or likely to run short | You and the affected agent’s team should apply [token-economic communication](../../token-economic-communication.md) |
 | Deciding whether delegation is worthwhile | [When to delegate](planning/when-to-delegate.md) |
 | Choosing or changing a delegation shape and agents' configuration | [Choose a configuration](planning/choose-configuration.md) |
 | The harness cannot set the model, thinking, or fork you chose | [Dispatch outside the harness](planning/dispatch-outside-the-harness.md) |
@@ -22,6 +21,7 @@ For relationship definitions, see the plugin's [roles map](../../roles.md).
 | Examples of briefing delegates | [Briefing examples](briefing/examples.md) |
 | Working alongside peers | [Peer coordination](coordination/peers.md) |
 | About to commission, or currently supervising leaders | Also [leading leaders](coordination/leading-leaders.md) |
+| Your context window or another agent’s is tight or likely to run short | You and the affected agent’s team should apply [token-economic communication](../../token-economic-communication.md) |
 
 ## Named configurations
 

package/plugins/soft-skills/skills/ai-to-delegated/planning/when-to-delegate.md

@@ -52,11 +52,11 @@ Logically, if the task is not large or complex, do not delegate. The delegation
 
 > This is not an exhaustive list. Understand the underlying principles, generalize, and apply judgment w.r.t. your actual task.
 
-These are example implementations of the different, justified types of delegation, as described earlier in this file.
+These are justified reasons to delegate. Each reason fits one of the shapes described earlier in this file, or any of them.
 
-- **Dirty work**: The main agent needs the result of a process, not the process itself. Examples include mapping unknown terrain to identify where to dive deeper; finding where things are or whether they exist at all; conducting research; summarizing topics the delegating agent does not need to understand deeply; implementing a well-defined spec; and so on. These tasks require the executor to consume substantial irrelevant context because the space has not yet been mapped by relevance, creating a fog-of-war situation. Someone has to burn through context and deal with the noise. It is better to assign this work to a throwaway agent and keep the main agent’s context high signal-to-noise. Moreover, due to the read-only nature of these tasks, they can potentially be fanned out and run in parallel.
+- **Dirty work**: The main agent needs the result of a process, not the process itself. Examples include mapping unknown terrain to identify where to dive deeper; finding where things are or whether they exist at all; conducting research; summarizing topics the delegating agent does not need to understand deeply; implementing a well-defined spec; and so on. These tasks require the executor to consume substantial irrelevant context because the space has not yet been mapped by relevance, creating a fog-of-war situation. Someone has to burn through context and deal with the noise. It is better to assign this work to a throwaway agent and keep the main agent’s context high signal-to-noise. Moreover, when these tasks are independent of each other, they can be fanned out and run in parallel.
 - **Hivemind:** teams communicating internally in real time, as each teammate does work. Hollywood analogy: elite soldier squad or a team of spies, global channel earpieces, deployed behind enemy lines, each progresses their part, each part essential for completing the mission, global channel earpieces, consistent live updates, uncertainties surfaced to get advice, discussions to make best decisions for mission, path forward of an individual adapts in real time due to new peer finding, HQ available for teammates to surface rare issues that only HQ can or should handle.
 - **De-bias:** A reviewer with a fresh context (either paired with the worker in a live team, or dispatched after the fact), informed only of the intent which birthed the work, can spot blind spots and flaws that the worker could not. Related: sometimes a hypothesis is considered true only after it is confirmed independently by multiple actors (consensus).
-- **Get more done with less time**: horizontally & more of the same. Readonly tasks are often a strong candidate to fan out as such.
-- **Multiple experts over jack(s) of all trades**: horizontally & orthogonal domains.
-- **Big picture, smaller picture**: vertical responsibility layers. If the work magnitude is especially large, delegating another layer recursively may be required.
+- **Too much for one agent**: the work volume is so large that one agent cannot fit it in its context window, or its results degrade (very bloated window). Splitting the work loses some understanding between agents, and here that loss costs less than the degradation. Cut the work into slices of the same kind. A bonus: the slices run in parallel, so the work also finishes sooner. Shape: horizontally & more of the same.
+- **Multiple experts over jack(s) of all trades**: the work spans several cognitive worlds. Give each world its own agent, so each context window stays cohesive. Shape: horizontally & orthogonal domains.
+- **Big picture, smaller picture**: the work has both a wide, shallow level and a narrow, deep level of the same thing. Where multiple experts split the work side by side, this splits it top to bottom: give each level its own agent, stacked one above the other. Shape: vertical responsibility layers. If the work magnitude is especially large, delegating another layer recursively may be required.

package/plugins/soft-skills/skills/ai-to-leader/SKILL.md

@@ -1,11 +1,11 @@
 ---
 name: ai-to-leader
-description: How to communicate with your leader — whoever gave you your mission and receives your results. Every agent has a leader — the human, or the agent that dispatched it — so this skill should be loaded once at the beginning of the interaction.
+description: How to communicate with your leader — whoever gave you your mission and receives your results. Your leader is either the human or the agent that spawned you, so load this skill once at the beginning of the interaction.
 ---
 
 # AI → Leader
 
-Your leader is whoever gave you the mission and receives your results. Load the [theory-of-mind skill](../theory-of-mind/SKILL.md) once. This skill is the upward projection of that theory: re-ground the reader, carry the delta, compress to what they need.
+Your leader is whoever gave you the mission and receives your results. Load the [theory-of-mind skill](../theory-of-mind/SKILL.md) once. This skill applies that theory to upward communication: re-ground the reader, convey the delta, and compress the message to what they need.
 
 ## Every report is a cold entry