pstack-claude-mirror 0.0.0-stage → 0.9.133

package/plugins/pstack/hooks/copilot-context.awk

@@ -0,0 +1,44 @@
+# Prints the GitHub Copilot SessionStart output: one JSON object whose
+# additionalContext is the poteto-mode mandate with the Copilot notes inside its
+# closing tag. Run after json.awk and setup-pstack's sheet.awk, with the sheet
+# as input, -v found=<1 when the sheet exists>, and PSTACK_HOOKS=<this
+# directory> in the environment.
+# Only a valid sheet's known role lines reach the context, rebuilt from their
+# checked values, so no other text in the sheet does.
+{ sheet_add($0) }
+
+END {
+  n = sheet_roles(roles, panel)
+  notes = text("session-start-copilot.md")
+  problems = found ? sheet_problems() : "no sheet"
+  if (problems == "") {
+    notes = notes "\n\n" text("session-start-copilot-sheet.md") "\n"
+    for (i = 1; i <= n; i++) notes = notes "\n" roles[i] ": " VALUE[roles[i]]
+    if ("default effort" in VALUE) notes = notes "\ndefault effort: " VALUE["default effort"]
+  } else {
+    if (found) notes = notes "\n\nsheet invalid: " problems
+    notes = notes "\n\n" text("session-start-copilot-setup.md")
+  }
+  body = text("session-start-context.md")
+  close_tag = "</EXTREMELY_IMPORTANT>"
+  i = index(body, close_tag)
+  if (i) body = substr(body, 1, i - 1) "\n" notes "\n" substr(body, i)
+  else body = body "\n" notes
+  n = split(body "\n", L, "\n")
+  out = ""
+  for (i = 1; i <= n; i++) out = out (i > 1 ? "\\n" : "") esc(L[i])
+  print "{\"additionalContext\":\"" out "\"}"
+}
+
+# The file's text without its trailing newline.
+function text(name,    file, line, s, first) {
+  file = ENVIRON["PSTACK_HOOKS"] "/" name
+  s = ""
+  first = 1
+  while ((getline line < file) > 0) {
+    s = s (first ? "" : "\n") line
+    first = 0
+  }
+  close(file)
+  return s
+}

package/plugins/pstack/hooks/copilot-hooks.json

@@ -0,0 +1,27 @@
+{
+  "hooks": {
+    "SessionStart": [
+      {
+        "matcher": "startup|resume|clear|compact",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "\"${COPILOT_PLUGIN_ROOT}/hooks/session-start.sh\" copilot"
+          }
+        ]
+      }
+    ],
+    "PreToolUse": [
+      {
+        "matcher": "view|task|bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "\"${COPILOT_PLUGIN_ROOT}/hooks/pre-tool-use.sh\"",
+            "timeout": 5
+          }
+        ]
+      }
+    ]
+  }
+}

package/plugins/pstack/hooks/hooks.json

@@ -0,0 +1,16 @@
+{
+  "hooks": {
+    "SessionStart": [
+      {
+        "matcher": "startup|resume|clear|compact",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "\"${CLAUDE_PLUGIN_ROOT}/hooks/session-start.sh\" claude",
+            "statusMessage": "Loading pstack routing"
+          }
+        ]
+      }
+    ]
+  }
+}

package/plugins/pstack/hooks/json.awk

@@ -0,0 +1,164 @@
+# JSON helpers for the Antigravity and Copilot hooks. POSIX awk, run under LC_ALL=C.
+
+# Escapes s as JSON string content: backslash, double quote, tab, and carriage
+# return are escaped, and other control characters are dropped.
+function esc(s,    out, i, c) {
+  if (!esc_ready) {
+    for (i = 1; i < 32; i++) esc_ctl[sprintf("%c", i)] = 1
+    esc_ctl[sprintf("%c", 127)] = 1
+    delete esc_ctl["\t"]
+    delete esc_ctl["\r"]
+    esc_ready = 1
+  }
+  out = ""
+  for (i = 1; i <= length(s); i++) {
+    c = substr(s, i, 1)
+    if (c == "\\") out = out "\\\\"
+    else if (c == "\"") out = out "\\\""
+    else if (c == "\t") out = out "\\t"
+    else if (c == "\r") out = out "\\r"
+    else if (!(c in esc_ctl)) out = out c
+  }
+  return out
+}
+
+# Decodes raw JSON string content. A \u escape above U+007F sets JBAD, because
+# the byte form awk would write is not dependable; callers then stay silent.
+function jdecode(s,    out, i, c, h) {
+  out = ""
+  while ((i = index(s, "\\")) > 0) {
+    out = out substr(s, 1, i - 1)
+    c = substr(s, i + 1, 1)
+    if (c == "n") out = out "\n"
+    else if (c == "t") out = out "\t"
+    else if (c == "r") out = out "\r"
+    else if (c == "b") out = out sprintf("%c", 8)
+    else if (c == "f") out = out sprintf("%c", 12)
+    else if (c == "u") {
+      h = jhex(substr(s, i + 2, 4))
+      if (h < 1 || h > 127) JBAD = 1
+      else out = out sprintf("%c", h)
+      s = substr(s, i + 6)
+      continue
+    } else out = out c
+    s = substr(s, i + 2)
+  }
+  return out s
+}
+
+function jhex(h,    v, i, d) {
+  if (h !~ /^[0-9A-Fa-f][0-9A-Fa-f][0-9A-Fa-f][0-9A-Fa-f]$/) return -1
+  v = 0
+  for (i = 1; i <= 4; i++) {
+    d = index("0123456789abcdef", tolower(substr(h, i, 1))) - 1
+    v = v * 16 + d
+  }
+  return v
+}
+
+# Reads the whole of standard input into J.
+function jread(    line, first) {
+  J = ""
+  first = 1
+  while ((getline line) > 0) {
+    J = J (first ? "" : "\n") line
+    first = 0
+  }
+  jpos = 1
+  jlen = length(J)
+}
+
+function jws() {
+  while (jpos <= jlen && index(" \t\r\n", substr(J, jpos, 1)) > 0) jpos++
+}
+
+# Consumes the string at jpos and leaves its raw content in JRAW.
+function jstring() {
+  if (!match(substr(J, jpos), /^"([^"\\\001-\037]|\\(["\\\/bfnrt]|u[0-9A-Fa-f][0-9A-Fa-f][0-9A-Fa-f][0-9A-Fa-f]))*"/)) return 0
+  JRAW = substr(J, jpos + 1, RLENGTH - 2)
+  jpos += RLENGTH
+  return 1
+}
+
+function jprim() {
+  if (!match(substr(J, jpos), /^(-?(0|[1-9][0-9]*)(\.[0-9]+)?([eE][+-]?[0-9]+)?|true|false|null)/)) return 0
+  jpos += RLENGTH
+  return 1
+}
+
+function jvalue(path,    c) {
+  jws()
+  c = substr(J, jpos, 1)
+  if (c == "{") return jobject(path)
+  if (c == "[") return jarray(path)
+  if (c == "\"") {
+    if (!jstring()) return 0
+    JT[path] = "string"
+    M[path] = JRAW
+    return 1
+  }
+  JT[path] = "primitive"
+  return jprim()
+}
+
+# JSON Pointer escapes preserve literal slashes, tildes, and dotted keys.
+function jkey(key) {
+  gsub(/~/, "~0", key)
+  gsub(/\//, "~1", key)
+  return key
+}
+
+# Stores node types in JT and raw string values in M. Duplicate object keys
+# are rejected so a permission decision never depends on parser precedence.
+function jobject(prefix,    key, c, path) {
+  jws()
+  if (substr(J, jpos, 1) != "{") return 0
+  JT[prefix] = "object"
+  jpos++
+  jws()
+  if (substr(J, jpos, 1) == "}") { jpos++; return 1 }
+  while (1) {
+    jws()
+    if (substr(J, jpos, 1) != "\"" || !jstring()) return 0
+    key = jdecode(JRAW)
+    path = prefix "/" jkey(key)
+    if (path in JT) return 0
+    jws()
+    if (substr(J, jpos, 1) != ":") return 0
+    jpos++
+    if (!jvalue(path)) return 0
+    jws()
+    c = substr(J, jpos, 1)
+    jpos++
+    if (c == "}") return 1
+    if (c != ",") return 0
+  }
+}
+
+function jarray(path,    c, i) {
+  JT[path] = "array"
+  i = 0
+  jpos++
+  jws()
+  if (substr(J, jpos, 1) == "]") { jpos++; return 1 }
+  while (1) {
+    if (!jvalue(path "/" i++)) return 0
+    jws()
+    c = substr(J, jpos, 1)
+    jpos++
+    if (c == "]") return 1
+    if (c != ",") return 0
+  }
+}
+
+# The hook consumes one complete object, never a valid prefix of bad input.
+function jparse() {
+  jread()
+  if (!jobject("")) return 0
+  jws()
+  return !JBAD && jpos > jlen
+}
+
+function jget(path) {
+  return JT[path] == "string" ? jdecode(M[path]) : ""
+}

package/plugins/pstack/hooks/kimi-instructions.md

@@ -0,0 +1,17 @@
+<EXTREMELY_IMPORTANT>
+You have pstack.
+
+Invoke the `pstack:poteto-mode` skill and follow its instructions when a task meets any of these:
+
+- it touches more than one file, or changes a signature other files call
+- it involves a design or architecture choice
+- it is a bug whose cause is not yet known, or a performance issue
+
+It routes to the right pstack skill from there. For smaller tasks, such as a contained change to one file with an obvious test, a question, or a one-line edit, work directly and verify on the real artifact.
+
+When the intent is already specific, enter that skill directly: `pstack:tdd`, `pstack:architect`, `pstack:how`, `pstack:why`, `pstack:arena`, `pstack:interrogate`.
+
+User instructions (CLAUDE.md, AGENTS.md, direct requests) take precedence. Other session-start mandates, such as superpowers, still apply. Their skill checks run as before, and when a task meets the criteria above they route implementation through poteto-mode.
+</EXTREMELY_IMPORTANT>
+
+Use Kimi Code's `Skill` tool with the qualified name, for example `pstack:poteto-mode`. Before following a pstack skill, read `<KIMI_CODE_HOME>/plugins/managed/pstack/plugins/pstack/skills/poteto-mode/references/kimi-tools.md`. `KIMI_CODE_HOME` defaults to `~/.kimi-code` when unset. Resolve Claude-specific tools and model names through that mapping.

package/plugins/pstack/hooks/muse-context.awk

@@ -0,0 +1,31 @@
+# Prints the Muse SessionStart output as plain text: the poteto-mode
+# mandate, then the saved model choices when the sheet has any. Run after
+# setup-pstack's sheet.awk, with the sheet as input, -v found=<1 when the
+# sheet exists>, and PSTACK_HOOKS=<this directory> in the environment.
+# Only known role lines whose entries are model IDs or aliases reach the
+# output, rebuilt from their checked values, so no other text in the sheet
+# does. Unlike the Copilot sheet check, a panel of one vendor is fine here:
+# Muse serves one family.
+{ sheet_add($0) }
+
+END {
+  emit("session-start-muse.md")
+  if (!found) exit
+  # Muse keeps each usable line rather than the whole sheet or none, so the
+  # problems string, which also counts missing roles, goes unused.
+  sheet_problems()
+  n = sheet_roles(roles, panel)
+  lines = ""
+  for (i = 1; i <= n; i++) if (SHEET_OK[roles[i]]) lines = lines roles[i] ": " VALUE[roles[i]] "\n"
+  if (SHEET_EFFORT_OK) lines = lines "default effort: " VALUE["default effort"] "\n"
+  if (lines == "") exit
+  print ""
+  emit("session-start-muse-sheet.md")
+  printf "%s", lines
+}
+
+function emit(name,    file, line) {
+  file = ENVIRON["PSTACK_HOOKS"] "/" name
+  while ((getline line < file) > 0) print line
+  close(file)
+}

package/plugins/pstack/hooks/pre-tool-use.awk

@@ -0,0 +1,152 @@
+# Decides one GitHub Copilot PreToolUse call for pstack. Run after json.awk,
+# sheet.awk, and script-contracts.awk, with the payload on stdin. Prints one decision
+# object, or nothing, which leaves the call to Copilot's normal permission flow.
+# Copilot sends Claude-format input to PascalCase hooks, so `view` arrives as
+# `Read`.
+BEGIN {
+  if (!jparse()) exit 0
+  if ("/tool_name" in JT) { tool = jget("/tool_name"); P = "/tool_input" }
+  else { tool = jget("/toolName"); P = "/toolArgs" }
+  if (JT[P] != "object") exit 0
+  cwd = jget("/cwd")
+  root = ENVIRON["PSTACK_ROOT"]
+  real = ENVIRON["PSTACK_REAL_ROOT"]
+  sheet = ENVIRON["PSTACK_SHEET"]
+  if (tool == "Read" || tool == "view") view_rule()
+  else if (tool == "Agent" || tool == "Task" || tool == "task") task_rule()
+  else if (tool == "Bash" || tool == "bash") script_rule(arg("command"))
+  exit 0
+}
+
+function arg(k) { return jget(P "/" k) }
+
+function allow() { print "{\"permissionDecision\":\"allow\"}" }
+function deny(reason) { print "{\"permissionDecision\":\"deny\",\"permissionDecisionReason\":\"" esc(reason) "\"}" }
+
+function control(s) { return s ~ /[\001-\037\177]/ }
+
+# True when path is strictly below dir and every segment after dir is a name.
+function under(path, dir,    rel, n, i, seg) {
+  if (dir == "" || index(path, dir "/") != 1) return 0
+  rel = substr(path, length(dir) + 2)
+  n = split(rel, seg, "/")
+  if (n == 0) return 0
+  for (i = 1; i <= n; i++) if (seg[i] == "" || seg[i] == "." || seg[i] == "..") return 0
+  return 1
+}
+
+# The plugin's own files: playbooks, references, and scripts.
+function view_rule(    path) {
+  path = arg("path")
+  if (JBAD || path ~ /["\\]/ || control(path)) return
+  if (under(path, root) || under(path, real)) allow()
+}
+
+# A pstack agent dispatched with an explicit model must use one of the user's
+# saved choices in a valid sheet. A call with no model, or for another agent,
+# is not ours.
+function task_rule(    type, model) {
+  type = arg("agent_type")
+  model = arg("model")
+  if (JBAD || index(type, "pstack:") != 1 || model == "") return
+  if (!sheet_read(sheet) || sheet_problems() != "") return
+  if (model in SHEET_MODELS) return
+  if (MODEL_LIST == "") {
+    deny("pstack model check: every role in the user's saved pstack model choices (" sheet ") is inherit-parent or auto, so call `task` for " type " without `model`.")
+    return
+  }
+  deny("pstack model check: `" model "` is not one of the user's saved pstack model choices (" sheet "). Set `model` to the model saved for this role: one of " MODEL_LIST "." \
+    (MODEL_ALIASES ? " A role saved as inherit-parent or auto omits `model`." : "") \
+    " To change the choices, the user reruns setup-pstack.")
+}
+
+# Tokenize a strict shell form, then let the registered script contract select
+# its path operands. Prose and operation names are not filesystem paths.
+function script_rule(cmd,    n, T, Q, first, script, runner, rel) {
+  if (JBAD || cmd ~ /[;|&$`<>()\\"]/ || control(cmd)) return
+  cwd = resolve(cwd)
+  # A workspace that holds the plugin, or sits in it, could rewrite its files.
+  if (root == "" || cwd == "" || root == cwd || under(root, cwd) || under(cwd, root) \
+    || real == cwd || under(real, cwd) || under(cwd, real)) return
+  n = words(cmd, T, Q)
+  if (n <= 0) return
+  first = 1
+  if (!Q[1] && (T[1] == "node" || T[1] == "sh" || T[1] == "bash")) {
+    runner = T[1]
+    first = 2
+  }
+  if (first > n) return
+  script = T[first]
+  if (under(script, root)) rel = substr(script, length(root) + 2)
+  else if (under(script, real)) rel = substr(script, length(real) + 2)
+  else return
+  if (script_contract(rel, runner, T, first + 1, n)) allow()
+}
+
+# Called only for path operands identified by a script contract.
+function safe_path(p,    n, seg, i) {
+  if (p == "") return 0
+  n = split(p, seg, "/")
+  for (i = 1; i <= n; i++) if (seg[i] == "..") return 0
+  if (substr(p, 1, 1) != "/") {
+    if (cwd == "") return 0
+    p = cwd "/" p
+  }
+  return inside(resolve(p))
+}
+
+# Path operands stay in the workspace: one in the plugin could rewrite the
+# context every later session loads.
+function inside(p) {
+  return p != "" && (p == cwd || under(p, cwd))
+}
+
+# Copilot reports cwd as a real path (/private/tmp on macOS), while the agent
+# may write the path it was given. Resolves the longest existing directory
+# prefix of p. File and dangling symlinks take the normal permission flow.
+function resolve(p,    d, rest, cmd, out, extra, i) {
+  if (p == "" || p ~ /'/ || control(p)) return ""
+  d = p
+  rest = ""
+  while (d != "" && d != "/") {
+    cmd = "if cd '" d "' 2>/dev/null; then pwd -P; elif [ -L '" d "' ]; then printf '%s\\n' '!symlink'; fi"
+    out = ""
+    if ((cmd | getline out) > 0 && out != "") {
+      if ((cmd | getline extra) > 0) out = ""
+      close(cmd)
+      if (out == "" || out == "!symlink" || control(out)) return ""
+      return out rest
+    }
+    close(cmd)
+    i = length(d)
+    while (i > 0 && substr(d, i, 1) != "/") i--
+    rest = substr(d, i) rest
+    d = substr(d, 1, i - 1)
+  }
+  return p
+}
+
+# Splits cmd into T[1..n] on spaces. A word is plain, from a strict safe set, or
+# single-quoted with no quote inside (Q[i] = 1). Returns -1 on anything else.
+function words(cmd, T, Q,    n, rest, c, j) {
+  n = 0
+  rest = cmd
+  while (1) {
+    sub(/^ +/, "", rest)
+    if (rest == "") return n
+    c = substr(rest, 1, 1)
+    if (c == "'") {
+      j = index(substr(rest, 2), "'")
+      if (j == 0) return -1
+      T[++n] = substr(rest, 2, j - 1)
+      Q[n] = 1
+      rest = substr(rest, j + 2)
+    } else {
+      if (!match(rest, /^[A-Za-z0-9_.\/:=@%+,-]+/)) return -1
+      T[++n] = substr(rest, 1, RLENGTH)
+      Q[n] = 0
+      rest = substr(rest, RLENGTH + 1)
+    }
+    if (rest != "" && substr(rest, 1, 1) != " ") return -1
+  }
+}

package/plugins/pstack/hooks/pre-tool-use.sh

@@ -0,0 +1,16 @@
+#!/bin/sh
+# GitHub Copilot only. pre-tool-use.awk decides the call: it approves `view` of
+# this plugin's own files and the strict form of a vendored script run, and it
+# denies a pstack agent dispatch on a model the user did not save. Anything else
+# gets no output and takes the normal permission flow.
+# Copilot denies the call when this hook exits non-zero, so every path exits 0.
+# A failed awk run prints its error to stderr, and its output is dropped.
+out=$(LC_ALL=C PSTACK_ROOT="${COPILOT_PLUGIN_ROOT%/}" PSTACK_REAL_ROOT="$(cd "$COPILOT_PLUGIN_ROOT" && pwd -P)" \
+  PSTACK_SHEET="${COPILOT_HOME:-$HOME/.copilot}/pstack-models.md" \
+  PSTACK_SHEET_READER="${COPILOT_PLUGIN_ROOT}/skills/setup-pstack/scripts/read-sheet.sh" \
+  awk -f "${COPILOT_PLUGIN_ROOT}/hooks/json.awk" \
+  -f "${COPILOT_PLUGIN_ROOT}/skills/setup-pstack/scripts/sheet.awk" \
+  -f "${COPILOT_PLUGIN_ROOT}/hooks/script-contracts.awk" \
+  -f "${COPILOT_PLUGIN_ROOT}/hooks/pre-tool-use.awk") || out=
+[ -z "$out" ] || printf '%s\n' "$out"
+exit 0

package/plugins/pstack/hooks/script-contracts.awk

@@ -0,0 +1,55 @@
+# Approved entry points and their argument shapes. Adding a script under
+# skills/ does not grant it automatic approval. Unknown forms stay silent.
+BEGIN {
+  CONTRACT["skills/show-me-your-work/scripts/log.sh"] = "log"
+  CONTRACT["skills/reflect/scripts/find-transcript.mjs"] = "transcript"
+  CONTRACT["skills/setup-pstack/scripts/check-sheet.sh"] = "optional-path"
+  CONTRACT["skills/poteto-mode/scripts/check-playbooks.mjs"] = "optional-path"
+  CONTRACT["skills/poteto-mode/scripts/check-plan.mjs"] = "one-path"
+  CONTRACT["skills/poteto-mode/scripts/worktree-audit.mjs"] = "paths"
+  CONTRACT["skills/poteto-mode/scripts/resume.mjs"] = "resume"
+}
+
+function script_contract(script, runner, T, first, n,    kind, count, i) {
+  if (!(script in CONTRACT)) return 0
+  kind = CONTRACT[script]
+  if (runner != "") {
+    if (kind == "log") { if (runner != "bash") return 0 }
+    else if (script ~ /\.sh$/) { if (runner != "sh" && runner != "bash") return 0 }
+    else if (runner != "node") return 0
+  }
+  count = n - first + 1
+  if (kind == "log") return count == 6 && safe_path(T[first])
+  if (kind == "transcript") {
+    return (count == 2 || count == 3) && safe_path(T[first]) && T[first + 1] != "" \
+      && (count == 2 || safe_path(T[first + 2]))
+  }
+  if (kind == "resume") return resume_contract(T, first, n)
+  if (kind == "one-path" && count != 1) return 0
+  if (kind == "optional-path" && count > 1) return 0
+  for (i = first; i <= n; i++) if (!safe_path(T[i])) return 0
+  return 1
+}
+
+# resume.mjs: operation first, then named paths. Only publication accepts
+# note/artifact inputs. Both --option=value and --option value are supported.
+function resume_contract(T, first, n,    op, i, arg, eq, key, value, seen) {
+  op = T[first]
+  if (op != "begin" && op != "read" && op != "publish") return 0
+  for (i = first + 1; i <= n; i++) {
+    arg = T[i]
+    eq = index(arg, "=")
+    key = eq ? substr(arg, 1, eq - 1) : arg
+    if (key != "--project" && key != "--note" && key != "--artifact") return 0
+    if (op != "publish" && key != "--project") return 0
+    if (key != "--artifact" && key in seen) return 0
+    seen[key] = 1
+    if (eq) value = substr(arg, eq + 1)
+    else {
+      if (++i > n || T[i] ~ /^--/) return 0
+      value = T[i]
+    }
+    if (!safe_path(value)) return 0
+  }
+  return op != "publish" || ("--note" in seen)
+}

package/plugins/pstack/hooks/session-start-agy.md

@@ -0,0 +1,17 @@
+<EXTREMELY_IMPORTANT>
+You have pstack.
+
+Read the `poteto-mode` skill's `SKILL.md` in full with `read_file` and follow its instructions when a task meets any of these:
+
+- it touches more than one file, or changes a signature other files call
+- it involves a design or architecture choice
+- it is a bug whose cause is not yet known, or a performance issue
+
+It routes to the right pstack skill from there. For smaller tasks, such as a contained change to one file with an obvious test, a question, or a one-line edit, work directly and verify on the real artifact.
+
+When the intent is already specific, enter that skill directly: `tdd`, `architect`, `how`, `why`, `arena`, `interrogate`.
+
+Resolve every Claude tool, model, and built-in skill a pstack skill names through the Antigravity mapping in the `poteto-mode` skill directory, `references/agy-tools.md`.
+
+User instructions (`GEMINI.md`, `AGENTS.md`, direct requests) take precedence. Other session-start mandates still apply. Their skill checks run as before, and when a task meets the criteria above they route implementation through poteto-mode.
+</EXTREMELY_IMPORTANT>

package/plugins/pstack/hooks/session-start-context.md

@@ -0,0 +1,15 @@
+<EXTREMELY_IMPORTANT>
+You have pstack.
+
+Invoke the `pstack:poteto-mode` skill and follow its instructions when a task meets any of these:
+
+- it touches more than one file, or changes a signature other files call
+- it involves a design or architecture choice
+- it is a bug whose cause is not yet known, or a performance issue
+
+It routes to the right pstack skill from there. For smaller tasks, such as a contained change to one file with an obvious test, a question, or a one-line edit, work directly and verify on the real artifact.
+
+When the intent is already specific, enter that skill directly: `pstack:tdd`, `pstack:architect`, `pstack:how`, `pstack:why`, `pstack:arena`, `pstack:interrogate`.
+
+User instructions (CLAUDE.md, AGENTS.md, direct requests) take precedence. Other session-start mandates, such as superpowers, still apply. Their skill checks run as before, and when a task meets the criteria above they route implementation through poteto-mode.
+</EXTREMELY_IMPORTANT>

package/plugins/pstack/hooks/session-start-copilot-setup.md

@@ -0,0 +1 @@
+This Copilot home has no valid pstack model sheet, and pstack ships no default Copilot models. When this session first invokes one of the skills that dispatch on role models, load `setup-pstack` with the `skill` tool and finish it before that skill's first step, even for a small question. It asks the user each model question with `ask_user`, writes the sheet that later sessions reuse, and checks it. It never picks a model the user has not chosen, so when `ask_user` is not available it writes no sheet, and the roles run on the session's model.

package/plugins/pstack/hooks/session-start-copilot-sheet.md

@@ -0,0 +1 @@
+These are the user's saved pstack model choices from the Copilot model sheet. Each role line is an explicit model instruction for the `task` tool's `model` parameter; `inherit-parent` or `auto` omits `model`. Use these instead of reading the sheet:

package/plugins/pstack/hooks/session-start-copilot.md

@@ -0,0 +1,3 @@
+On GitHub Copilot, load pstack skills by their bare names through the `skill` tool (`poteto-mode`, `tdd`, `architect`, not `pstack:poteto-mode`); the plugin's agents keep the prefix (`pstack:poteto-agent`, `pstack:comment-sicko`). Copilot lists only part of a large plugin's skills in its prompt; every pstack skill a workflow names still loads by that name. `.github/copilot-instructions.md` and `~/.copilot/copilot-instructions.md` count as user instructions. Resolve every Claude tool, model, path, and built-in skill a pstack skill names through `references/copilot-tools.md` in the `poteto-mode` skill directory. pstack ships no default Copilot models. A skill that dispatches on role models takes them from the user's saved pstack model choices. The plugin hook reads them from the Copilot model sheet, `${COPILOT_HOME:-~/.copilot}/pstack-models.md`, checks them, and adds them to the end of this block. Do not `view` the sheet. It sits outside the workspace, so reading it asks for path access. After `setup-pstack` writes the sheet in this session, use the values it just wrote.
+
+Skills that dispatch on role models: `architect`, `arena`, `how`, `interrogate`, `no-comments`, `poteto-mode`, `reflect`, `swarm`, `thermos`, `why`.

package/plugins/pstack/hooks/session-start-minimax.md

@@ -0,0 +1,17 @@
+<EXTREMELY_IMPORTANT>
+You have pstack.
+
+Load the `pstack:poteto-mode` skill with the `skill` tool and follow its instructions when a task meets any of these:
+
+- it touches more than one file, or changes a signature other files call
+- it involves a design or architecture choice
+- it is a bug whose cause is not yet known, or a performance issue
+
+It routes to the right pstack skill from there. For smaller tasks, such as a contained change to one file with an obvious test, a question, or a one-line edit, work directly and verify on the real artifact.
+
+When the intent is already specific, enter that skill directly: `pstack:tdd`, `pstack:architect`, `pstack:how`, `pstack:why`, `pstack:arena`, `pstack:interrogate`.
+
+Resolve every Claude tool, model, and built-in skill a pstack skill names through the MiniMax Code mapping in the `poteto-mode` skill directory, `references/minimax-tools.md`.
+
+User instructions (AGENTS.md, direct requests) take precedence. Other session-start mandates still apply. Their skill checks run as before, and when a task meets the criteria above they route implementation through poteto-mode.
+</EXTREMELY_IMPORTANT>

package/plugins/pstack/hooks/session-start-muse-sheet.md

@@ -0,0 +1 @@
+These are the user's saved pstack model choices from the Muse model sheet. Each role line is an explicit model instruction for that role; `inherit-parent` or `auto` runs it on the parent session's model. Use these instead of reading the sheet:

package/plugins/pstack/hooks/session-start-muse.md

@@ -0,0 +1,17 @@
+<EXTREMELY_IMPORTANT>
+You have pstack.
+
+Invoke the `plugin:pstack:poteto-mode` skill and follow its instructions when a task meets any of these:
+
+- it touches more than one file, or changes a signature other files call
+- it involves a design or architecture choice
+- it is a bug whose cause is not yet known, or a performance issue
+
+It routes to the right pstack skill from there. For smaller tasks, such as a contained change to one file with an obvious test, a question, or a one-line edit, work directly and verify on the real artifact.
+
+When the intent is already specific, enter that skill directly: `plugin:pstack:tdd`, `plugin:pstack:architect`, `plugin:pstack:how`, `plugin:pstack:why`, `plugin:pstack:arena`, `plugin:pstack:interrogate`.
+
+Resolve every Claude tool, model, and built-in skill a pstack skill names through the Muse mapping in the `poteto-mode` skill directory, `references/muse-tools.md`.
+
+User instructions (AGENTS.md, direct requests) take precedence. Other session-start mandates still apply. Their skill checks run as before, and when a task meets the criteria above they route implementation through poteto-mode.
+</EXTREMELY_IMPORTANT>

package/plugins/pstack/hooks/session-start-opencode.md

@@ -0,0 +1,17 @@
+<EXTREMELY_IMPORTANT>
+You have pstack.
+
+Invoke the `pstack-poteto-mode` skill and follow its instructions when a task meets any of these:
+
+- it touches more than one file, or changes a signature other files call
+- it involves a design or architecture choice
+- it is a bug whose cause is not yet known, or a performance issue
+
+It routes to the right pstack skill from there. For smaller tasks, such as a contained change to one file with an obvious test, a question, or a one-line edit, work directly and verify on the real artifact.
+
+When the intent is already specific, enter that skill directly: `pstack-tdd`, `pstack-architect`, `pstack-how`, `pstack-why`, `pstack-arena`, `pstack-interrogate`.
+
+User instructions (AGENTS.md, direct requests) take precedence. Other session-start mandates, such as superpowers, still apply. Their skill checks run as before, and when a task meets the criteria above they route implementation through poteto-mode.
+
+Read `references/opencode-tools.md` from the installed `pstack-poteto-mode` skill directory for OpenCode tool and model translations. Use the `skill` tool with the `pstack-` skill IDs above.
+</EXTREMELY_IMPORTANT>