marketing-mindset 1.0.0 → 1.1.1

package/README.md

@@ -0,0 +1,43 @@
+# marketing-mindset
+
+A marketer's operating mindset, packaged as an installable agent skill plus a CLI.
+Not a template library: the judgement layer — how much volume a test needs before a verdict is allowed,
+when to kill a channel, what a deliverable is.
+
+```bash
+npx marketing-mindset                      # help + the test-size floors
+npx marketing-mindset sample --base 0.03 --lift 0.2   # required per-arm sample size
+npx marketing-mindset kill --base 0.03 --n 1500       # the kill rule for a running test
+npx marketing-mindset sections             # list every section of SKILL.md
+npx marketing-mindset read numbers         # print one section
+npx marketing-mindset install              # copy the skill into your agent's skills dir
+```
+
+## Floors that do not move
+
+| Test | Volume before a verdict means anything |
+|---|---|
+| Cold email reply rate | ~1,500–2,000 sends per variant |
+| Landing page smoke test | 100–200 targeted visitors |
+| Strict A/B test | ~10,000 visitors per variation |
+| Paid ads | spend gate at 1–3x target CPA, 48–72h |
+
+## Links
+
+- Skill page: https://axelfreeman.github.io/marketing-mindset/
+- Source: https://github.com/axelfreeman/marketing-mindset
+- Free test-size calculator (browser, no signup): https://axelfreeman.github.io/marketing-mindset/tools/email-test-planner.html
+- MCP server, same method over stdio: https://www.npmjs.com/package/marketing-mindset-mcp
+- `llms.txt` for agents: https://axelfreeman.com/llms.txt
+
+## Need this done for you?
+
+The skill is the method. The done-for-you version — offer, landing pages, a free tool,
+sending setup that passes a deliverability checklist, tests with a written kill rule, and
+measurement inside your own analytics property — is sold as fixed-scope packages, with the
+scope and the prices published before you get on a call:
+
+**https://axelfreeman.com/marketing-engineer.html** — Sprint $900 · Engine $1,900/month · Full build $2,900.
+Scope: https://axelfreeman.com/scope.html · Pricing: https://axelfreeman.com/pricing.html
+
+MIT © Axel Freeman

package/bin/cli.js

@@ -0,0 +1,129 @@
+#!/usr/bin/env node
+/* marketing-mindset CLI — the skill and its numbers without opening a file.
+ *   marketing-mindset                help + the test-size floors
+ *   marketing-mindset sample         required per-arm sample size for a two-proportion test
+ *   marketing-mindset kill           the kill rule for a running test
+ *   marketing-mindset sections       list every section of SKILL.md
+ *   marketing-mindset read <text>    print one section by fuzzy title match
+ *   marketing-mindset install        copy the skill into your agent's skills directory
+ */
+const fs = require("fs");
+const path = require("path");
+
+const pkgRoot = path.join(__dirname, "..");
+const SKILL = path.join(pkgRoot, "skill", "SKILL.md");
+
+const ZA = { "0.05": 1.9599639845, "0.01": 2.5758293036, "0.1": 1.6448536270, "0.975": 1.9599639845 };
+const ZB = { "0.8": 0.8416212336, "0.9": 1.2815515655 };
+
+function sampleSize(rate, lift, power, alpha) {
+  const p1 = Math.min(Math.max(rate, 0.000001), 0.999999);
+  const p2 = Math.min(p1 * (1 + lift), 0.999999);
+  const pbar = (p1 + p2) / 2;
+  const za = ZA[String(alpha)] || ZA["0.05"];
+  const zb = ZB[String(power)] || ZB["0.8"];
+  const num = Math.pow(za * Math.sqrt(2 * pbar * (1 - pbar)) + zb * Math.sqrt(p1 * (1 - p1) + p2 * (1 - p2)), 2);
+  return Math.ceil(num / Math.pow(p2 - p1, 2));
+}
+
+function flags(argv) {
+  const out = {};
+  argv.forEach((a, i) => {
+    if (a.startsWith("--")) {
+      const v = argv[i + 1];
+      out[a.slice(2)] = v && !v.startsWith("--") ? Number(v) : true;
+    }
+  });
+  return out;
+}
+
+function sections(md) {
+  const lines = md.split("\n");
+  const out = [];
+  let cur = null;
+  lines.forEach((l) => {
+    const m = /^##\s+(.*)$/.exec(l);
+    if (m) {
+      if (cur) out.push(cur);
+      cur = { title: m[1].trim(), body: [] };
+    } else if (cur) cur.body.push(l);
+  });
+  if (cur) out.push(cur);
+  return out;
+}
+
+function readSkill() {
+  if (!fs.existsSync(SKILL)) {
+    console.error("SKILL.md missing from this install (expected at " + SKILL + ")");
+    process.exit(2);
+  }
+  return fs.readFileSync(SKILL, "utf8");
+}
+
+const cmd = (process.argv[2] || "").toLowerCase();
+const rest = process.argv.slice(3);
+
+if (cmd === "sample") {
+  const f = flags(rest);
+  const rate = Number(f.base !== undefined ? f.base : 0.03);
+  const lift = Number(f.lift !== undefined ? f.lift : 0.2) ;
+  const power = Number(f.power !== undefined ? f.power : 0.8);
+  const alpha = Number(f.alpha !== undefined ? f.alpha : 0.05);
+  const n = sampleSize(rate, lift, power, alpha);
+  console.log(JSON.stringify({
+    baseline_rate: rate, min_relative_lift: lift, power, alpha,
+    per_arm: n, total: n * 2,
+    note: "Below this, a difference between variants is random noise. Declare this number before the test starts."
+  }, null, 2));
+} else if (cmd === "kill") {
+  const f = flags(rest);
+  const rate = Number(f.base !== undefined ? f.base : 0.03);
+  const n = Number(f.n !== undefined ? f.n : 1500);
+  const lift = Number(f.lift !== undefined ? f.lift : 0.2);
+  const floor = Math.max(0, Math.floor(rate * n - 1.2816 * Math.sqrt(n * rate * (1 - rate))));
+  const needed = sampleSize(rate, lift, 0.8, 0.05);
+  console.log(JSON.stringify({
+    baseline_rate: rate, n, min_relative_lift: lift,
+    expected_conversions: Math.round(rate * n * 10) / 10,
+    kill_floor: floor,
+    target_conversions: Math.round(rate * (1 + lift) * n * 10) / 10,
+    volume_needed_per_arm: needed,
+    verdict: n < needed
+      ? "keep running — below the required volume, a verdict now is noise"
+      : "read it — volume is sufficient; kill if conversions are at or under the floor"
+  }, null, 2));
+} else if (cmd === "sections") {
+  sections(readSkill()).forEach((s, i) => console.log(String(i + 1).padStart(2) + ". " + s.title));
+} else if (cmd === "read") {
+  const q = rest.join(" ").toLowerCase();
+  if (!q) { console.error("usage: marketing-mindset read <part of a section title>"); process.exit(1); }
+  const hit = sections(readSkill()).find((s) => s.title.toLowerCase().includes(q));
+  if (!hit) {
+    console.error("no section matches: " + q + " — run: marketing-mindset sections");
+    process.exit(1);
+  }
+  console.log("## " + hit.title + "\n" + hit.body.join("\n").trim());
+} else if (cmd === "install") {
+  require(path.join(__dirname, "install.js"));
+} else {
+  console.log(`marketing-mindset — the marketing OS for AI agents
+
+Usage:
+  npx marketing-mindset                 this help + the floors
+  npx marketing-mindset sample          required per-arm sample size
+      --base 0.03 --lift 0.2 --power 0.8 --alpha 0.05
+  npx marketing-mindset kill            kill rule for a running test
+      --base 0.03 --n 1500 --lift 0.2
+  npx marketing-mindset sections        every section of the skill
+  npx marketing-mindset read numbers    print one section
+  npx marketing-mindset install         copy the skill into your agent's skills dir
+
+Floors that do not move (see SKILL.md):
+  cold email reply-rate test   ~1,500-2,000 sends per variant
+  landing page smoke test      100-200 targeted visitors
+  strict A/B test              ~10,000 visitors per variation
+  paid ads                     spend gate 1-3x target CPA, 48-72h
+
+Docs: https://axelfreeman.github.io/marketing-mindset/
+Skill: https://github.com/axelfreeman/marketing-mindset`);
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "marketing-mindset",
-  "version": "1.0.0",
-  "description": "A marketer's operating mindset as an installable agent skill: test-size floors, kill rules, channel economics. Installs SKILL.md for Claude Code, Codex, Hermes and any agent that reads markdown skills.",
+  "version": "1.1.1",
+  "description": "A marketer's operating mindset as an installable agent skill and CLI: test-size floors, kill rules, channel economics. npx marketing-mindset sample|kill|sections|read|install.",
   "keywords": [
     "agent-skill",
     "skill",
@@ -22,7 +22,8 @@
     "url": "git+https://github.com/axelfreeman/marketing-mindset.git"
   },
   "bin": {
-    "marketing-mindset": "bin/install.js"
+    "marketing-mindset": "bin/cli.js",
+    "marketing-mindset-install": "bin/install.js"
   },
   "files": [
     "bin/",