taketomarket 0.1.0

package/templates/reference-files/icp.md

@@ -0,0 +1,50 @@
+<!-- _SUMMARY: Tier 1 context (loaded universally, <200 words) -->
+## Summary
+**Primary segment:** [GENERATED BY /ttm-init]
+**JTBD:** [GENERATED BY /ttm-init]
+**Top 3 pains:**
+- [GENERATED BY /ttm-init]
+- [GENERATED BY /ttm-init]
+- [GENERATED BY /ttm-init]
+**Anti-ICP:** [GENERATED BY /ttm-init]
+<!-- END_SUMMARY -->
+
+## Primary Segment
+
+### Demographics
+[GENERATED BY /ttm-init -- Role, company size, industry, geography]
+
+### Psychographics
+[GENERATED BY /ttm-init -- Motivations, fears, aspirations, values]
+
+## Jobs-to-Be-Done
+
+| Job | Priority | Current Solution |
+|-----|----------|-----------------|
+| [GENERATED BY /ttm-init] | [high/medium/low] | [what they use today] |
+
+## Pains and Triggers
+
+### Pain Points
+| Pain | Severity | Frequency |
+|------|----------|-----------|
+| [GENERATED BY /ttm-init] | [high/medium/low] | [daily/weekly/monthly] |
+
+### Buying Triggers
+[GENERATED BY /ttm-init -- Events that trigger purchase consideration]
+
+## Anti-ICP Profile
+
+[GENERATED BY /ttm-init -- Who we explicitly do NOT target and why]
+
+| Characteristic | Why Excluded |
+|---------------|-------------|
+| [GENERATED BY /ttm-init] | [GENERATED BY /ttm-init] |
+
+## Customer Language Library
+
+[GENERATED BY /ttm-init -- Exact phrases customers use to describe their problems]
+
+| Context | Phrase | Source |
+|---------|--------|--------|
+| [GENERATED BY /ttm-init] | [exact quote] | [interview/review/support ticket] |

package/templates/reference-files/learnings.md

@@ -0,0 +1,40 @@
+<!-- _SUMMARY: Tier 1 context (loaded universally, <200 words) -->
+## Summary
+**Total lessons:** [GENERATED BY /ttm-init -- starts at 0]
+**Last lesson date:** [GENERATED BY /ttm-init -- none until first Learn phase]
+**Top pattern:** [GENERATED BY /ttm-init -- none until enough data]
+<!-- END_SUMMARY -->
+
+## Root-Cause Taxonomy
+
+Every lesson is categorized into one of these root causes:
+
+| Category | Description | Example |
+|----------|-------------|---------|
+| positioning-drift | Asset deviated from POSITIONING.md | "Used competitor's language instead of ours" |
+| weak-hook | Opening failed to capture attention | "Blog intro was generic, no specific pain addressed" |
+| wrong-channel | Content published on ineffective channel | "Technical deep-dive posted on Instagram" |
+| bad-timing | Published at wrong time or wrong cadence | "Product launch email sent during holiday weekend" |
+| unverifiable-claim | Claim lacked proof point or source | "Said 'industry-leading' with no data backing" |
+| broken-funnel | CTA or conversion path was broken | "Landing page linked to wrong signup form" |
+| creative-fatigue | Repeated format/angle with diminishing returns | "Fifth 'how-to' post in a row, engagement dropped 40%" |
+
+## Lessons Log
+
+| Date | Campaign | Category | Lesson | Action Taken |
+|------|----------|----------|--------|-------------|
+<!-- LESSONS BELOW THIS LINE -->
+
+## Pattern Extraction
+
+### Winning Hooks
+[Populated after 3+ campaigns -- patterns in high-performing openings]
+
+### Winning Angles
+[Populated after 3+ campaigns -- recurring themes that resonate]
+
+### Winning Formats
+[Populated after 3+ campaigns -- content formats with best ROI]
+
+### Anti-Patterns
+[Populated after 3+ campaigns -- approaches that consistently underperform]

package/templates/reference-files/metrics.md

@@ -0,0 +1,42 @@
+<!-- _SUMMARY: Tier 1 context (loaded universally, <200 words) -->
+## Summary
+**Primary outcome metric:** [GENERATED BY /ttm-init]
+**Secondary metrics:** [GENERATED BY /ttm-init]
+**Attribution model:** [GENERATED BY /ttm-init]
+<!-- END_SUMMARY -->
+
+## Primary Outcome Metric
+
+**Metric:** [GENERATED BY /ttm-init]
+**Target:** [GENERATED BY /ttm-init]
+**Measurement window:** [GENERATED BY /ttm-init]
+**Data source:** [GENERATED BY /ttm-init]
+
+## Secondary Metrics
+
+| Metric | Target | Window | Source |
+|--------|--------|--------|--------|
+| [GENERATED BY /ttm-init] | [target] | [window] | [source] |
+
+## Leading Indicators
+
+| Indicator | Correlation | Lag Time | Threshold |
+|-----------|------------|----------|-----------|
+| [GENERATED BY /ttm-init] | [strong/moderate/weak] | [days] | [alert threshold] |
+
+## Baselines
+
+| Metric | Current Value | Date Measured | Source |
+|--------|--------------|---------------|--------|
+| [GENERATED BY /ttm-init] | [value] | [date] | [source] |
+
+## Attribution Model Configuration
+
+**Model type:** [GENERATED BY /ttm-init -- first-touch/last-touch/multi-touch/custom]
+
+### Rules
+[GENERATED BY /ttm-init -- How credit is assigned across touchpoints]
+
+| Touchpoint | Weight | Notes |
+|-----------|--------|-------|
+| [GENERATED BY /ttm-init] | [%] | [reasoning] |

package/templates/reference-files/positioning.md

@@ -0,0 +1,38 @@
+<!-- _SUMMARY: Tier 1 context (loaded universally, <200 words) -->
+## Summary
+**Category:** [GENERATED BY /ttm-init]
+**Target audience:** [GENERATED BY /ttm-init]
+**Primary differentiator:** [GENERATED BY /ttm-init]
+**Proof points:**
+- [GENERATED BY /ttm-init]
+- [GENERATED BY /ttm-init]
+- [GENERATED BY /ttm-init]
+**Must-not-say:** [GENERATED BY /ttm-init]
+<!-- END_SUMMARY -->
+
+## Detailed Positioning
+
+### Category Definition
+[GENERATED BY /ttm-init -- Full category analysis with market context]
+
+### Competitive Frame
+[GENERATED BY /ttm-init -- How we position against alternatives]
+
+### Proof Point Library
+[GENERATED BY /ttm-init -- Complete proof points with sources and expiry dates]
+
+| Proof Point | Source | Verified Date | Expiry |
+|-------------|--------|---------------|--------|
+| [GENERATED BY /ttm-init] | [source] | [date] | [date] |
+
+### Must-Not-Say Terms
+[GENERATED BY /ttm-init -- Banned terms with reasoning for each]
+
+| Term | Reasoning |
+|------|-----------|
+| [GENERATED BY /ttm-init] | [GENERATED BY /ttm-init] |
+
+### Positioning History
+| Date | Change | Reasoning |
+|------|--------|-----------|
+| [init date] | Initial positioning | Created via /ttm-init |

package/templates/reference-files/state.md

@@ -0,0 +1,27 @@
+---
+status: initialized
+current_phase: none
+current_campaign: none
+last_updated: [GENERATED BY /ttm-init]
+campaigns: []
+---
+
+## Active Campaigns
+
+No active campaigns. Use `/ttm-new-campaign` to create one.
+
+## Decisions in Flight
+
+No pending decisions.
+
+## Blockers
+
+No current blockers.
+
+## Experiments
+
+No active experiments.
+
+## Recent Lessons
+
+No lessons recorded yet. Lessons are captured automatically during the Learn phase of each campaign.

package/templates/verification-report.md

@@ -0,0 +1,59 @@
+---
+campaign: [SLUG]
+run_number: [RUN_NUMBER]
+date: [ISO_DATE]
+total_assets: [TOTAL_ASSETS]
+overall_result: [pass|warn|fail]
+---
+
+# Verification Report: [SLUG]
+
+**Run:** [RUN_NUMBER] | **Date:** [ISO_DATE] | **Assets:** [TOTAL_ASSETS]
+
+## Summary
+
+| # | Gate | Tier | [ASSET_COLUMNS] |
+|---|------|------|-----------------|
+| 1 | Positioning Drift (GATE-01) | T1 | [RESULTS] |
+| 2 | Claim Accuracy (GATE-02) | T1 | [RESULTS] |
+| 3 | Voice Drift (GATE-03) | T2 | [RESULTS] |
+| 4 | Outcome Alignment (GATE-04) | T1 | [RESULTS] |
+| 5 | Funnel Integrity (GATE-05) | T2 | [RESULTS] |
+| 6 | UTM Hygiene (GATE-06) | T2 | [RESULTS] |
+| 7 | Compliance (GATE-07) | T2 | [RESULTS] |
+| 8 | Competitor Collision (GATE-08) | T2 | [RESULTS] |
+| 9 | ICP Fit (GATE-09) | T2 | [RESULTS] |
+| 10 | Format Correctness (GATE-10) | T2 | [RESULTS] |
+
+**Result:** [FAIL_COUNT] FAIL (Tier 1), [WARN_COUNT] WARN -- [ACTION_SUMMARY]
+
+---
+
+## Detail Findings
+
+### [ASSET_NAME] -- [GATE_NAME] ([RESULT])
+
+**Line [LINE_NUMBER]:** "[EXACT_TEXT_FROM_ASSET]"
+
+**Issue:** [DESCRIPTION_OF_WHAT_TRIGGERED_THE_FINDING]
+
+**Reference:** [QUOTE_FROM_REFERENCE_FILE_BEING_CHECKED_AGAINST]
+
+**Recommendation:** [SPECIFIC_CHANGE_TO_RESOLVE_THE_FINDING]
+
+**Action required:**
+1. **Correct** -- rewrite the flagged section to resolve the finding
+2. **Accept+log** -- document exception in DEVIATIONS.md and proceed
+3. **Escalate** -- trigger /ttm-positioning-shift to update positioning
+
+---
+
+<!-- Repeat the detail finding block above for each WARN or FAIL finding.
+     PASS results do not need detail entries. -->
+
+## Run Metadata
+
+- **Verify command:** `/ttm-verify [SLUG]`
+- **Manifest:** `.marketing/CAMPAIGNS/[SLUG]/MANIFEST.json`
+- **Gate definitions:** `gates/base-gates.md`
+- **Previous runs:** [PREVIOUS_RUN_COUNT]

package/workflows/discipline/aeo-check.md

@@ -0,0 +1,180 @@
+<purpose>
+Check AI citation status and citability score for content against a target query.
+Evaluates whether content is structured for AI engine extraction and citation using
+AEO playbook gate definitions. Optionally checks live citation status via web search.
+Single-pass analysis workflow per D-07.
+</purpose>
+
+<required_reading>
+@${CLAUDE_PLUGIN_ROOT}/references/context-loading.md
+@${CLAUDE_PLUGIN_ROOT}/playbooks/aeo.md
+</required_reading>
+
+<constraints>
+## POSITIONING.md is READ-ONLY
+
+**Do NOT modify `.marketing/POSITIONING.md` during this workflow.**
+
+POSITIONING.md is an architectural invariant. If you detect positioning drift:
+- Flag the issue and recommend running /ttm-positioning-check
+
+Only /ttm-positioning-shift and /ttm-init may modify POSITIONING.md.
+</constraints>
+
+<process>
+
+## Text-Mode Detection
+
+**Text mode (`--text` flag):** Set `TEXT_MODE=true` if `--text` is present in `$ARGUMENTS`
+or if the runtime is not Claude Code. When TEXT_MODE is active, replace every
+`AskUserQuestion` call with a plain-text numbered list.
+
+Detection:
+```bash
+if echo "$ARGUMENTS" | grep -q -- '--text'; then TEXT_MODE=true; fi
+```
+
+If `AskUserQuestion` tool is not available in the current runtime, set `TEXT_MODE=true`.
+
+---
+
+## Step 1: Load Context
+
+```
+takeToMarket > LOADING CONTEXT FOR AEO CHECK
+```
+
+**Tier 1 summaries** (lines 1 to `<!-- END_SUMMARY -->`) from all 9 `.marketing/` reference files.
+**Tier 2 (full):** `.marketing/POSITIONING.md` (differentiator alignment check).
+**Playbook gates:** @${CLAUDE_PLUGIN_ROOT}/playbooks/aeo.md
+
+If `.marketing/POSITIONING.md` does not exist: Error and exit.
+
+---
+
+## Step 2: Get Target Query and Content
+
+Ask the user:
+1. "What query do you want to check AI citation status for?"
+2. "Paste the content you want evaluated (URL, file path, or raw content)."
+
+Store query as `TARGET_QUERY`. Parse content input:
+- **URL:** Attempt WebFetch. If unavailable (SEARCH_MODE=manual), ask user to paste.
+- **File path:** Read directly.
+- **Pasted content:** Use directly.
+
+Store as `CHECK_CONTENT`.
+
+---
+
+## Step 3: Evaluate Citability (AEO Gates)
+
+```
+takeToMarket > EVALUATING CITABILITY
+```
+
+Evaluate `CHECK_CONTENT` against 6 AEO discipline gates:
+
+**1. Quote-Worthy Sentences (DISC-AEO-01)**
+- PASS: 3+ sentences quotable verbatim as standalone answers
+- WARN: 1-2 quotable sentences
+- FAIL: 0 quotable sentences -- all require surrounding context
+
+**2. FAQ/HowTo Schema (DISC-AEO-02)**
+- PASS: FAQPage or HowTo schema with complete Q&A pairs or steps
+- WARN: Schema present but incomplete (missing answers, <3 pairs)
+- FAIL: No FAQ/HowTo schema on content with Q&A or instructions
+
+**3. Author/Expert Markup (DISC-AEO-03)**
+- PASS: Author name, credentials, expertise; references specific experience
+- WARN: Author name present but no credentials
+- FAIL: No author attribution
+
+**4. Cross-Domain Fact Consistency (DISC-AEO-04)**
+- PASS: All numeric and positioning claims consistent and verifiable
+- WARN: Minor phrasing differences that could be misinterpreted
+- FAIL: Direct contradictions in claims
+
+**5. Direct Answer Formatting (DISC-AEO-05)**
+- PASS: Each H2 opens with 1-2 sentence definitive answer before elaboration
+- WARN: Most sections open directly but 1-2 start with context first
+- FAIL: Sections consistently open with preamble instead of answers
+
+**6. Entity Authority**
+- PASS: References authoritative entities, domain terminology, linked concepts
+- WARN: Some entity coverage but surface-level
+- FAIL: Generic content with no entity depth
+
+Per check: assign PASS / WARN / FAIL with specific evidence.
+
+---
+
+## Step 4: Citation Status (if WebSearch available)
+
+Attempt WebSearch to detect tool availability.
+
+### SEARCH_MODE=web
+```
+takeToMarket > CHECKING LIVE CITATION STATUS
+```
+Search `TARGET_QUERY` conversationally. Analyze: Is content being cited? Which competitors cited? What format do AI engines prefer?
+
+### SEARCH_MODE=manual
+```
+takeToMarket > SEARCH MODE: MANUAL -- SKIPPING LIVE CITATION CHECK
+```
+Skip live check. Tell user to manually search in ChatGPT, Perplexity, Gemini, Copilot.
+
+---
+
+## Step 5: Generate Report
+
+Citability score: (PASS count / 6) * 100, rounded.
+
+```
+========================================
+takeToMarket > AEO CITABILITY REPORT
+========================================
+Query: "${TARGET_QUERY}"
+Content: [URL, filename, or "pasted content"]
+Date: [current date]
+Citability Score: [score]% ([X/6 PASS] [Y/6 WARN] [Z/6 FAIL])
+
+| # | Gate                    | Result | Evidence              |
+|---|-------------------------|--------|-----------------------|
+| 1 | Quote-Worthy Sentences  | [P/W/F] | [brief evidence]     |
+| 2 | FAQ/HowTo Schema        | [P/W/F] | [brief evidence]     |
+| 3 | Author/Expert Markup    | [P/W/F] | [brief evidence]     |
+| 4 | Fact Consistency        | [P/W/F] | [brief evidence]     |
+| 5 | Direct Answer Format    | [P/W/F] | [brief evidence]     |
+| 6 | Entity Authority        | [P/W/F] | [brief evidence]     |
+
+[If SEARCH_MODE=web:]
+CITATION STATUS:
+- Currently cited: [yes/no/partial]
+- Competing citations: [competitors being cited]
+- Preferred format: [format AI engines favor]
+
+FINDINGS (WARN/FAIL details):
+- [Gate]: [Issue and recommendation]
+
+RECOMMENDATIONS (priority-ordered):
+1. [Highest-impact citability improvement]
+2. [Next priority]
+```
+
+---
+
+## Step 6: Completion
+
+```
+========================================
+takeToMarket > AEO CHECK COMPLETE
+========================================
+Query: ${TARGET_QUERY} | Citability Score: [score]%
+```
+
+Offer: "Save this report to .marketing/AUDITS/aeo-check-[date].md? (yes/no)"
+If yes: create `.marketing/AUDITS/` directory if needed and write the report.
+
+</process>

package/workflows/discipline/affiliate-kit.md

@@ -0,0 +1,147 @@
+<purpose>
+Generate a creative kit for affiliate partners including approved messaging, banner specs,
+email swipes, and tracking requirements. Uses affiliate playbook constraints for quality.
+Single-pass analysis workflow per D-07.
+</purpose>
+
+<required_reading>
+@${CLAUDE_PLUGIN_ROOT}/references/context-loading.md
+@${CLAUDE_PLUGIN_ROOT}/playbooks/affiliate.md
+</required_reading>
+
+<constraints>
+## POSITIONING.md is READ-ONLY
+
+**Do NOT modify `.marketing/POSITIONING.md` during this workflow.**
+
+POSITIONING.md is an architectural invariant. If you detect positioning drift:
+- Flag the issue and recommend running /ttm-positioning-check
+
+Only /ttm-positioning-shift and /ttm-init may modify POSITIONING.md.
+</constraints>
+
+<process>
+
+## Text-Mode Detection
+
+**Text mode (`--text` flag):** Set `TEXT_MODE=true` if `--text` is present in `$ARGUMENTS`
+or if the runtime is not Claude Code. When TEXT_MODE is active, replace every
+`AskUserQuestion` call with a plain-text numbered list.
+
+Detection:
+```bash
+if echo "$ARGUMENTS" | grep -q -- '--text'; then TEXT_MODE=true; fi
+```
+
+If `AskUserQuestion` tool is not available in the current runtime, set `TEXT_MODE=true`.
+
+---
+
+## Step 1: Load Context
+
+```
+takeToMarket > LOADING CONTEXT FOR AFFILIATE KIT
+```
+
+**Tier 1 summaries** (lines 1 to `<!-- END_SUMMARY -->`) from all 9 `.marketing/` reference files.
+**Tier 2 (full):** `.marketing/POSITIONING.md`, `.marketing/BRAND.md`, `.marketing/ICP.md`, `.marketing/METRICS.md`
+**Playbook gates:** @${CLAUDE_PLUGIN_ROOT}/playbooks/affiliate.md
+
+If `.marketing/POSITIONING.md` does not exist: Error and exit.
+
+---
+
+## Step 2: Gather Kit Parameters
+
+Ask the user:
+1. "What product/offer is this affiliate kit for?"
+2. "Commission structure? (percentage, flat fee, tiered)"
+3. "Cookie/attribution window? (e.g., 30 days, 90 days)"
+4. "Landing page URL for affiliates to link to?"
+5. "Target affiliate types? (content creators, email marketers, comparison sites, coupon sites)"
+
+Store responses as `PRODUCT_NAME`, `COMMISSION`, `COOKIE_WINDOW`, `LANDING_URL`, `AFFILIATE_TYPES`.
+
+---
+
+## Step 3: Generate Creative Kit
+
+```
+takeToMarket > GENERATING AFFILIATE CREATIVE KIT
+```
+
+Produce a complete kit with these sections:
+
+### Approved Messaging
+- 3 headline variations aligned with POSITIONING.md differentiator
+- 3 description variations using BRAND.md voice
+- Approved claims list from BRAND.md proof points only
+- Banned claims/language from BRAND.md banned words + POSITIONING.md must-not-say
+
+### Email Swipes
+- 3 email templates (short/medium/long) targeting ICP pain points
+- Subject line options per template (30-60 chars, no spam triggers per email playbook)
+- FTC affiliate disclosure included in each template
+
+### Banner Specs
+- Recommended sizes: 300x250, 728x90, 160x600 (per affiliate playbook format rules)
+- Brand color codes and logo usage from BRAND.md
+- Max 20% text area, visible CTA, product name
+
+### Tracking Requirements
+- UTM format: `utm_source=affiliate&utm_medium=[affiliate-name]&utm_campaign=[campaign-slug]`
+- Cookie window: ${COOKIE_WINDOW}
+- Attribution model from METRICS.md (first-touch or last-touch)
+- Commission structure: ${COMMISSION}
+- Payout terms (schedule, minimum threshold, payment method)
+
+### Compliance Rules
+- FTC disclosure template: "This post contains affiliate links. I may earn a commission if you make a purchase."
+- Prohibited promotion methods (spam, misleading claims, trademark bidding)
+- Brand usage guidelines from BRAND.md
+- No income or results guarantees
+
+---
+
+## Step 4: Write Kit File
+
+Generate a URL-safe slug from `PRODUCT_NAME`.
+Write to `.marketing/AFFILIATE-KIT-[product-slug].md`.
+
+Kit file structure:
+```markdown
+# Affiliate Creative Kit: [Product Name]
+Generated: [date]
+Commission: [structure]
+Cookie Window: [duration]
+
+## Approved Messaging
+[headlines, descriptions, claims, banned language]
+
+## Email Swipes
+[3 templates with subject lines]
+
+## Banner Specs
+[sizes, brand guidelines, requirements]
+
+## Tracking Requirements
+[UTM format, attribution, commission, payouts]
+
+## Compliance Rules
+[FTC disclosure, prohibited methods, brand guidelines]
+```
+
+---
+
+## Step 5: Completion
+
+```
+========================================
+takeToMarket > AFFILIATE KIT COMPLETE
+========================================
+Product: ${PRODUCT_NAME} | Sections: 5 | File: .marketing/AFFILIATE-KIT-[slug].md
+```
+
+Display summary of kit contents and confirm file location.
+
+</process>