feat(effort): entry level on every skill next to its model pin (BDR-108)

- lib/effort-pins.txt (map) + lib/effort-pins.sh (idempotent re-apply)
  replace the hardcoded brainstorming/writing-plans loop; called after the
  last vendoring step of install-plugins.sh AND update-all.sh (the resync
  dropped the pins until the next make plugin)
- design stack high uniform (last loaded wins), superpowers, agent-skills,
  21st pack pinned from the map; skills-perso low, pdf-translate medium,
  site-motion high
- doctrine: design stack loads paired with the first Read; one level per
  stack (CLAUDE.global.md, lib/effort-shift.md)
- lib/effort-audit.py prints thinking coverage per scope (sub-agent records
  carry no thinking count on ~94 % of requests)
- census map-driven + fixture suite lib/tests/effort-pins.test.sh; docs
  README/USAGE/CHANGELOG; contract + TODO plan

lib/effort-audit.py

@@ -10,18 +10,21 @@ import sys
 
 # Weights relative to input price.
 WEIGHTS = {"in": 1.0, "cc": 1.25, "cr": 0.1, "out": 5.0}
-FIELDS = ("in", "cc", "cr", "out", "think")
+FIELDS = ("in", "cc", "cr", "out", "think", "nodet")
 
 
 def usage_row(usage):
-    """Map one API usage block to the five counted fields."""
-    details = usage.get("output_tokens_details") or {}
+    """Map one API usage block to the counted fields. `nodet` marks a
+    record whose usage carries no output_tokens_details at all: no thinking
+    count was recorded (most sub-agent records), so `think` understates."""
+    details = usage.get("output_tokens_details")
     return {
         "in": usage.get("input_tokens", 0) or 0,
         "cc": usage.get("cache_creation_input_tokens", 0) or 0,
         "cr": usage.get("cache_read_input_tokens", 0) or 0,
         "out": usage.get("output_tokens", 0) or 0,
-        "think": details.get("thinking_tokens", 0) or 0,
+        "think": (details or {}).get("thinking_tokens", 0) or 0,
+        "nodet": 0 if details else 1,
     }
 
 
@@ -57,21 +60,27 @@ def weighted(counter):
     return sum(counter[f] * WEIGHTS[f] for f in WEIGHTS)
 
 
-def report(agg):
-    """Print the per-key table, then the main/sub split and the thinking
-    share."""
-    total = collections.Counter()
-    for counter in agg.values():
-        total.update(counter)
-    total_w = weighted(total) or 1
+def coverage(counter):
+    """Share of requests whose usage carries a thinking count."""
+    return 100 * (1 - counter["nodet"] / max(counter["msgs"], 1))
+
+
+def print_rows(agg, total_w):
+    """One line per (scope, model, effort), costliest first."""
     print(f"{'scope':5} {'model':22} {'effort':7} {'msgs':>6} {'think/msg':>9} "
-          f"{'think_tok':>10} {'out_tok':>10} {'cache_read':>12} {'%wcost':>7}")
+          f"{'think_tok':>10} {'out_tok':>10} {'cache_read':>12} {'%wcost':>7} "
+          f"{'%counted':>8}")
     ranked = sorted(agg.items(), key=lambda kv: -weighted(kv[1]))
     for (scope, model, effort), c in ranked:
         per_msg = c["think"] / max(c["msgs"], 1)
         print(f"{scope:5} {model:22} {effort:7} {c['msgs']:6d} "
               f"{per_msg:9.0f} {c['think']:10d} {c['out']:10d} "
-              f"{c['cr']:12d} {100 * weighted(c) / total_w:6.1f}%")
+              f"{c['cr']:12d} {100 * weighted(c) / total_w:6.1f}% "
+              f"{coverage(c):7.0f}%")
+
+
+def print_scopes(agg, total, total_w):
+    """Main/sub split, thinking share and the coverage caveat."""
     by_scope = collections.defaultdict(collections.Counter)
     for (scope, _, _), c in agg.items():
         by_scope[scope].update(c)
@@ -79,11 +88,27 @@ def report(agg):
         print(f"  {scope:5} weighted-cost "
               f"{100 * weighted(c) / total_w:5.1f}%  thinking "
               f"{100 * c['think'] / max(total['think'], 1):5.1f}%  "
-              f"requests {c['msgs']}")
+              f"requests {c['msgs']}  thinking counted on "
+              f"{coverage(c):.0f}% of them")
     print(f"  thinking = "
           f"{100 * total['think'] * WEIGHTS['out'] / total_w:.1f}% "
           f"of weighted cost; cache reads = "
           f"{100 * total['cr'] * WEIGHTS['cr'] / total_w:.1f}%")
+    low = [s for s, c in by_scope.items() if coverage(c) < 50]
+    if low:
+        print(f"  CAVEAT: {', '.join(low)} records mostly carry no thinking "
+              f"count — their think columns are a floor, not a measure")
+
+
+def report(agg):
+    """Print the per-key table, then the main/sub split and the thinking
+    share."""
+    total = collections.Counter()
+    for counter in agg.values():
+        total.update(counter)
+    total_w = weighted(total) or 1
+    print_rows(agg, total_w)
+    print_scopes(agg, total, total_w)
 
 
 def main():