marketing-mindset 1.1.1 → 1.2.0

package/README.md

@@ -41,3 +41,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,37 @@ 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 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;
+}
+
 const cmd = (process.argv[2] || "").toLowerCase();
 const rest = process.argv.slice(3);
 
@@ -92,6 +123,8 @@ 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 === "sections") {
   sections(readSkill()).forEach((s, i) => console.log(String(i + 1).padStart(2) + ". " + s.title));
 } else if (cmd === "read") {
@@ -114,6 +147,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 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.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.",
   "keywords": [
     "agent-skill",
     "skill",