skills/marketing-council/references/skill-spec.json

{
  "name": "marketing-council",
  "purpose": "Diagnose ambiguous or cross-functional marketing problems and coordinate the minimum set of specialist skills",
  "baseline_failures": [
    "routing everything to every skill",
    "inventing dependency order",
    "hiding unresolved disagreement"
  ],
  "activation": {
    "positive": [
      "Diagnose this cross-functional marketing problem before choosing which specialists should own it",
      "Several marketing functions may be causing the result; decide what matters first and coordinate the minimum specialists",
      "Build an integrated marketing decision where positioning, pricing, media, and retention constraints may interact"
    ],
    "implicit": [
      "Growth is weak and we do not know whether the issue is market, offer, pricing, media, conversion, or retention",
      "The evidence points in different marketing directions and no single function clearly owns the next decision",
      "Challenge the competing functional hypotheses and tell me which specialist work should happen first"
    ],
    "negative": [
      "A single focused skill clearly owns the next decision",
      "The user only wants formatting or rewriting of an already-approved strategy"
    ],
    "collisions": [
      "Several focused marketing functions are plausible owners and the brief does not establish a safe dependency order"
    ]
  },
  "outputs": [
    "Council diagnosis",
    "bounded specialist route/DAG",
    "integrated decision with dissent"
  ],
  "execution": {
    "primary_agent": "council-director",
    "counterweight_agent": "marketing-skeptic",
    "primary_hook": "post-strategy-red-team",
    "evidence_hook": "evidence-gate",
    "binding_source": "council-owned"
  },
  "invariants": [
    "Do not finalize cross-functional decision without separating evidence from inference.",
    "Do not invent customer, market, platform, product, policy, or performance facts.",
    "State material uncertainty and reversal evidence instead of hiding it behind confident prose."
  ],
  "non_goals": [
    "Generic brainstorming without a decision boundary",
    "Pure copy polishing or formatting after the strategy is already approved",
    "Replacing focused expertise when one skill clearly owns the decision"
  ],
  "workflow": [
    {
      "id": "frame",
      "action": "Frame the cross-functional decision and the decision owner for marketing-council.",
      "why": "Prevents solving an adjacent problem or drifting into tactics.",
      "freedom": "low",
      "evidence_required": "User objective, constraints, and the decision that must change.",
      "completion": "The cross-functional decision is stated as one explicit decision question."
    },
    {
      "id": "evidence",
      "action": "Collect and classify the minimum evidence needed for cross-functional decision: problem statement, available evidence, competing functional hypotheses.",
      "why": "Separates known facts from inference and unsupported assumptions.",
      "freedom": "medium",
      "evidence_required": "Primary supplied evidence first; current external sources only when freshness matters.",
      "completion": "Evidence is tagged as fact, inference, assumption, or unknown and material gaps are visible."
    },
    {
      "id": "diagnose",
      "action": "Test competing explanations for the cross-functional decision instead of accepting the first plausible story.",
      "why": "Reduces confirmation bias and premature prescription.",
      "freedom": "high",
      "evidence_required": "At least one credible alternative explanation or counterweight.",
      "completion": "A primary explanation is selected and at least one alternative is rejected with reasons."
    },
    {
      "id": "decide",
      "action": "Produce the cross-functional decision with explicit trade-offs, risks, and what would reverse it.",
      "why": "Turns analysis into an accountable marketing decision.",
      "freedom": "medium",
      "evidence_required": "Decision criteria tied to the evidence ledger.",
      "completion": "The recommended decision, rejected alternative, risks, and reversal evidence are explicit."
    },
    {
      "id": "measure",
      "action": "Define how the cross-functional decision will be observed, challenged, and handed off.",
      "why": "Prevents recommendation theater and orphaned strategy.",
      "freedom": "medium",
      "evidence_required": "Observable outcome, leading signal, and next owner.",
      "completion": "Measurement, confidence, next handoff, and stop/escalation condition are stated."
    }
  ],
  "capabilities": {
    "required": [
      "reason over supplied context",
      "read packaged references"
    ],
    "optional": [
      "current web research when freshness is material",
      "deterministic calculation or parsing when available"
    ],
    "not_allowed": [
      "fabricate tool execution",
      "fabricate evidence",
      "perform irreversible external actions without authorization"
    ]
  },
  "evidence_policy": {
    "priority": [
      "user-provided primary evidence",
      "authoritative first-party sources",
      "reputable independent evidence"
    ],
    "freshness": "Verify current platform, policy, pricing, market, and product claims when they materially affect the decision.",
    "status_labels": [
      "fact",
      "inference",
      "assumption",
      "unknown"
    ]
  },
  "failure_behavior": "If evidence is insufficient for a defensible cross-functional decision, return the missing evidence, safest provisional interpretation, and the next smallest research action instead of guessing.",
  "completion_conditions": [
    "The cross-functional decision is explicit and answers the user’s decision question.",
    "Evidence and inference are distinguishable.",
    "At least one credible alternative or counterweight was considered.",
    "Outputs, measurement, confidence, and reversal evidence are present.",
    "Any required handoff is named and bounded."
  ],
  "handoffs": {
    "fallback": "marketing-council",
    "dynamic_router": "../../scripts/dynamic_router.py",
    "skill_router": "../../scripts/skill_router.py",
    "neural_router": "../../scripts/neural_router.py",
    "rule": "Use the dynamic router only when the request explicitly establishes multiple dependent decision boundaries; use Council when ownership is ambiguous."
  },
  "host_targets": [
    "ChatGPT",
    "Codex",
    "Claude Code",
    "generic Agent Skills hosts"
  ],
  "eval_files": [
    "evals/activation.yml",
    "evals/behavior.yml",
    "evals/pressure.yml",
    "evals/regression.yml"
  ]
}