marketing-mindset 1.2.0 → 1.3.0

package/README.md

@@ -13,6 +13,12 @@ npx marketing-mindset read numbers         # print one section
 npx marketing-mindset install              # copy the skill into your agent's skills dir
 ```
 
+## `jd` — marketing engineer job description
+
+`npx marketing-mindset jd --level senior` prints the JD with the artifacts due by day 90,
+the sample-size floors, the kill rule and the screening questions. Web version:
+https://axelfreeman.github.io/marketing-mindset/tools/marketing-engineer-jd-generator.html
+
 ## Floors that do not move
 
 | Test | Volume before a verdict means anything |

package/bin/cli.js

@@ -64,6 +64,7 @@ function readSkill() {
 /* --- agent-readiness / AEO checklist (23 weighted checks) -------------------------------
  * The same checklist that runs in the browser tool, as data: agents can read it and score
  * a site without fetching HTML.
+ *   marketing-mindset jd         marketing engineer job description
  *   marketing-mindset aeo           grouped checklist with weights and the max score
  *   marketing-mindset aeo --json    machine-readable
  */
@@ -91,6 +92,81 @@ function runAeo(opts) {
   return 0;
 }
 
+
+/* --- job description (marketing engineer) ------------------------------------------------
+ * The same generator as the free web tool, as text: artifacts due by day 90, the sample-size
+ * floors, the kill rule, and the screening questions that separate an engineer from a marketer.
+ *   marketing-mindset jd                       senior, all surfaces
+ *   marketing-mindset jd --level contract --mode contract
+ *   marketing-mindset jd --surfaces seo,out,analytics
+ */
+const JD_SURFACES = {
+  seo: "search and answer engines (pages written to be quoted, schema, llms.txt)",
+  out: "outbound and lifecycle email (list, sequence, deliverability, suppression)",
+  paid: "paid acquisition (structure, creative, spend gates)",
+  auto: "automation and tracking (routing, events, failure alerts)",
+  analytics: "measurement (one event that matters, sample-size floors, kill rules)",
+  ai: "agent skills and AI-assisted production (reusable operating files, not one-off prompts)",
+};
+
+function runJd(opts) {
+  const jdOpt = (v, dflt) => (v === undefined || v === true || (typeof v === "number" && isNaN(v))) ? dflt : String(v);
+  const level = jdOpt(opts.level, "senior");
+  const mode = jdOpt(opts.mode, level === "contract" ? "contract" : "fulltime");
+  const sv = jdOpt(opts.surfaces, null);
+  const keys = sv ? sv.split(",").map((s) => s.trim()).filter((s) => JD_SURFACES[s]) : Object.keys(JD_SURFACES);
+  const surf = keys.length ? keys : Object.keys(JD_SURFACES);
+  const company = jdOpt(opts.company, "[company, product, what you sell in one line]");
+  const bottleneck = jdOpt(opts.bottleneck, "[the bottleneck you are hiring against]");
+  const ninety = mode === "contract"
+    ? "A 6-week engagement with one written kill rule, then a decision"
+    : level === "lead"
+      ? "A documented system: which paths exist, what each one costs, what gets killed next quarter"
+      : "A path live in production with its event recording, or a written note saying why it was killed";
+  const L = [];
+  L.push("# Marketing Engineer (" + level + ", " + mode + ")", "");
+  L.push("## The company and the job");
+  L.push(company + ".", "");
+  L.push("We are hiring a marketing engineer because: " + bottleneck + ".", "");
+  L.push("You will not be handed a channel to run and a deck to fill in. You will be handed a broken or "
+       + "unmeasured path and be expected to make it work, show the number, and write the rule that decides "
+       + "whether it lives.", "");
+  L.push("## What the role owns");
+  surf.forEach((k, i) => L.push((i + 1) + ". " + JD_SURFACES[k]));
+  L.push("", "## What must exist by day 90");
+  L.push("1. One path live in production: entry point, sequence or flow, and the event that fires on a conversion.");
+  L.push("2. A written declaration of the sample size each running test needs before a result counts as a result.");
+  L.push("3. A kill rule per test, written before the test starts: at what volume and what result we stop.");
+  L.push("4. One dashboard we can open without asking you for an export.");
+  L.push("5. " + ninety + ".");
+  L.push("", "## How we will measure you");
+  L.push("- Cost per qualified conversation or per activated account, when the volume is above the declared floor.");
+  L.push("- Live, openable artifacts still running 30 days after you last touched them.");
+  L.push("- Whether a decision made last month can be re-checked today from the data, without you in the room.");
+  L.push("- We do not count posts published, prompts written, or hours logged.");
+  L.push("", "## Requirements");
+  L.push("- You have shipped something that is still running: a page, a sequence, a script, an integration. Links beat adjectives.");
+  L.push("- You can explain, in one paragraph, why a 4-of-100 result is not a win.");
+  L.push("- You work in the tooling yourself: HTML/CSS, a spreadsheet, analytics, basic scripting, or an agent that writes them for you.");
+  L.push("- You write plainly; internal names and jargon are not allowed in anything a customer reads.");
+  L.push("", "## Nice to have");
+  L.push("- Experience writing pages that answer engines quote (schema, FAQ markup, plain HTML).");
+  L.push("- A history of killing your own work in public, with the numbers attached.");
+  L.push("", "## Not this role");
+  L.push("- Meeting-led account management, community management, brand campaigns, reporting for its own sake.");
+  L.push("", "## Screening questions (ask these first)");
+  L.push("1. Send us one link to something you built that is still live.");
+  L.push("2. We ran 40 sends, got 4 replies, variant B looks better. What do you do next?");
+  L.push("3. How many sends does a two-variant email test need before the result means anything? "
+       + "(Expected: ~1,500-2,000 per arm at a 3% baseline, 80% power, 20% relative lift.)");
+  L.push("4. Name one thing you killed and what the number was.");
+  L.push("5. What will you build in the first two weeks here, and how will we see it?");
+  L.push("", "--", "Generated by marketing-mindset (npm). Method and pricing: " + OFFER
+       + "  |  Packages: " + COST + "  |  Web version of this tool: " + JD_TOOL);
+  console.log(L.join("\n"));
+  return 0;
+}
+
 const cmd = (process.argv[2] || "").toLowerCase();
 const rest = process.argv.slice(3);
 
@@ -125,6 +201,8 @@ if (cmd === "sample") {
   }, null, 2));
 } else if (cmd === "aeo") {
   process.exit(runAeo(flags(rest)));
+} else if (cmd === "jd") {
+  process.exit(runJd(flags(rest)));
 } else if (cmd === "sections") {
   sections(readSkill()).forEach((s, i) => console.log(String(i + 1).padStart(2) + ". " + s.title));
 } else if (cmd === "read") {
@@ -147,6 +225,8 @@ Usage:
       --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 jd              marketing engineer job description
+      --level senior --mode fulltime --surfaces seo,out,analytics
   npx marketing-mindset aeo             agent-readiness / AEO checklist (23 weighted checks)
       --json                            machine-readable
   npx marketing-mindset sections        every section of the skill

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "marketing-mindset",
-  "version": "1.2.0",
-  "description": "A marketer's operating mindset as an installable agent skill and CLI: test-size floors, kill rules, channel economics, agent-readiness checklist. npx marketing-mindset sample|kill|aeo|sections|read|install.",
+  "version": "1.3.0",
+  "description": "A marketer's operating mindset as an installable agent skill and CLI: test-size floors, kill rules, agent-readiness checklist, marketing-engineer job description. npx marketing-mindset sample|kill|aeo|jd|sections|read|install.",
   "keywords": [
     "agent-skill",
     "skill",
@@ -12,7 +12,8 @@
     "codex",
     "llm",
     "prompt",
-    "sample-size"
+    "sample-size",
+    "job-description"
   ],
   "license": "MIT",
   "author": "Axel Freeman",