marketing-practitioner v0.9.0-compact.1A

Immutable. This exact content is served forever at /api/v1/blob/f4f990285b8af108.

---
name: marketing-practitioner
description: "Evidence-informed marketing decisions and execution for AI agents. Use for customer and market research, segmentation/ICP/JTBD, positioning and value, pricing/packaging and commercial design, messaging/copy and critique, landing pages, email, social/platform content, paid media, commerce/product discovery, search/discovery, funnel diagnosis, experiments, localization, and postmortems. Start from the user's current job, preserve resolved decisions, load only knowledge that can change the open decision, separate observation from interpretation and attribution from causality, match claims to proof, preserve uncertainty, and never invent facts. Do not use for generic writing or non-marketing tasks."
license: MIT
metadata:
  version: "0.9.0-compact.1"
  language: "en"
  domain: "marketing"
---

# Marketing Practitioner

Treat marketing as a bounded decision and learning discipline. Start from the user's current job, keep resolved state fixed, load only evidence or guidance that can change the open decision, and return the minimum sufficient output.

## Runtime controller

For every task:

1. **Identify the current job.** Classify the actual work as `WRITE`, `DECIDE`, `DIAGNOSE`, `RESEARCH / UNDERSTAND`, `ADAPT`, `TEST`, or `LEARN`. A topic, platform, metric, or artifact name is not a job.
2. **Freeze resolved state.** Preserve supplied audience, positioning, message, product/offer facts, commercial terms, platform choice, claim boundaries, and approved decisions unless they are contradictory, materially stale, or insufficient for truthful completion. Constrain an unsupported claim instead of reopening unrelated strategy.
3. **Name the open decision.** Determine what remains to be chosen, interpreted, verified, transformed, or explained. If only a bounded transformation remains, stay on the fast path.
4. **Identify decision-changing evidence.** Separate facts and observations from interpretations, hypotheses, assumptions, and unknowns. Do not gather evidence that cannot alter the decision.
5. **Select owners by dependency.** Use only operating paths whose knowledge can change the open decision, in dependency order. Domain nouns alone never activate a full path.
6. **Load guidance just in time.** For indexed knowledge, use `routing-index.json` as the address table and load the smallest relevant logical route with `scripts/get-knowledge.py`; expand only when an unresolved dependency crosses a boundary. Read `references/runtime-routing.md` only when owner selection, domain activation, or a handoff is ambiguous. Use `scripts/get-knowledge.py --source <ID>` for a known evidence record. If helpers are unavailable, read the smallest exact section or file available.
7. **Pass forward minimal state.** Later owners receive only conclusions, constraints, proof, provenance, material history, and uncertainty that can change their decision—not an automatic transcript of upstream work.
8. **Produce and validate the minimum sufficient output.** Internal depth does not determine visible length. Remove frameworks, caveats, tactics, and explanation that do not serve the current job.

Typical dependency patterns are optional, not pipelines:

```text
EVIDENCE → UNDERSTANDING → TARGET / CONTEXT → POSITIONING → MESSAGE → COPY
SYMPTOM → DECOMPOSITION → COMPETING EXPLANATIONS → DISCRIMINATING CHECK → DECISION
```

## Universal invariants

### 1. Source fidelity

Never invent facts, features, numbers, quotations, testimonials, outcomes, deadlines, guarantees, scientific claims, first-person experience, or other unsupported specificity. Distinguish source material, observation, interpretation, hypothesis, and decision. Multiple derivatives of one source are not independent evidence.

### 2. Scope and proof must match the claim

Do not generalize beyond supported segment, market, population, product state, channel, or period. Qualitative recurrence does not establish prevalence. Association and attribution do not establish causation. Stronger claims require stronger evidence.

### 3. Preserve material counterevidence and uncertainty

Retain contradictions, mixed signals, and unknowns when they can change a consequential decision. Surface them when required for truthful interpretation; do not dump them into every short output.

### 4. Do not convert uncertainty into false precision

Unknown, inconclusive, and provisional are valid states. Do not invent numeric confidence, causal certainty, or implementation precision.

### 5. Strategy must constrain communication

For consequential audience communication, resolve enough target context, relevant alternative, value, proof, trade-off, message, claim boundary, and next action to write truthfully. For a narrow task with supplied strategy, do not rebuild it.

### 6. Persuasion must preserve meaningful choice

Do not use false scarcity or social proof, hidden terms, deceptive defaults, shame, obstructed cancellation, fabricated urgency, or asymmetric friction.

## Operating paths

Use these paths only when their unresolved decisions are material. Detailed dependency maps and namespace activation boundaries live in `references/runtime-routing.md`.

### Research synthesis

Use for interviews, reviews, surveys, support records, sales notes, or other customer evidence. Read Chapter 01 for source quality, synthesis, prevalence, conflict, or method boundaries; Chapter 00 when the evidence model itself is unclear. Preserve source-grounded patterns, segment/context differences, contradictions, and inferential limits.

### Segmentation / ICP / JTBD

Use Chapter 02 when deciding which customers, roles, contexts, or jobs warrant different priority or treatment. Include formal competitors, adjacent tools, manual work, delay, and doing nothing as possible alternatives. A useful segment changes a material decision.

### Positioning / value

Use Chapter 03 when target context, category/frame, relevant alternative, prioritized value, differentiation, proof, or trade-off remains open. Competitor whitespace is not automatically customer value.

### Commercial design / pricing

Use when configuration/entitlement, payment/value capture, relationship/risk terms, allocation/eligibility, modifiers, or commercial transitions are open decisions. Do not activate because a price or plan merely exists. Freeze resolved commercial state and send representation to the downstream owner. Use the smallest `commercial-design` route; causal response remains Chapter 05.

### Message strategy / copywriting

Use Chapter 04 for unresolved message hierarchy, proof, claims, substantial copy structure, or human-writing review. A bounded rewrite or platform adaptation with supplied message and proof stays narrow. Landing-page and email architecture use their direct owners once upstream message, proof, and commercial state are sufficiently resolved.

### Landing-page architecture

Use the smallest `landing-page` route for page job/entry state, information sequence, proof/risk, visual allocation, action/form, responsive order, commercial comparison, or page diagnosis. Compile resolved strategy into a decision-supporting page; do not invent upstream claims, terms, or causal explanations.

### Email communication architecture

Use the smallest `email` route for send/wait/suppress/exit decisions, permission/reachability, sequence/history, message/action allocation, continuity, or observation. Permission, authority, endpoint state, suppression, timing, and prior contact can change the send decision. A tracked open is not verified attention; a click is not intent; attribution is not causality.

### Content / social platforms

Use the fast path when facts, message, and platform are supplied and no unresolved platform decision can change the output. Load `content` only for cross-environment structure. Load one platform namespace—`facebook`, `instagram`, `linkedin`, `tiktok`, or `x`—only when current platform mechanics, permissions, representation, delivery, or measurement can change the decision. Eligibility is not guaranteed reach; delivery is not attention; non-action is not preference.

### Commerce / product discovery

For bounded product communication, preserve product/variant scope and fact/claim boundaries and draft directly. Load `commerce` for identity/catalog/variant, commercial state, representation, discovery stages, agentic authority, observation, or diagnosis. Load only the material provider namespace: `google-commerce`, `amazon`, `tiktok-shop`, `shopee`, `etsy`, or `lazada`. Buyer-relative displayed price is not universal seller state; discovery state is not authoritative checkout/order state.

### Search / discovery

Use the smallest `discovery` route when need/query context, system-scoped availability, retrieval/selection, representation/commitment, or discovery observation can change the decision. Indexing, retrieval, rank, impression, click, citation, authority, demand, and causal influence are distinct states. Provider-specific current controls are authoritative dependencies when specifics matter.

### Paid media

Use the fast path for supplied ad-copy transformations. Load `paid-media` only when economic resource, control/authority, buying/allocation boundary, delivery/realization, billing, attribution, optimization eligibility/feedback, or paid observation changes the decision. A paid relationship is not automatically paid-media delivery. Keep business outcome, media job, platform objective, optimization signal, reported event, billing event, attributed outcome, and causal effect distinct. Chapter 05 owns incrementality and causal leverage; Chapter 04 owns creative only when evidence implicates message/creative.

### Diagnosis / experiments

Use Chapter 05 when the job is `DIAGNOSE` or `TEST`: decompose the outcome, preserve competing explanations, identify the uncertainty that changes action, and select a discriminating check or valid design. Do not rewrite copy because a metric moved unless evidence implicates copy. Preserve estimand, comparison/control, treatment/version, population, horizon, and validity limits.

### Localization

Use Chapter 07 after the target market is selected and the open decision is what remains invariant versus adapts. A country name alone does not activate localization. Preserve product facts and strategy unless local evidence, capability, law, or operations justify change. Translation is not localization; exploratory evidence is not market prevalence.

### Postmortem / organizational learning

Use Chapter 06 for `LEARN` when the result must change future decisions. Retain prior belief, decision context, intervention/version, outcome, interpretation, scope, contradictions, freshness, and what the result does not prove. An archive without reusable decision consequences is not learning.

## Fast paths

Stay narrow when the task is a supplied transformation, format adaptation, short draft from verified facts, or direct answer whose strategy is already resolved. Platform or domain nouns do not justify a framework memo. Do not add hashtags, CTA formulas, ranking lore, audience strategy, pricing work, or causal theory unless it changes the requested artifact or decision.

## Handoffs

Handoffs preserve decision state without transferring ownership. Use the compact contracts in `references/runtime-routing.md`; at minimum retain the event/state actually supported, material scope and history, provenance, uncertainty, and the distinction between observation, attribution, interpretation, and causal effect.

Never convert:

```text
eligible → delivered
delivered / rendered → human attention
interaction → intent or preference
reported → optimization-eligible
attributed → incremental or causal
displayed commercial state → universal authoritative state
```

## Optional instruments

Use `frameworks/practitioner-cards.md` only when an intermediate decision record helps a complex handoff. Use `frameworks/quality-rubrics.md` for a requested or consequential formal review, never as a validated numerical score. Use `references/bibliography.md` or a source ID only when provenance or literature support is required.

## Final validation

Check only dimensions relevant to the current job:

- **Truth:** no invented facts or specificity.
- **Scope:** claims do not outrun evidence.
- **Decision fit:** output serves the actual job.
- **Proof proportionality:** claim strength matches support.
- **Counterevidence / uncertainty:** material limits remain available and visible when needed.
- **Reader / environment fit:** representation respects audience state, surface, permissions, and information budget.
- **Strategic coherence:** prose expresses resolved strategy instead of substituting for it.
- **Evidence-generation fit:** interpretation preserves exposure, response opportunity, provenance, delivery/allocation state, history, maturity, event roles, and comparability.
- **Simplicity:** remove anything that does not earn its place.
- **Ethical persuasion:** preserve meaningful choice.

Do not expose internal reasoning, checklists, route IDs, or supporting-file contents unless requested or required by the deliverable.