swe-workflow-skills 0.11.3 → 0.11.4

package/VERSION

@@ -1 +1 @@
-0.11.3
+0.11.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "swe-workflow-skills",
-  "version": "0.11.3",
+  "version": "0.11.4",
   "description": "A curated library of Claude Code Agent Skills covering the full software lifecycle, with orchestrator-routed activation that scales past the skill-listing budget.",
   "type": "module",
   "bin": {

package/skills/research-methodology/SKILL.md

@@ -109,18 +109,24 @@ Write findings at the strength the evidence has:
 
 **Write each artifact for a reader who wasn't in the session.** An experiment
 README, a results section or a method record is read later by the project owner,
-with nothing else open:
+with nothing else open, and must make the work clear without the notebook or the
+code:
 - **Open with what was found, in plain words**, and what it changes. Provenance
-  (commit, data version, settings) follows the summary; it doesn't lead.
+  (commit, data version) follows the summary; it doesn't lead.
+- **Say what was run**, in a few lines: what it modelled or predicted, on which
+  data, the method and its settings (algorithm, hyperparameters, thresholds), and
+  why that method, with a link to its method decision record. Metrics without the
+  run behind them can't be read. If the material doesn't say, ask; don't leave it out.
 - **Keep each question, its result and what it means for the project together**,
   in the same row or paragraph, not a table followed by a separate list of
   implications.
-- **Define every term and abbreviation where the document uses it**, even when a
-  glossary exists. The glossary is an extra reference, not a substitute, and a
-  definition repeated here is not duplication to remove. A label you can't define
-  (a step code, a decision named by date) is asked about, not left raw.
-- **Revising a dense document adds explanation; it never cuts.** Pre-registered
-  text stays verbatim.
+- **Link shared vocabulary; spell out the rest.** Glossary terms, the methodology
+  and other project-wide definitions have one home: link to it rather than
+  restating it. Shorthand with no home (a notebook symbol, a step code, a decision
+  named by date) is written out, or asked about.
+- **Revising a dense document adds what the work is missing.** Replacing a
+  repeated definition with a link is fine; cutting what was done or what it means
+  is not. Pre-registered text stays verbatim.
 - Don't add qualifiers the output doesn't carry, such as a CI level or a test name.
 
 Under deadline, write the supported part now and mark the rest provisional. The

package/skills/research-methodology/evals/evals.json

@@ -56,16 +56,17 @@
     },
     {
       "id": 2,
-      "prompt": "Write the Results section of experiments/AE04_matching/README.md from my notebook output below. The project owner reads these between other work and wasn't in the session. Terms are already in docs/glossary.md, so keep it tight.\n\nPre-registered: H1 R@50m >= 0.65 on closed parajes; H2 adding MS to G raises precision by >= 3 pp; H3 eps 100 keeps towns out of HS.\nOutput:\n- H1: R@50m = 0.71 [0.66, 0.76], n_cp = 41 -> supp\n- H2: dPrec(MS u G - G) = +2.1 pp [-0.4, 4.6] -> inconcl\n- H3: eps 100 merges M-masked towns into 39 HS -> not supp; A.7 pending\n- l = 225 m (grid), imposib. excluded per 2026-10-22",
+      "prompt": "Write the Results section of experiments/AE04_matching/README.md from my notebook output below. The project owner reads these between other work and wasn't in the session. Terms are already in docs/glossary.md, so keep it tight.\n\nPre-registered: H1 R@50m >= 0.65 on closed parajes; H2 adding MS to G raises precision by >= 3 pp; H3 eps 100 keeps towns out of HS.\nConfig: match=hungarian, max_d=50; clust=DBSCAN(eps=100, min_samples=4); inputs=G, MS (2025-Q3); ref=survey_2024 (1,779 HH); see MDR-0007\nOutput:\n- H1: R@50m = 0.71 [0.66, 0.76], n_cp = 41 -> supp\n- H2: dPrec(MS u G - G) = +2.1 pp [-0.4, 4.6] -> inconcl\n- H3: eps 100 merges M-masked towns into 39 HS -> not supp; A.7 pending\n- l = 225 m (grid), imposib. excluded per 2026-10-22",
       "pressure": [
         "brevity",
         "glossary_exists"
       ],
-      "expected_behavior": "Writes the section for a reader who was not in the session: a plain-language summary of what was found first, then each hypothesis with its question, result and meaning for the project together, defining the shorthand where it is used even though a glossary exists, and reporting the inconclusive result as inconclusive with the numbers exactly as given. Recorded from a real project where results written as session shorthand had to be rewritten because the owner could not follow them; without guidance, replies put implications in a separate list and lean on the glossary link.",
+      "expected_behavior": "Writes the section for a reader who was not in the session: a plain-language summary of what was found first; a few lines on what was run (the matching and clustering methods with their settings, the inputs and the reference data, the method's reason linked to its MDR); then each hypothesis with its question, result and meaning for the project together. Shared terms point to the glossary instead of being redefined, while shorthand no shared document defines is written out or flagged. The inconclusive result is reported as inconclusive with the numbers exactly as given. Recorded from a real project where results written as metrics and session shorthand, with no word on the model run behind them, had to be rewritten because the owner could not follow them.",
       "assertions": [
         "Opens with a short plain-language summary of what was found, before the per-hypothesis detail",
+        "Says in a few plain lines what was run (the matching and clustering methods with their settings, the inputs and the reference data) and links the method's reason to MDR-0007, rather than reporting only the metrics",
         "For each hypothesis, states the question asked, the result, and what it means for the project, next to each other",
-        "Explains the shorthand where it is used (e.g. R@50m, pp, closed parajes, HS, M, A.7, eps) instead of relying only on the glossary link",
+        "Points shared terms to the glossary rather than redefining them, and writes out or flags the shorthand no shared document defines (A.7, the 2026-10-22 decision)",
         "Reports H2 as inconclusive, not as an effect, and keeps every number as given without inventing values"
       ]
     },
@@ -75,12 +76,13 @@
       "pressure": [
         "dry_instinct"
       ],
-      "expected_behavior": "Treats the complaint as too little explanation, not too much text: adds a plain summary and the meaning of each result, keeps definitions inside the README rather than moving them to the glossary, puts each question next to its answer, and leaves the pre-registration verbatim. Recorded from a real project where the first fix moved definitions out to a glossary and the owner objected that the document had been trimmed further.",
+      "expected_behavior": "Treats the complaint as too little explanation of the work, not too much text: adds a plain summary, what the experiment ran (data, method and settings, what it set out to measure) and the meaning of each result, puts each question next to its answer, and leaves the pre-registration verbatim. Shared terms stay in the glossary and are linked, not copied in. Recorded from a real project where the owner could not follow results given as numbers and acronyms with no account of the run behind them.",
       "assertions": [
         "Adds explanation (a plain summary, what each result means) rather than shortening or cutting content",
-        "Keeps or adds definitions of terms inside the README itself rather than moving them out to the glossary",
+        "Adds, or asks for, what the experiment ran (the data, the method and its settings, what it set out to measure) so the README can be followed without the notebook",
         "Puts each question next to its answer and its meaning",
-        "Leaves the pre-registration unchanged, or states that it must stay verbatim, while restructuring around it"
+        "Leaves the pre-registration unchanged, or states that it must stay verbatim, while restructuring around it",
+        "Treats docs/glossary.md as the home for shared terms, linking to it rather than adding a second definition in the README"
       ]
     }
   ]