@sellable/mcp 0.1.269 → 0.1.272

package/skills/create-post/references/premise-development.md

@@ -1,16 +1,42 @@
-# Premise Development
+# Premise Development V2
 
 A strong post is not an idea with a better hook. A strong post is a valuable
 premise wrapped in a sharp opening.
 
-Use this stage after market/hook research and before hook candidates. Do not
-generate hook candidates until at least one `Premise Card` exists.
+Use this stage after audience/hook research and before hook candidates. V2 premise
+development also consumes the source post templates from hook research:
+post positioning breakdowns, viral-post outlines, hook-to-body promise maps, and
+body expression inputs.
+
+Do not generate hook candidates until at least one `Premise Card` exists and at
+least one source template has either been selected or explicitly rejected as a
+poor fit.
 
 ## Goal
 
 Turn the raw idea into a real story, observed tension, or useful argument that a
 specific reader would care about.
 
+Use this post tension framework when evaluating whether the premise can hold
+attention:
+
+```text
+Belief -> Contradiction -> Stakes -> Proof -> Mechanism -> Reframe -> Useful Move
+```
+
+- `Belief`: what the reader already thinks or wants to be true
+- `Contradiction`: what the source story reveals that does not fit the belief
+- `Stakes`: what the reader loses if they keep believing the old version
+- `Proof`: the scene, number, repeated pattern, or concrete artifact that makes
+  the contradiction credible
+- `Mechanism`: why the thing actually works or fails
+- `Reframe`: the sharper way to see the problem after the mechanism is clear
+- `Useful Move`: what the reader can do, notice, stop doing, or test next
+
+A post feels "edge of seat" when the hook creates a contradiction the target
+reader cares about, the body delays the answer only while adding proof, and each
+beat either raises tension or repays tension. If a beat does neither, cut it.
+
 The premise must answer:
 
 - who this is for
@@ -22,6 +48,8 @@ The premise must answer:
 - why now
 - why this user can credibly say it
 - what proof is available and what proof is missing
+- which source template, if any, should shape the narrative
+- which positioning sequence the user's post should follow
 
 If the premise has no real scene, no tension, and no reader value, stop before
 drafting. Ask for the missing story or save only a `needs_revision` premise
@@ -33,10 +61,14 @@ Before writing premise cards, search the available source material:
 
 - raw idea text
 - voice memo or transcript if provided
+- `Transcript Worldview Packet` from create-post capture
 - `core/story-bank.md`
 - `core/answer-bank.md`
 - `core/proof-ledger.md`
 - `core/wins-ledger.md`
+- `core/transcripts/INDEX.md`
+- `core/content-memory/INDEX.md`, relevant clusters, cards, questions, and
+  post seeds
 - approved references and gold standards
 - current-session user corrections or rejections
 
@@ -48,11 +80,37 @@ Look for:
 - a before/after: what changed in the user's belief
 - a specific object: Slack note, customer call, campaign table, reply, list,
   demo, failed draft, stale idea, messy workflow
+- repeated worldview: the user's recurring operating belief behind the idea
+- hot-take ingredient: the specific advice, default behavior, or market cliche
+  the user is pushing against
 
 If no real story is present, use an observed pattern only if it is traceable to
 the raw source or memory. Mark the gap in the premise card. Do not fabricate a
 customer, call, outcome, date, metric, or private scene.
 
+## Worldview And Hot-Take Extraction
+
+Before scoring premise cards, extract the user's source-backed worldview from
+the transcript packet:
+
+```text
+Worldview extraction:
+- worldview claim:
+- source transcript/cluster/card:
+- repeated phrase or language pattern:
+- lived proof behind it:
+- common advice it challenges:
+- hot take version:
+- public-safe version:
+- private/sensitive material to avoid:
+- confidence: strong | medium | weak
+```
+
+A good hot take is not just a contrarian sentence. It must trace to something
+the user has said, seen, shipped, sold, or learned repeatedly. If the hot take
+only exists because an outside creator framed it well, mark it as borrowed and
+do not use it as the user's premise.
+
 ## Premise Cards
 
 Generate 3-5 premise cards before hooks. Each card must use this shape:
@@ -81,7 +139,7 @@ tension:
 reader value:
 <what the reader learns, sees differently, or can do after reading>
 
-why now / market heat:
+why now / audience tension:
 <what current research says is resonating>
 
 credible why-us:
@@ -93,14 +151,32 @@ proof available:
 proof missing:
 <claims that cannot be made yet>
 
+worldview source:
+<transcript/cluster/card/source-backed belief used>
+
+hot take:
+<public-safe sharp version of the user's source-backed disagreement>
+
 best frame:
 story | contrarian take | teardown | founder confession | future thesis | lesson
 
+source template fit:
+<selected source template name or none>
+
+positioning sequence to test:
+<Category -> Category -> Category -> ...>
+
+viral outline to adapt:
+<beat names from selected source template, rewritten for this user's story>
+
 hook territories:
 - <territory 1>
 - <territory 2>
 - <territory 3>
 
+body expression inputs:
+- <line shape, proof slot, story beat, mechanism explanation, or closing move>
+
 risk:
 <why this premise might still be weak>
 
@@ -108,6 +184,214 @@ score:
 <1-100 with short reason>
 ```
 
+## Template-Aware Premise Selection
+
+Do not treat source templates as decoration. A source template is useful only
+when its narrative engine matches something the user can credibly say.
+
+For each premise card, compare it against the selected keeper templates from
+hook research:
+
+```text
+Template fit check:
+premise:
+source_template:
+template narrative engine:
+matching user story/proof:
+missing user story/proof:
+positioning sequence fit:
+hook promise fit:
+body payoff fit:
+voice fit:
+borrow:
+do not borrow:
+fit verdict: strong | partial | weak | reject
+```
+
+Reject a template when it depends on source-specific proof, celebrity reach,
+personal context the user does not have, or a body structure that would force a
+fake story. Prefer a less viral template that fits the user's real proof over a
+more viral template that requires borrowed authority.
+
+## Viral Narrative Structure
+
+Once a premise and source template are selected, create the user's viral-post
+outline before writing body prose.
+
+Use this format:
+
+```text
+User viral-post outline:
+selected_premise:
+selected_source_template:
+hook_promise:
+see_more_tension:
+body_payoff:
+positioning_sequence:
+  <Category> -> <Category> -> <Category> -> ...
+
+beats:
+1.
+  beat_name:
+  narrative_job:
+  user_story_or_proof:
+  positioning_categories:
+  reader_state_before:
+  reader_state_after:
+  line_shape_to_test:
+  proof_safety:
+```
+
+The outline should preserve the source template's useful narrative jobs while
+replacing all source-specific proof, scenes, status, jokes, and examples with
+the user's material.
+
+## Body Expression Lab
+
+After the selected hook and viral-post outline exist, generate body expression
+candidates before writing the final draft. This is where the system tests
+different ways to express the same structure.
+
+Generate 5-8 body expression candidates. Every candidate must use:
+
+- the same selected hook or hook territory
+- the same selected premise
+- the same viral-post outline
+- the same positioning sequence
+- only user-sourced story and proof
+
+Each candidate should vary the expression, not the facts:
+
+```text
+Body expression candidate:
+name:
+expression_strategy:
+opening_after_hook:
+beat_lines:
+  1. <line or paragraph>
+  2. <line or paragraph>
+positioning_sequence_coverage:
+hook_promise_repaid:
+best_lines:
+weak_lines:
+proof_risk:
+voice_risk:
+score:
+```
+
+Useful expression strategies:
+
+- plain field guide
+- founder confession
+- proof-first roadmap
+- teardown then replacement
+- scene then lesson
+- enemy naming then mechanism
+- compact build-in-public note
+
+Do not create candidates by changing the claim. Create candidates by changing
+line order, amount of scene, proof placement, rhythm, and how the mechanism is
+explained.
+
+## Combine Pass
+
+After body expression candidates are scored, combine the best parts into one
+draft outline before prose.
+
+Record:
+
+```text
+Combined body plan:
+selected_hook:
+selected_expression_parts:
+lines_kept:
+lines_rewritten:
+lines_cut:
+positioning_sequence_final:
+hook_promise_repayment:
+proof_gaps_remaining:
+why_this_combination_wins:
+```
+
+If no candidate repays the hook promise with real user proof, return to premise
+development or ask the user for the missing story. Do not save a `ready` draft.
+
+## Pre-Draft Narrative Outline
+
+Before final prose, produce a compact `Pre-Draft Narrative Outline`. This is the
+user-visible argument skeleton that lets the user confirm what the post is
+trying to say, in what order, and which proven body shapes are being adapted
+before the system writes body copy.
+
+Use this format:
+
+```text
+Pre-Draft Narrative Outline
+I. Hook and click debt
+   A. Selected hook: <selected hook>
+   B. Rendered mobile preview verdict: <pass | warn | fail + why>
+   C. What "see more" must repay: <the open loop the first body beat must answer>
+
+II. Thesis the post will defend
+   A. One-sentence thesis: <the post's operating claim>
+   B. Reader being taught: <specific audience, not a broad persona>
+   C. Why this reader cares now: <timely pain, belief, or decision>
+
+III. Operating model
+   A. Core equation or mechanism: <the model the post teaches>
+   B. Key definitions:
+      i. <term>: <plain definition + concrete examples>
+      ii. <term>: <plain definition + concrete examples>
+
+IV. Body shape borrowed from posts that worked
+   A. Selected source template or no-template rationale: <source or rationale>
+   B. Source-message outline being adapted:
+      i. <source post + P1/P2/P3 branch sequence from the original message>
+      ii. <which original paragraph/line/phrase jobs matter most>
+   C. Working body pattern(s) being adapted:
+      i. <pattern name>: <beat order and why it works>
+      ii. <pattern name>: <beat order and why it works>
+   D. What gets borrowed:
+      i. <narrative job, sequence, transition, or proof order>
+   E. What must not be copied:
+      i. <source wording, creator-specific proof, joke, or context>
+
+V. Narrative beats
+   A. Beat 1: <job, reader state before/after, example/proof>
+      i. Line shape or section label: <how it will appear>
+      ii. Concrete examples: <examples/numbers>
+   B. Beat 2: <job, reader state before/after, example/proof>
+      i. Line shape or section label: <how it will appear>
+      ii. Concrete examples: <examples/numbers>
+   C. Beat 3: <job, reader state before/after, example/proof>
+      i. Line shape or section label: <how it will appear>
+      ii. Concrete examples: <examples/numbers>
+
+VI. Scan path and proof safety
+   A. Mobile scan path: <what skimmers learn from labels/numbers/close>
+   B. Proof claims:
+      i. <claim>: <source + public-safety status>
+   C. Abstractions to remove:
+      i. <abstract phrase> -> <concrete replacement>
+   D. Draft risks: <risk and how to avoid it>
+```
+
+Quality gate:
+
+- The outline must explain the post before the draft exists.
+- The outline must be useful to a reader who only scans the finished post.
+- The outline must include proof claims and risk before prose.
+- The outline must define any operating terms that could be misunderstood.
+- The outline must use `I.`, `A.`, and `i.` hierarchy. A flat field list fails.
+- If the post is adapting bodies that worked, the outline must name the source
+  message outline being adapted and the body pattern, including which original
+  paragraph/line/phrase jobs transfer and what beat order, proof order, or
+  transition logic is being borrowed.
+- If the post is a field guide, the narrative beats must show the hierarchy
+  before prose, such as best-to-worst, highest-to-lowest intent, or
+  source-to-outcome.
+- If the outline cannot be made concrete, return to premise development.
+
 ## Premise Quality Gate
 
 A premise can move to hook generation only when it passes all of these:
@@ -118,7 +402,10 @@ A premise can move to hook generation only when it passes all of these:
 - `reader_value`: pass
 - `credible_speaker`: pass
 - `proof_safety`: pass
-- `market_heat`: pass or explained
+- `audience_tension`: pass or explained
+- `template_fit`: pass or explicitly no-template
+- `hook_to_body_repayment`: pass
+- `pre_draft_narrative_outline`: pass
 
 If any gate fails:
 
@@ -137,8 +424,11 @@ For each hook candidate, include:
 - which tension it opens
 - which reader value it implies
 - whether the real scene appears in the first screen or shortly after
+- source template or no-template rationale
+- hook promise the body must repay
 
 Reject hooks that are accurate but do not reveal the premise's tension or value.
+Reject hooks that create a promise the selected viral-post outline cannot repay.
 
 ## Body Relationship
 
@@ -155,5 +445,6 @@ body outline:
 7. close returns to the premise without summarizing
 ```
 
-If this outline cannot be filled without inventing proof, return to premise
-development.
+Replace this generic outline with the selected viral-post outline when a source
+template is available. If the outline cannot be filled without inventing proof,
+return to premise development.

package/skills/providers/prospeo.md

@@ -9,31 +9,10 @@ Prospeo supports search + import in the campaign builder flow.
 ## Provider Decision Tree
 
 - Known account list or CSV: use `load_csv_domains` or `save_domain_filters`, then `search_prospeo`.
-- Current LinkedIn job-post intent: use `search_harvest_jobs`, review the job artifact, then use `confirm_harvest_job_companies` with selected Harvest job IDs to create a `domainFilterId`; only then call `search_prospeo` for hiring stakeholders at those companies. Harvest jobs are the account source, not a people-search replacement.
 - Company/account lookalikes: use `search_prospeo_companies`, review the account sample, then use `confirm_prospeo_company_accounts` with the returned `companySearchToken` to create a `domainFilterId`; only then call `search_prospeo` for people at those accounts. Account rows are not people leads yet.
 - Person search with known filters: use `search_prospeo` directly.
 - LinkedIn activity, content-source, or post-engagement intent: stay on Signal Discovery or Sales Nav, not Prospeo.
 
-Current LinkedIn job-post account sourcing must follow:
-
-```text
-search_harvest_jobs -> confirm_harvest_job_companies -> search_prospeo
-```
-
-Use `search_harvest_jobs` when the user's account-source intent is current
-LinkedIn job posts, for example "companies hiring Power BI developers in the US
-this month." The search tool writes review artifacts and returns a token or
-`mcp-harvest-job-search-token:*` reference. After reviewing selected jobs, call
-`confirm_harvest_job_companies` with selected Harvest job IDs only. It resolves
-real company website domains from selected job details and bounded
-`/linkedin/company` fallback, then returns a `domainFilterId` for
-`search_prospeo`.
-
-Do not paste LinkedIn company URLs as domains. Do not detail-fetch every job row
-by default; fetch details only for selected batches during confirmation. Use
-Prospeo directly when the user wants broader volume, company attributes,
-lookalikes, or people search without needing current LinkedIn job evidence.
-
 Company/account lookalikes must follow:
 
 ```text

package/skills/research/config.json

@@ -0,0 +1,9 @@
+{
+  "parallelMode": "wide",
+  "agentCount": 6,
+  "maxToolCallsPerAgent": 2,
+  "senderMaxAgents": 2,
+  "senderMaxToolCallsPerAgent": 3,
+  "progressMode": true,
+  "debugMode": true
+}

package/dist/tools/harvest-jobs.d.ts

@@ -1,182 +0,0 @@
-type ArtifactFormat = "markdown" | "csv" | "both";
-export interface SearchHarvestJobsInput {
-    search?: string;
-    searches?: string[];
-    location?: string;
-    geoId?: string;
-    postedLimit?: "24h" | "week" | "month";
-    sortBy?: "relevance" | "date";
-    workplaceType?: string | string[];
-    employmentType?: string | string[];
-    experienceLevel?: string | string[];
-    easyApply?: boolean;
-    under10Applicants?: boolean;
-    salary?: string;
-    pages?: number;
-    maxRows?: number;
-    artifactFormat?: ArtifactFormat;
-    outputDir?: string;
-    fileBaseName?: string;
-}
-export interface ConfirmHarvestJobCompaniesInput {
-    searchToken?: string;
-    selectedJobIds?: string[];
-    name?: string;
-    outputDir?: string;
-    fileBaseName?: string;
-    [key: string]: unknown;
-}
-export declare const harvestJobToolDefinitions: ({
-    name: string;
-    description: string;
-    inputSchema: {
-        type: string;
-        properties: {
-            search: {
-                type: string;
-            };
-            searches: {
-                type: string;
-                items: {
-                    type: string;
-                };
-            };
-            location: {
-                type: string;
-            };
-            geoId: {
-                type: string;
-            };
-            postedLimit: {
-                type: string;
-                enum: string[];
-            };
-            sortBy: {
-                type: string;
-                enum: string[];
-            };
-            workplaceType: {
-                oneOf: ({
-                    type: string;
-                    items?: undefined;
-                } | {
-                    type: string;
-                    items: {
-                        type: string;
-                    };
-                })[];
-            };
-            employmentType: {
-                oneOf: ({
-                    type: string;
-                    items?: undefined;
-                } | {
-                    type: string;
-                    items: {
-                        type: string;
-                    };
-                })[];
-            };
-            experienceLevel: {
-                oneOf: ({
-                    type: string;
-                    items?: undefined;
-                } | {
-                    type: string;
-                    items: {
-                        type: string;
-                    };
-                })[];
-            };
-            easyApply: {
-                type: string;
-            };
-            under10Applicants: {
-                type: string;
-            };
-            salary: {
-                type: string;
-            };
-            pages: {
-                type: string;
-                description: string;
-            };
-            maxRows: {
-                type: string;
-                description: string;
-            };
-            artifactFormat: {
-                type: string;
-                enum: string[];
-                description: string;
-            };
-            outputDir: {
-                type: string;
-                description: string;
-            };
-            fileBaseName: {
-                type: string;
-                description: string;
-            };
-            searchToken?: undefined;
-            selectedJobIds?: undefined;
-            name?: undefined;
-        };
-        required: never[];
-        additionalProperties: boolean;
-    };
-} | {
-    name: string;
-    description: string;
-    inputSchema: {
-        type: string;
-        properties: {
-            searchToken: {
-                type: string;
-                description: string;
-            };
-            selectedJobIds: {
-                type: string;
-                items: {
-                    type: string;
-                };
-                description: string;
-            };
-            name: {
-                type: string;
-            };
-            outputDir: {
-                type: string;
-                description: string;
-            };
-            fileBaseName: {
-                type: string;
-                description: string;
-            };
-            search?: undefined;
-            searches?: undefined;
-            location?: undefined;
-            geoId?: undefined;
-            postedLimit?: undefined;
-            sortBy?: undefined;
-            workplaceType?: undefined;
-            employmentType?: undefined;
-            experienceLevel?: undefined;
-            easyApply?: undefined;
-            under10Applicants?: undefined;
-            salary?: undefined;
-            pages?: undefined;
-            maxRows?: undefined;
-            artifactFormat?: undefined;
-        };
-        required: string[];
-        additionalProperties: boolean;
-    };
-})[];
-export declare function searchHarvestJobs(input: SearchHarvestJobsInput): Promise<{
-    [k: string]: unknown;
-}>;
-export declare function confirmHarvestJobCompanies(input: ConfirmHarvestJobCompaniesInput): Promise<{
-    [k: string]: unknown;
-}>;
-export {};