marketing-mindset 1.1.1 → 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 |
@@ -41,3 +47,15 @@ scope and the prices published before you get on a call:
 Scope: https://axelfreeman.com/scope.html · Pricing: https://axelfreeman.com/pricing.html
 
 MIT © Axel Freeman
+
+## Agent readiness / AEO checklist from the CLI
+
+```
+npx marketing-mindset aeo          # 23 weighted checks, grouped, with the max score
+npx marketing-mindset aeo --json   # same data for a script or an agent
+```
+
+The same checklist is a browser tool with a live score:
+<https://axelfreeman.github.io/marketing-mindset/tools/aeo-readiness-checklist.html>.
+If you want the plumbing in that checklist built for you (offer page, query-intent pages, schema,
+`llms.txt`, IndexNow, the tracked event), packages are published at https://axelfreeman.com/marketing-engineer.html.

package/bin/cli.js

@@ -60,6 +60,113 @@ function readSkill() {
   return fs.readFileSync(SKILL, "utf8");
 }
 
+
+/* --- 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
+ */
+const AEO_GROUPS = [["Crawlability",[["robots.txt does not block GPTBot, ClaudeBot, PerplexityBot, Google-Extended, OAI-SearchBot",3],["Pages render without JavaScript, or have a server-side/no-JS fallback",2],["No login wall or consent interstitial in front of the content you want quoted",3],["The page returns 200 to a plain curl with no cookies",2],["One canonical URL per answer - no www/non-www or trailing-slash duplicates",2]]],["Answer-ready content",[["Every important page answers one question in the first 60 words",3],["Headings are questions a human would type, not internal project names",2],["Prices, limits and timeframes are stated as numbers, not 'flexible'",3],["Claims have a source or a live URL attached",2],["A definition page exists for the category you want to be cited in",3]]],["Machine-readable",[["schema.org markup on service/product pages (Service, Offer, Product, FAQPage)",3],["FAQPage or QAPage markup on question pages, answers 40-500 words",2],["XML sitemap submitted, and every new URL pinged via IndexNow",2],["llms.txt describes what the site answers and where the canonical pages are",2],["Organisation/Person entity links the page to a real, verifiable identity",2]]],["Someone else's page",[["You are present where the model already reads: package registries, repos, docs",3],["At least one open, mergeable pull request or discussion contribution",2],["Your content is mirrored somewhere you do not control",2],["A third-party page links to your canonical URL",3]]],["Proof and measurement",[["Every claim on the site can be opened by the reader in one click",3],["One tracked event for the outcome that matters, in your own analytics property",3],["A public changelog or artifact list with dates",2],["An archived snapshot of the key pages exists",1]]]];
+const AEO_MAX = AEO_GROUPS.reduce((a, [_, its]) => a + its.reduce((b, [, w]) => b + w, 0), 0);
+
+function runAeo(opts) {
+  if (opts.json) {
+    console.log(JSON.stringify({ max_score: AEO_MAX, groups: AEO_GROUPS.map(([g, its]) => ({ group: g, checks: its.map(([t, w]) => ({ check: t, weight: w })) })) }, null, 2));
+    return 0;
+  }
+  console.log("Agent readiness / AEO checklist - can AI answers find, read and quote the site?");
+  console.log("Max score: " + AEO_MAX + "\n");
+  let n = 0;
+  AEO_GROUPS.forEach(([g, its]) => {
+    console.log(g + ":");
+    its.forEach(([t, w]) => { n += 1; console.log("  [" + w + "] " + t); });
+    console.log("");
+  });
+  console.log(n + " checks, " + AEO_MAX + " points. Score guide: <30% invisible for structural reasons,");
+  console.log("30-60% crawlable but not quotable, 60-80% quoted occasionally (third-party presence missing),");
+  console.log(">80% the rest is cadence. Two checks carry the most weight: one question answered in the");
+  console.log("first 60 words, and prices/limits stated as numbers.");
+  console.log("Full description of the work: https://axelfreeman.com/marketing-engineer.html");
+  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);
 
@@ -92,6 +199,10 @@ if (cmd === "sample") {
       ? "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 === "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") {
@@ -114,6 +225,10 @@ 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
   npx marketing-mindset read numbers    print one section
   npx marketing-mindset install         copy the skill into your agent's skills dir

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "marketing-mindset",
-  "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.",
+  "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",