@antoneeo/mkt-agentic-sdlc-skill 0.2.1 → 0.3.1

package/CHANGELOG.md

@@ -1,22 +1,96 @@
-# Changelog
-
-## 0.2.1 — 2026-07-09
-
-- **Install DX fix**: README + the generated project protocol pointer no longer present `mkt-sdlc-install-skill` as a required second step. `npm i -g` alone installs the skill (the `postinstall` runs the installer); the manual command is documented as a fallback via `npx mkt-sdlc-install-skill` for setups that block install scripts, with an explicit note that the bare command is only on PATH after a global install. Prevents the "command not recognized" error after a local `npm i`.
-
-## 0.2.0 — 2026-07-09 (v1.0 hardening)
-
-- **Deterministic doctrine gate**: `scripts/test_skill_invariants.py` asserts the load-bearing invariants (three guarantees, review red-flags R1/R11b/R15, elicitation rules, research URL rule, parseable template tokens, sales-led funnel guidance, support-file wiring). Fails on a real regression.
-- **Opt-in behavioral eval layer**: `evals/run_behavioral.py` (zero-LLM driver) + 6 scenarios (triage/escalation, owned-facts elicitation, no-number-without-ledger, swap-test enforced, low-cost-trap flagged, no-guaranteed-success). Mirrors the sibling skill.
-- **Contrast validation (B2B sales-led)**: second synthetic eval on a business unlike the first — the Vision Alignment / amendment discipline caught and held a deliberate vision-divergence (self-serve tier) instead of absorbing it.
-- **Calibration from the contrast run**: sales-led/B2B funnel guidance (funnel output = qualified demos not closed customers; separate pipeline build-up table; closed-won lag) in `frameworks.md` + `templates.md`; B2B firmographic-ICP + buying-committee variant in `templates.md`.
-- ENFORCEMENT.md §5/§6 updated to run both deterministic batteries + the behavioral layer.
-
-## 0.1.0 — 2026-07-09
-
-Initial release.
-
-- Operating contract `SKILL.md`: Marketing Values, Rule Zero engagement triage (E1/E2/E3/Spike), dual operating modes (Standalone `mkt_docs/`, Hybrid devPNT), E3 nine-phase SOSTAC workflow with user gates, adversarial review gates and mechanical validation.
-- Support files: `frameworks.md` (framework selection guide), `elicitation.md` (question waves, only-facts-you-own rule), `research.md` (research playbook + evidence ledger discipline), `templates.md` (all artifact templates), `review.md` (CMO review discipline + marketing red flags), `ENFORCEMENT.md`.
-- Mechanical validator `scripts/mkt_check.py`: `check`, `validate`, `ledger`, `budget`, `funnel`, `trace`, `index`.
-- npm packaging: `mkt-sdlc-init` (project scaffold), `mkt-sdlc-install-skill` (multi-client skill install: Claude Code, Gemini CLI, Codex, Google Antigravity).
+# Changelog
+
+## 0.3.1 — 2026-08-02
+
+### Fixed
+- **The multi-lens routing note announced this skill as the code lens.** `init.js` wrote
+  the row for the CURRENT lens as a hardcoded literal copied from the code distribution,
+  so a project initialised with `mkt-sdlc-init` listed `agentic-sdlc` twice and never
+  named `mkt-agentic-sdlc`. Both the self row and the sibling table are now derived from
+  the shared `routing.md` lens table. Found by a cold-agent field test.
+- **`FACT` was the way past the evidence rule.** `BENCHMARK` owes a source URL and
+  `ASSUMPTION` a range; `FACT` owed nothing, so a researched observation classed FACT
+  with source "see research/VOC.md" entered the ledger unsourced. `mkt_check.py` now
+  errors on a FACT with no source, or one pointing at a document of the engagement,
+  while exempting a cell that names the client as origin. `research.md` states the two
+  legal origins.
+- `review.md` (shared spine): a review verdict travels as the reviewer's final output.
+
+## 0.3.0 — 2026-08-01
+
+- **One shared core, three lenses.** This skill is now built from the family's spine
+  instead of a copy of it: triage, the Vision gate, the review gates, the guide router,
+  question discipline and the validator core are byte-identical with
+  `@antoneeo/agentic-sdlc-skill` and `@antoneeo/kb-agentic-skill`, and a drift guard
+  verifies it on every build. `routing.md` decides which lens owns a unit of work when
+  more than one is installed.
+- `mkt_check.py` forwards every spine subcommand it does not intercept by iterating the
+  spine's parser — the hand-copied command tuple used to drop `migrate` while `SKILL.md`
+  documented it.
+
+## 0.2.1 — 2026-07-09
+
+- **Install DX fix**: README + the generated project protocol pointer no longer present `mkt-sdlc-install-skill` as a required second step. `npm i -g` alone installs the skill (the `postinstall` runs the installer); the manual command is documented as a fallback via `npx mkt-sdlc-install-skill` for setups that block install scripts, with an explicit note that the bare command is only on PATH after a global install. Prevents the "command not recognized" error after a local `npm i`.
+
+## 0.2.0 — 2026-07-09 (v1.0 hardening)
+
+- **Deterministic doctrine gate**: `scripts/test_skill_invariants.py` asserts the load-bearing invariants (three guarantees, review red-flags R1/R11b/R15, elicitation rules, research URL rule, parseable template tokens, sales-led funnel guidance, support-file wiring). Fails on a real regression.
+- **Opt-in behavioral eval layer**: `evals/run_behavioral.py` (zero-LLM driver) + 6 scenarios (triage/escalation, owned-facts elicitation, no-number-without-ledger, swap-test enforced, low-cost-trap flagged, no-guaranteed-success). Mirrors the sibling skill.
+- **Contrast validation (B2B sales-led)**: second synthetic eval on a business unlike the first — the Vision Alignment / amendment discipline caught and held a deliberate vision-divergence (self-serve tier) instead of absorbing it.
+- **Calibration from the contrast run**: sales-led/B2B funnel guidance (funnel output = qualified demos not closed customers; separate pipeline build-up table; closed-won lag) in `frameworks.md` + `templates.md`; B2B firmographic-ICP + buying-committee variant in `templates.md`.
+- ENFORCEMENT.md §5/§6 updated to run both deterministic batteries + the behavioral layer.
+
+## 0.1.0 — 2026-07-09
+
+Initial release.
+
+- Operating contract `SKILL.md`: Marketing Values, Rule Zero engagement triage (E1/E2/E3/Spike), dual operating modes (Standalone `mkt_docs/`, Hybrid devPNT), E3 nine-phase SOSTAC workflow with user gates, adversarial review gates and mechanical validation.
+- Support files: `frameworks.md` (framework selection guide), `elicitation.md` (question waves, only-facts-you-own rule), `research.md` (research playbook + evidence ledger discipline), `templates.md` (all artifact templates), `review.md` (CMO review discipline + marketing red flags), `ENFORCEMENT.md`.
+- Mechanical validator `scripts/mkt_check.py`: `check`, `validate`, `ledger`, `budget`, `funnel`, `trace`, `index`.
+- npm packaging: `mkt-sdlc-init` (project scaffold), `mkt-sdlc-install-skill` (multi-client skill install: Claude Code, Gemini CLI, Codex, Google Antigravity).
+
+## [0.3.0] - 2026-08-01
+
+### One shared core, three lenses
+
+This release is the consolidation: `agentic-sdlc` (code), `kb-agentic` (knowledge)
+and `mkt-agentic-sdlc` (marketing) are now built from ONE spine instead of being
+copies of one another. They can be installed side by side, they share a single
+`ai_docs/` tree, and the agent has a stated test for which one governs a given
+piece of work.
+
+**Nothing changes for an existing project.** No `default_domain` line resolves to
+`code`; no `domain:` field means no new column and no new check; the router is
+never read unless a sibling lens is installed, and never at all on a trivial task.
+A frozen corpus plus a recorded transcript of every command and exit code
+(`test_golden_regression.py`) is what makes that a checkable claim rather than a
+promise.
+
+### Added
+- `routing.md` — the domain router: which lens owns this unit of work. Read only
+  when a sibling lens is installed; fails open to the loaded lens.
+- Optional `domain:` and `checks:` on an artifact, `default_domain:` in the docs
+  root README. All optional; a single-domain project writes none of them.
+- **Portable checks**: a document owned by one domain can import another domain's
+  checks by name. Imported checks may only ADD findings, never relax what the
+  owning domain requires.
+- `migrate` — relocate a documentation root. Dry run by default, refuses a dirty
+  git tree, refuses to overwrite, never deletes, and leaves user-authored protocol
+  pointers untouched (they are reported instead).
+- `--docs-dir` / `AGENTIC_SDLC_DOCS_DIR`: the documentation root is resolved
+  (explicit flag > env > nearest recognized root > `ai_docs`). Two roots side by
+  side refuse rather than half-validate.
+- The drift guard (`shared_files.py`, `test_drift.py`): the spine is authored once
+  and copied verbatim, and a forgotten copy now fails a test instead of reaching a
+  user.
+
+### Changed
+- The validator ships as **two files**: `sdlc_core.py` (the shared spine) and the
+  domain entry point. If you copied it into CI, copy both — `ENFORCEMENT.md` §2 has
+  the recipe, and a half copy fails loudly at import rather than passing green.
+- A review now reports a **restated fact** as a finding: every governance slot has
+  one owning document, and the fix is a citation, not a better copy.
+- The invariant battery is shared across distributions and reads a per-distribution
+  PROFILE. Spine capabilities cannot be dropped by editing a profile; optional
+  overlays are declared in one line.
+

package/README.md

@@ -1,57 +1,67 @@
-# Marketing Agentic SDLC Skill
-
-Evidence-First marketing planning protocol for AI coding agents (Claude Code, Gemini CLI, Google Antigravity, Codex). The sibling of [`@antoneeo/agentic-sdlc-skill`](https://www.npmjs.com/package/@antoneeo/agentic-sdlc-skill), transplanted from software engineering to marketing strategy.
-
-## What it does
-
-Turns an AI agent into a disciplined marketing strategist that produces a professional, professionally-recognized marketing plan (SOSTAC structure) with three engineered guarantees:
-
-1. **Evidence ledger** — every market number is classified FACT / BENCHMARK / ASSUMPTION and carries an `[EV-nn]` reference to its source. No invented numbers.
-2. **Mechanical validator** (`mkt_check.py`) — budget sums, funnel math and the objective→tactic→KPI chain are checked mechanically, not rhetorically.
-3. **Adversarial CMO review** — an independent, fresh-context reviewer attacks the strategy before the user sees it (generic-positioning swap test, untraced claims, orphan tactics).
-
-The agent asks the user only for facts the user uniquely owns (product, price, budget, capacity); everything else — market sizing, competitor analysis, channel benchmarks — is derived from real web research.
-
-## Install
-
-```bash
-npm i -g @antoneeo/mkt-agentic-sdlc-skill
-```
-
-That's it — the skill is copied into every detected AI client automatically
-(the package's `postinstall` runs the installer). Restart the agent to load it.
-
-**If your npm blocks install scripts** (`--ignore-scripts`, some CI/pnpm setups),
-run the installer manually:
-
-```bash
-npx mkt-sdlc-install-skill
-```
-
-> The `mkt-sdlc-install-skill` command is only on your PATH after a **global**
-> (`-g`) install. After a local `npm i`, invoke it via `npx` as above.
-
-Initialize a project:
-
-```bash
-cd my-business-project
-npx mkt-sdlc-init        # creates mkt_docs/ + protocol pointers
-```
-
-## Engagement levels (Rule Zero)
-
-| Level | Scope | Process |
-|---|---|---|
-| E1 Quick | single question / asset feedback | direct answer, sourced numbers |
-| E2 Campaign | one campaign or channel plan | mini-brief + targeted research + campaign doc |
-| E3 Full Plan | complete marketing plan | full SOSTAC workflow, 9 phases, all gates |
-| Research Spike | time-boxed market question | `mkt_docs/spikes/RESEARCH_[topic].md` |
-
-## Modes
-
-- **Standalone** — everything on the filesystem under `mkt_docs/`.
-- **Hybrid with devPNT** — plans and strategy artifacts governed as versioned devPNT documents (MKT-VISION, ICP/Personas, Threat Map, Strategy, Tactical Plan, Measurement Plan), with proposal/approval workflow and independent review gates.
-
-## License
-
-MIT — Antonio Pinto
+# Marketing Agentic SDLC Skill
+
+Evidence-First marketing planning protocol for AI coding agents (Claude Code, Gemini CLI, Google Antigravity, Codex). The sibling of [`@antoneeo/agentic-sdlc-skill`](https://www.npmjs.com/package/@antoneeo/agentic-sdlc-skill), transplanted from software engineering to marketing strategy.
+
+## What it does
+
+Turns an AI agent into a disciplined marketing strategist that produces a professional, professionally-recognized marketing plan (SOSTAC structure) with three engineered guarantees:
+
+1. **Evidence ledger** — every market number is classified FACT / BENCHMARK / ASSUMPTION and carries an `[EV-nn]` reference to its source. No invented numbers.
+2. **Mechanical validator** (`mkt_check.py` + `sdlc_core.py` — the entry point plus the family's shared spine; copy both, or neither) — budget sums (±1%), funnel math recomputed cell by cell (±5%) and the objective→tactic→KPI chain are checked mechanically, not rhetorically: `check`, `validate`, `ledger`, `budget`, `funnel`, `trace`, `index`, plus the spine's `stale`/`mark`/`gate`/`plan`/`orient`/`migrate`.
+3. **Adversarial CMO review** — an independent, fresh-context reviewer attacks the strategy before the user sees it (generic-positioning swap test, untraced claims, orphan tactics).
+
+The agent asks the user only for facts the user uniquely owns (product, price, budget, capacity); everything else — market sizing, competitor analysis, channel benchmarks — is derived from real web research.
+
+## Install
+
+```bash
+npm i -g @antoneeo/mkt-agentic-sdlc-skill
+```
+
+That's it — the skill is copied into every detected AI client automatically
+(the package's `postinstall` runs the installer). Restart the agent to load it.
+
+**If your npm blocks install scripts** (`--ignore-scripts`, some CI/pnpm setups),
+run the installer manually:
+
+```bash
+npx mkt-sdlc-install-skill
+```
+
+> The `mkt-sdlc-install-skill` command is only on your PATH after a **global**
+> (`-g`) install. After a local `npm i`, invoke it via `npx` as above.
+
+Initialize a project:
+
+```bash
+cd my-business-project
+npx mkt-sdlc-init        # creates mkt_docs/ + protocol pointers
+```
+
+## Engagement levels (Rule Zero)
+
+| Level | Scope | Process |
+|---|---|---|
+| E1 Quick | single question / asset feedback | direct answer, sourced numbers |
+| E2 Campaign | one campaign or channel plan | mini-brief + targeted research + campaign doc |
+| E3 Full Plan | complete marketing plan | full SOSTAC workflow, 9 phases, all gates |
+| Research Spike | time-boxed market question | `mkt_docs/spikes/RESEARCH_[topic].md` |
+
+## Modes
+
+- **Standalone** — everything on the filesystem under `mkt_docs/`.
+- **Hybrid with devPNT** — plans and strategy artifacts governed as versioned devPNT documents (MKT-VISION, ICP/Personas, Threat Map, Strategy, Tactical Plan, Measurement Plan), with proposal/approval workflow and independent review gates.
+
+## The family: three lenses, one spine
+
+| Package | Faithful to | Unit of work |
+|---|---|---|
+| [`@antoneeo/agentic-sdlc-skill`](https://www.npmjs.com/package/@antoneeo/agentic-sdlc-skill) | this repository's code | feature |
+| [`@antoneeo/kb-agentic-skill`](https://www.npmjs.com/package/@antoneeo/kb-agentic-skill) | the documents you supply | topic |
+| `@antoneeo/mkt-agentic-sdlc-skill` (this one) | market evidence | engagement |
+
+Triage, the Vision Gate, the review gates, the guide router, question discipline and the validator spine are byte-identical across the three; only the fidelity discipline and the vocabulary change. When two live in the same project, `routing.md` decides which lens owns a given piece of work — with the market-facing override: anything whose purpose is to persuade the market is this lens's, whatever its source.
+
+## License
+
+MIT — Antonio Pinto

package/gemini-extension.json

@@ -1,6 +1,6 @@
-{
-  "name": "mkt-agentic-sdlc",
-  "version": "0.2.1",
-  "description": "Evidence-First marketing planning protocol with engagement triage, SOSTAC workflow, evidence ledger and optional devPNT integration.",
-  "author": "Antonio Pinto (https://github.com/Antoneeo)"
-}
+{
+  "name": "mkt-agentic-sdlc",
+  "version": "0.3.1",
+  "description": "Evidence-First marketing planning protocol with engagement triage, SOSTAC workflow, evidence ledger and optional devPNT integration.",
+  "author": "Antonio Pinto (https://github.com/Antoneeo)"
+}

package/package.json

@@ -1,45 +1,50 @@
-{
-  "name": "@antoneeo/mkt-agentic-sdlc-skill",
-  "version": "0.2.1",
-  "description": "Evidence-First marketing planning protocol for Claude Code, Gemini CLI, Google Antigravity and Codex: engagement triage, SOSTAC workflow, evidence ledger, mechanical validator and optional devPNT integration.",
-  "keywords": [
-    "claude-code",
-    "claude-skill",
-    "gemini-cli",
-    "skill",
-    "marketing",
-    "marketing-plan",
-    "sostac",
-    "ai-agent"
-  ],
-  "author": "Antonio Pinto (https://github.com/Antoneeo)",
-  "license": "MIT",
-  "publishConfig": {
-    "access": "public"
-  },
-  "bin": {
-    "mkt-sdlc-init": "scripts/init.js",
-    "mkt-sdlc-install-skill": "scripts/postinstall.js"
-  },
-  "scripts": {
-    "postinstall": "node scripts/postinstall.js",
-    "preuninstall": "node scripts/preuninstall.js"
-  },
-  "files": [
-    "skills/mkt-agentic-sdlc/SKILL.md",
-    "skills/mkt-agentic-sdlc/frameworks.md",
-    "skills/mkt-agentic-sdlc/elicitation.md",
-    "skills/mkt-agentic-sdlc/research.md",
-    "skills/mkt-agentic-sdlc/templates.md",
-    "skills/mkt-agentic-sdlc/review.md",
-    "skills/mkt-agentic-sdlc/ENFORCEMENT.md",
-    "skills/mkt-agentic-sdlc/scripts/mkt_check.py",
-    "gemini-extension.json",
-    "README.md",
-    "CHANGELOG.md",
-    "scripts/lib.js",
-    "scripts/init.js",
-    "scripts/postinstall.js",
-    "scripts/preuninstall.js"
-  ]
-}
+{
+  "name": "@antoneeo/mkt-agentic-sdlc-skill",
+  "version": "0.3.1",
+  "description": "Evidence-First marketing planning protocol for Claude Code, Gemini CLI, Google Antigravity and Codex: engagement triage, SOSTAC workflow, evidence ledger, mechanical validator and optional devPNT integration.",
+  "keywords": [
+    "claude-code",
+    "claude-skill",
+    "gemini-cli",
+    "skill",
+    "marketing",
+    "marketing-plan",
+    "sostac",
+    "ai-agent"
+  ],
+  "author": "Antonio Pinto (https://github.com/Antoneeo)",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "bin": {
+    "mkt-sdlc-init": "scripts/init.js",
+    "mkt-sdlc-install-skill": "scripts/postinstall.js"
+  },
+  "scripts": {
+    "postinstall": "node scripts/postinstall.js",
+    "preuninstall": "node scripts/preuninstall.js"
+  },
+  "files": [
+    "skills/mkt-agentic-sdlc/SKILL.md",
+    "skills/mkt-agentic-sdlc/frameworks.md",
+    "skills/mkt-agentic-sdlc/elicitation.md",
+    "skills/mkt-agentic-sdlc/research.md",
+    "skills/mkt-agentic-sdlc/templates.md",
+    "skills/mkt-agentic-sdlc/review.md",
+    "skills/mkt-agentic-sdlc/scripts/sdlc_core.py",
+    "skills/mkt-agentic-sdlc/routing.md",
+    "skills/mkt-agentic-sdlc/guides.md",
+    "skills/mkt-agentic-sdlc/vision.md",
+    "skills/mkt-agentic-sdlc/dispatch.md",
+    "skills/mkt-agentic-sdlc/ENFORCEMENT.md",
+    "skills/mkt-agentic-sdlc/scripts/mkt_check.py",
+    "gemini-extension.json",
+    "README.md",
+    "CHANGELOG.md",
+    "scripts/lib.js",
+    "scripts/init.js",
+    "scripts/postinstall.js",
+    "scripts/preuninstall.js"
+  ]
+}