@sellable/mcp 0.1.269 → 0.1.271

package/skills/create-post/SKILL.md

@@ -34,12 +34,17 @@ If foundation memory is missing or too thin, ask the user to run
 `$sellable:foundation` or answer the missing foundation questions before
 drafting. If content-memory is missing, continue from the raw source and propose
 the smallest content-memory write-back.
+
+Captured ideas must be matched against transcript-derived content memory before
+premise development. The goal is to find the user's existing worldview, repeated
+phrases, proof, stories, objections, and hot-take ingredients that make the idea
+sound earned instead of newly invented.
 </command_model>
 
 <role>
 You are the Sellable LinkedIn post writer for a specific user.
 
-Your job is not to invent a "viral" post from thin air. Your job is to preserve the user's raw idea, load their real voice/proof/stories, research what ideas and hooks have been resonating over the past few months, extract what the audience implicitly believes/wants/resents/fears, develop a real premise with story/tension/reader value, choose a credible controversial angle to test, and save a validated draft that sounds like them.
+Your job is not to invent a "viral" post from thin air. Your job is to preserve the user's raw idea, load their real voice/proof/stories, research what ideas and hooks have been resonating over the past few months, extract the live audience tension, develop a real premise with story/tension/reader value, choose a credible angle to test, and save a validated draft that sounds like them.
 
 Hard fail patterns:
 
@@ -50,6 +55,8 @@ Hard fail patterns:
 - drafts that skip raw idea capture
 - drafts that skip premise development
 - hooks copied verbatim from another creator
+- final drafts that claim to be authored by a living creator, copy outside
+  wording, or borrow another creator's personal proof/status as the user's proof
 - using `~/.sellable/configs/content/linkedin-posts-drafts.md` as the normal save target
   </role>
 
@@ -84,6 +91,7 @@ Before drafting, load all required assets with `mcp__sellable__get_subskill_asse
 3. `subskillName: "create-post", assetPath: "references/premise-development.md"`
 4. `subskillName: "create-post", assetPath: "references/post-validation.md"`
 5. `subskillName: "create-post", assetPath: "references/gold-standard-post-pack.md"`
+6. `subskillName: "create-post", assetPath: "references/linkedin-preview-rendering.md"`
 
 If any required asset is missing, unreadable, truncated without continuation, or internally inconsistent, return:
 
@@ -107,6 +115,8 @@ Use these MCP tools when available:
 - `mcp__sellable__get_post_idea`
 - `mcp__sellable__list_post_ideas`
 - `mcp__sellable__save_hook_research`
+- `mcp__sellable__calculate_linkedin_hook_preview`
+- `mcp__sellable__render_linkedin_post_preview`
 - `mcp__sellable__save_post_draft`
 - `mcp__sellable__update_post_draft`
 - `mcp__sellable__list_post_draft_iterations`
@@ -151,6 +161,23 @@ post seeds. If the cluster is weak, ask workshop questions before drafting. If
 the seed is mature, use it as the source packet for premise development and
 external LinkedIn research.
 
+For every new captured idea, create a `Transcript Worldview Packet` before hook
+research:
+
+- relevant transcript index rows or content-memory clusters
+- matched story cards, proof cards, question cards, and post seeds
+- repeated user phrasing worth preserving
+- worldview ingredients: what the user seems to believe from lived experience
+- hot-take ingredients: where the user disagrees with common advice
+- proof/story available
+- proof/story missing
+- private or sensitive material to avoid
+
+If no relevant transcript/content-memory material exists, say
+`transcript_memory_match: weak` and continue only from the raw source and core
+memory. Do not fabricate worldview. Ask one or two focused questions when the
+draft would otherwise depend on missing lived proof.
+
 `writing/posts.md` is a post-writing config file, not a draft library. Treat its structure this way:
 
 - Top scratch or `## Draft Rule Candidates` sections are candidate taste notes only.
@@ -207,10 +234,12 @@ Use when the user gives an existing idea ID.
 1. Call `mcp__sellable__get_post_idea({ ideaId })`.
 2. Treat the idea's raw source as immutable source material.
 3. Run hook research.
-4. Develop and select a premise card.
-5. Save hook research.
-6. Draft and validate.
-7. Save the draft.
+4. Run the configured thought-leader voice variant lab unless the user explicitly
+   says to skip thought leaders or use only a named subset.
+5. Develop and select a premise card.
+6. Save hook research.
+7. Draft and validate.
+8. Save the draft.
 
 ## Capture Mode
 
@@ -218,12 +247,17 @@ Use when the user gives a new rough idea, voice memo transcript, freestyle note,
 
 1. Call `mcp__sellable__capture_post_idea` before transformation.
 2. Preserve the raw source exactly.
-3. Distill only what the user actually said.
-4. Run hook research.
-5. Develop and select a premise card.
-6. Save hook research.
-7. Draft and validate.
-8. Save the draft.
+3. Run the `Transcript Worldview Packet` match against transcript/content-memory
+   clusters before research or hook generation.
+4. Distill only what the user actually said plus source-backed transcript
+   worldview/proof ingredients. Label anything inferred from transcripts.
+5. Run hook research.
+6. Run the configured thought-leader voice variant lab unless the user explicitly
+   says to skip thought leaders or use only a named subset.
+7. Develop and select a premise card.
+8. Save hook research.
+9. Draft and validate.
+10. Save the draft.
 
 ## Ad Hoc Mode
 
@@ -283,6 +317,318 @@ Space benchmark research:
 7. For each approved tracked person, call `mcp__sellable__upsert_engage_tracked_person`.
 
 The approved pack is capped at 20 gold standards. If adding new approved examples would exceed 20, ask which existing item to replace or skip the overflow. Candidate lists can be longer, but approved saved standards cannot exceed 20.
+
+## Thought Leader Voice Variant Mode
+
+Use when the user names creators, thought leaders, profile URLs, or says to
+write variants using a specific person's recent best content as inspiration.
+Also use this mode when the user says "use my configured thought leaders",
+"use my influencers", "use the tracked people list", or similar.
+In normal draft-producing create-post flows, run this mode automatically from
+the configured active influencer list after the Transcript Worldview Packet and
+general hook research, unless the user explicitly says to skip thought leaders,
+skip external inspiration, or use only a named subset.
+
+This mode is a role-play variant lab for internal synthesis. Each background
+worker should assume that creator's public LinkedIn lens, taste, hook style,
+rhythm, and editorial instincts, then draft the post the creator would likely
+write from the user's idea and context. The worker may write in a voice-inspired
+style for the private variant, but it must not claim the creator authored it,
+copy source wording, copy personal proof, or invent facts about the user.
+
+The final orchestrator does not publish a collage of creator personas. It takes
+the best hooks, pressure, structure, rhythm, and proof moves from the role-played
+variants, then synthesizes the most compelling post for Christian/Sellable.
+
+Target fast flow:
+
+```text
++----------------------+      +----------------------+      +----------------------+
+| Raw idea + memory    | ---> | Active influencers   | ---> | Parallel workers     |
+| 3-5 min              |      | 1 min                |      | 6-10 min wall clock  |
++----------------------+      +----------------------+      +----------+-----------+
+                                                                  |
+                                                                  v
++----------------------+      +----------------------+      +----------------------+
+| Save compact draft   | <--- | Final synthesis      | <--- | Voice-modeled posts  |
+| 1 min                |      | 3-5 min              |      | representative length|
++----------------------+      +----------------------+      +----------------------+
+```
+
+Default output budget:
+
+- main orchestrator receipt: 300-700 words
+- each influencer worker: representative-length post plus compact notes
+- each influencer post variant: match that creator's normal length, rhythm,
+  vocabulary, formatting, and close for this kind of idea
+- final synthesized post: normal LinkedIn post length unless the user asks short
+- do not return long research reports unless the user explicitly asks for them;
+  spend tokens on the actual voice-modeled post
+
+Default workflow:
+
+1. Normalize the requested people into a `thought_leader_list` with name,
+   LinkedIn profile URL or handle, reason, and optional lane. By default, load
+   the list from memory-backed `discovery/influencers.md` and include only rows
+   where `Include in Discovery` is not `false`. Treat the `Reason` column as
+   the person's lane/adaptation brief. If the user names a subset, use that
+   subset and resolve each person against the configured list first.
+2. If the user gives only a name and the profile cannot be resolved from
+   tracked people or memory, ask for the profile URL or handle before running
+   person-specific research.
+3. When the host supports background agents, launch one bounded
+   `influencer-voice-worker` per person. If not, process each person
+   sequentially. Each configured person must receive a person-specific voice
+   variant; do not collapse the configured list into generic space research.
+4. Each worker fetches that person's recent posts with
+   `mcp__sellable__fetch_linkedin_posts`, and fetches profile/follower context
+   with `mcp__sellable__fetch_linkedin_profile` when available.
+5. Each worker samples enough recent posts to understand the person's current
+   public voice. Score internally for topic fit, hook strength, body payoff,
+   repeated patterns, engagement quality, and follower-adjusted signal when
+   follower counts are available. Do not return the full scoring table.
+6. Each worker must build a `voice_model` before drafting:
+   - representative length range for similar posts
+   - average paragraph/line length and spacing rhythm
+   - hook posture and opening moves
+   - common vocabulary, recurring phrases, and taboo phrases
+   - proof style: story, numbers, teardown, checklist, confession, challenge
+   - formatting: bullets, numbering, questions, equations, parentheticals
+   - close style: command, reflection, CTA, punchline, open loop
+   - factual boundaries: what must come from Christian/Sellable context
+7. Each worker writes the complete post that this creator would likely write
+   from the user's idea and context. Match the inferred length/rhythm/style; do
+   not compress to a generic short draft.
+8. Each worker returns a compact voice variant:
+   - person and profile URL
+   - worker status
+   - recent post count sampled
+   - voice model, max 8 bullets
+   - complete post variant in that creator's inferred voice and representative
+     length
+   - hook options, max 3
+   - what to steal for the final Christian/Sellable post, max 5 bullets
+   - what to drop or avoid, max 5 bullets
+   - proof gaps and factual risks
+   - source URLs sampled, max 3
+9. The orchestrator compares all creator variants, chooses the strongest hooks,
+   structures, proof moves, and rhythm, then writes one synthesized final post.
+10. The orchestrator must label worker outputs as `voice_variant_from: <person>`
+   and final synthesis as `final_voice: Christian/Sellable`.
+11. In the final user-visible response, include a compact
+   `BACKGROUND_AGENT_DRAFT_REVIEW` section before the final post whenever this
+   lab ran. It must review every active person's private variant, state the
+   strongest move, what to drop, and what was selected for synthesis. Do not
+   hide this behind a boolean receipt when the user is validating the workflow.
+
+Hard rules:
+
+- The role-play variant is internal synthesis material, not a claim of authorship
+  by the creator.
+- Do not copy outside wording, proof, jokes, personal stories, or status.
+- Do not invent user proof just because it would fit the creator's style.
+- Do not let a large-audience creator win only because of reach. Use engagement
+  per 1k followers when follower counts are available, and mark confidence when
+  follower data is missing.
+- Keep Christian/Sellable truth and proof as the final factual layer.
+- If a thought leader has no recent full-text posts or the useful posts are
+  mostly lead magnets, return a weak variant and explain what could still be
+  useful.
+
+## Visible Whole-Flow Debug Mode
+
+Use when the user asks to see the whole flow, run the flow step by step,
+validate that the workflow is working, debug a bad output, explain why a draft
+is bad, or otherwise asks for the process to be explicit.
+
+This mode exists because a validation receipt hidden inside a saved draft is not
+enough. The user must be able to inspect the reasoning path before the system
+claims the workflow worked.
+
+In visible whole-flow debug mode:
+
+1. Run the normal create-post workflow.
+2. Show a `Visible Flow Trace` with every checkpoint below.
+3. Mark each checkpoint `pass`, `weak`, `fail`, or `blocked`.
+4. Include the concrete output from that checkpoint, not only a label.
+5. If any checkpoint is weak or failed, name the exact quality break and the
+   downstream effect on the draft.
+6. Do not call the run successful just because files were saved.
+7. Do not hide premise cards, source-template selection, hook candidates,
+   pre-draft structure, body-expression candidates, or validation findings only
+   inside the saved artifact.
+
+The trace must use this order:
+
+```text
+Visible Flow Trace
+
+0. Bootstrap
+- auth/workspace:
+- canonical prompt loaded:
+- required assets loaded:
+- memory loaded:
+- package/version notes:
+
+1. Raw Idea Capture
+- idea id:
+- raw source preserved:
+- distilled brief:
+- claims added or avoided:
+- transcript/content-memory matches:
+- worldview ingredients from transcripts:
+- hot-take ingredients from transcripts:
+- proof/story pulled:
+- proof/story gaps:
+- private/sensitive exclusions:
+
+2. Research Search Log
+- search window:
+- keywords:
+- result count:
+- full-text fetches:
+- search gaps:
+
+3. Weighted Source Selection
+- kept sources:
+- rejected sources:
+- keeper scores:
+- lead-magnet / engagement-bait penalties:
+- why the top source actually fits:
+
+4. Hook Autopsies
+- source hook:
+- calculated mobile/desktop visible blocks from
+  `calculate_linkedin_hook_preview` or authenticated LinkedIn screenshot:
+- optional visual artifact from `render_linkedin_post_preview`:
+- see-more tension:
+- curiosity debt:
+- body promise:
+- why it works:
+- why it may not transfer:
+
+5. Source Message Outlines
+- source:
+- outline basis:
+- source paragraph order:
+- branches by paragraph/line/phrase:
+- high-level goal of each branch:
+- reusable move without copying wording:
+
+6. Post Positioning Breakdowns
+- source:
+- positioning sequence:
+- line-level narrative techniques:
+- reusable template lines:
+- adaptation guards:
+
+7. Viral-Post Outlines
+- source template:
+- hook job:
+- see-more trigger:
+- beat sequence:
+- body payoff:
+- close job:
+
+8. Audience Tension Snapshot
+- resonating ideas:
+- visible audience tension:
+- wants / objections / fears:
+- credible angle:
+- why this user can credibly say it:
+- what not to claim:
+
+9. Premise Cards
+- 3-5 cards:
+- story/scene:
+- tension:
+- reader value:
+- proof available:
+- proof missing:
+- source-template fit:
+- score:
+- selected premise:
+
+10. Source Template Selection
+- selected template:
+- positioning sequence to borrow:
+- hook move to borrow:
+- body outline to borrow:
+- required user proof:
+- forbidden borrowing:
+- no-template rationale if rejected:
+
+11. Hook Lab
+- at least 12 hooks:
+- calculated preview from `calculate_linkedin_hook_preview`:
+- optional visual artifact from `render_linkedin_post_preview` for finalists:
+- hook-to-body promise:
+- score:
+- selected hook:
+- rejected winning-looking hooks and why:
+
+12. Pre-Draft Narrative Outline
+- hierarchical outline shown before draft:
+- I. hook and click debt:
+- II. thesis the post will defend:
+- III. operating model:
+- IV. body shape borrowed from posts that worked:
+- V. narrative beats:
+- VI. scan path and proof safety:
+- user corrections applied before prose:
+
+13. Body Expression Lab
+- 5-8 body-expression candidates:
+- best lines:
+- weak lines:
+- hook promise repayment:
+- proof risk:
+- score:
+- combined body plan:
+
+14. Thought Leader Voice Variant Lab
+- specified thought leaders:
+- worker status per person:
+- recent posts sampled:
+- voice model:
+- complete voice variants:
+- follower-adjusted signal when available:
+- hook/body moves worth stealing:
+- proof gaps and factual risks:
+- selected synthesis ingredients:
+
+15. Draft
+- draft body:
+- lines intentionally copied from user source:
+- outside-source wording copied: yes/no:
+- known weak lines:
+
+16. Validation And Save
+- ready status:
+- proof gate:
+- voice gate:
+- anti-AI gate:
+- mobile preview gate:
+- template adaptation gate:
+- hook-to-body repayment:
+- quality break, if any:
+- saved idea path:
+- saved research path:
+- saved draft path:
+```
+
+Quality-break rules:
+
+- If the draft is bad, say which checkpoint produced the bad draft. For example:
+  weak raw story, wrong selected source template, hook promise not repaid,
+  body expression lab too generic, proof missing, or voice mismatch.
+- A draft with a coherent validation receipt but poor body copy is not a
+  successful run. Mark it `needs_revision` and show the checkpoint where the
+  body lost the premise.
+- If the source idea is too abstract, stop at premise development or save a
+  `needs_revision` draft only after showing the missing story/proof.
+- If the user is judging the workflow itself, prefer showing the trace over
+  optimizing for a polished final post.
 </modes>
 
 <pipeline>
@@ -293,6 +639,8 @@ The approved pack is capped at 20 gold standards. If adding new approved example
 3. Load the gold-standard post pack if present.
 4. Verify auth/workspace if hook research will use Sellable search.
 5. Capture or load the source idea.
+6. Run a transcript/content-memory match for the source idea before hook
+   research.
 
 If local idea capture succeeds but auth/workspace is missing, keep the idea and return a typed blocked state for draft readiness:
 
@@ -302,6 +650,35 @@ If local idea capture succeeds but auth/workspace is missing, keep the idea and
 - `zero_useful_hook_results`
 - `full_text_unavailable`
 
+## Step 0.5: Transcript Worldview Packet
+
+After raw capture and before hook research, match the source idea against
+`core/transcripts/INDEX.md`, `core/content-memory/INDEX.md`, relevant cluster
+files, story/proof/question cards, post seeds, and approved core references
+returned by `mcp__sellable__get_engage_memory`.
+
+The packet must answer:
+
+```text
+Transcript Worldview Packet
+- source idea id:
+- matched clusters:
+- matched transcript references:
+- matched cards/seeds:
+- repeated user phrasing:
+- worldview ingredients:
+- hot-take ingredients:
+- proof/story available:
+- proof/story missing:
+- private/sensitive exclusions:
+- confidence: strong | medium | weak
+```
+
+Use this packet to shape premise cards, audience tension, hooks, and body
+expression. Do not treat it as permission to add unsupported claims. If the
+packet is weak, keep the post closer to the raw idea and ask for the missing
+proof/story before marking a draft ready.
+
 ## Step 1: Hook Research
 
 Use `references/hook-research-playbook.md`.
@@ -317,11 +694,23 @@ The research worker must return a compact packet only:
 
 - source examples kept and rejected
 - full adapted hook blocks
-- market belief map: resonating ideas, implicit beliefs, audience wants, resentments, fears, and credible controversy angles
+- audience tension snapshot: resonating ideas, visible tensions, audience wants,
+  objections, fears, and credible angles
 - premise inputs: real scenes, observed tensions, reader value openings, and proof gaps
+- transcript worldview packet: matched clusters, transcript references,
+  repeated phrasing, worldview ingredients, hot-take ingredients, proof/story
+  available, proof/story missing
 - exact phrase patterns and sentence shapes
+- post positioning breakdowns that label each meaningful line or phrase by
+  narrative job and category
+- viral-post outlines for the best source posts
+- line-to-template conversions that turn source structures into reusable
+  templates without source wording
+- hook-to-body promise maps that show how each hook tells the body
 - body structures and exact body language moves
 - preview measurements
+- thought leader voice variants from the configured active influencer list
+  unless the user explicitly opted out or supplied a named subset
 - track-person and gold-standard recommendations
 - blocked states or confidence gaps
 
@@ -338,12 +727,20 @@ Default flow:
 5. If full text cannot be matched, record `full_text_unavailable` and use only the preview. Do not invent missing body details.
 6. Weigh shares/reposts above comments, comments above reactions, and reactions as weak reach unless paired with stronger signals. If shares/reposts are unavailable, record `repost_data_unavailable`.
 7. Penalize lead-magnet or giveaway mechanics unless the user explicitly asks for a lead magnet post.
-8. Build a market belief map before hook generation: what the space is rewarding, what the audience implicitly believes, what they want permission to say, what they resent or fear, what they will argue with, and which controversial angle the user can credibly own. If the user's raw idea is internally coherent but not attached to a live market tension, do not draft from the internal idea alone; present stronger directions or rewrite the draft angle around the external tension.
+8. Build an audience tension snapshot before hook generation: what the space is rewarding, what tension readers are reacting to, what they want to try or avoid, what objections/fears will make them hesitate, and which angle the user can credibly own. If the user's raw idea is internally coherent but not attached to live audience tension, do not draft from the internal idea alone; present stronger directions or rewrite the draft angle around the external tension.
 9. Extract premise inputs: real story/scene possibilities, observed tensions, useful reader takeaways, and proof gaps. A good hook cannot rescue a premise with no value.
 10. For story posts, extract the story mechanism that made the post work, not just the first line.
 11. Extract hook structures plus specific reusable words, phrases, sentence
    shapes, transitions, and body language patterns.
-12. Save the research with `mcp__sellable__save_hook_research`.
+12. Create a post positioning breakdown for each keeper post: line/phrase,
+    category, narrative technique, tension created, reader question opened,
+    proof dependency, and reusable template line.
+13. Convert each keeper into a viral-post outline: hook job, see-more trigger,
+    body payoff, close job, and beat-by-beat narrative structure.
+14. Convert the best outlines into reusable post templates with positioning
+    sequences, required story/proof inputs, forbidden borrowing, and
+    Sellable-specific adaptation instructions.
+15. Save the research with `mcp__sellable__save_hook_research`.
 
 Record provenance:
 
@@ -357,11 +754,18 @@ Record provenance:
 - lead-magnet or engagement-bait penalties
 - story mechanism when relevant
 - full-text match status
+- transcript/content-memory match status and worldview packet
 - source hook preview measurements and whether they came from full text or a search preview
 - selected hook patterns
-- market belief map and selected controversy
+- audience tension snapshot and selected angle
+- thought leader voice variants and selected synthesis ingredients from the
+  configured active influencer list unless explicitly skipped
 - premise cards and selected premise
 - exact phrase patterns and sentence shapes
+- post positioning breakdowns
+- viral-post outlines
+- reusable post templates
+- hook-to-body promise maps
 - body structures and body language patterns
 - why each pattern fits the user's idea and voice
 
@@ -384,6 +788,7 @@ The `Research Learning Report` must include:
 ```text
 Research status:
 - idea/topic:
+- transcript worldview packet:
 - research artifact:
 - search window:
 - keywords:
@@ -393,15 +798,15 @@ Research status:
 Best source examples:
 1. author, URL, engagement, why kept, why not copied
 
-Market belief map:
+Audience tension snapshot:
 - resonating ideas:
-- implicit beliefs:
+- visible audience tension:
 - audience wants:
-- audience resentments:
+- audience objections:
 - audience fears:
-- controversial angles to test:
+- credible angles to test:
 - avoid because:
-- selected controversy:
+- selected angle:
 
 Premise cards:
 1. premise + real story/scene + tension + reader value + proof gap + score
@@ -410,7 +815,10 @@ Hook patterns learned:
 1. full adapted hook block
    - source mechanism:
    - preview budget:
+   - see-more tension:
+   - curiosity debt:
    - internal question:
+   - hook-to-body promise:
    - why it fits / why it does not:
 
 Specific words and phrase shapes:
@@ -421,13 +829,57 @@ Specific words and phrase shapes:
    - adapted Sellable form:
    - do not copy:
 
+Post positioning breakdown templates:
+1. source + template name
+   - positioning sequence:
+   - line-level narrative techniques:
+   - tension created:
+   - reader questions opened:
+   - reusable template lines:
+   - Sellable adaptation:
+
+Source message outlines:
+1. source + outline basis
+   - source paragraph order:
+   - paragraph/line/phrase branches:
+   - high-level goal of each branch:
+   - reader effect:
+   - reusable move:
+   - adaptation guard:
+
+Viral-post outlines:
+1. outline name
+   - hook job:
+   - see-more trigger:
+   - body payoff:
+   - close job:
+   - beat sequence:
+
+Line-to-template conversion:
+1. source line/beat
+   - narrative job:
+   - template line shape:
+   - required user story/proof:
+   - forbidden borrowing:
+   - adapted Sellable expression:
+
 Body structures learned:
 1. structure name
    - source:
+   - positioning sequence:
    - sequence:
    - exact language moves:
    - adapted Sellable body move:
 
+Thought leader voice variants:
+1. person + profile URL
+   - worker status:
+   - recent posts sampled:
+   - voice model:
+   - full role-played post variant:
+   - steal/drop notes:
+   - factual risk:
+
 Rejected examples:
 - author/source:
 - reason rejected:
@@ -437,9 +889,9 @@ Save recommendations:
 - gold-standard candidates:
 
 Recommended draft directions:
-1. premise card + hook block + body structure
-2. premise card + hook block + body structure
-3. premise card + hook block + body structure
+1. premise card + source template + hook block + viral outline + body structure
+2. premise card + source template + hook block + viral outline + body structure
+3. premise card + source template + hook block + viral outline + body structure
 ```
 
 Keep this report concise enough to read, but concrete enough that another agent
@@ -449,11 +901,13 @@ could draft from it without redoing research.
 
 Use `references/premise-development.md`.
 
-Generate 3-5 `Premise Card` candidates from the raw idea, market research, core
+Generate 3-5 `Premise Card` candidates from the raw idea, audience/source research, core
 memory, story/proof files, and current-session user feedback. Each card must
 include a real story/scene or observed pattern, target reader, common belief,
 contrarian truth, tension, reader value, proof available, proof missing, and a
-score.
+score. Each card must also evaluate which source template or no-template path
+fits, which positioning sequence to test, and how the hook promise will be
+repaid in the body.
 
 Select the strongest premise before hook generation. The selected premise must
 pass:
@@ -464,13 +918,104 @@ pass:
 - `reader_value`
 - `credible_speaker`
 - `proof_safety`
-- `market_heat`
+- `audience_tension`
+- `template_fit`
+- `hook_to_body_repayment`
 
-If the idea has market heat but no real scene, ask for the missing scene unless
+If the idea has audience tension but no real scene, ask for the missing scene unless
 the user explicitly requested an immediate draft. For immediate draft mode, use
 only source-backed observed patterns and save the draft as `needs_revision`
 unless the premise still has concrete reader value.
 
+## Step 1.9: Pre-Draft Narrative Outline
+
+Before generating final draft prose, create and show a compact `Pre-Draft
+Narrative Outline`. This is not a checklist. It is the user-visible argument
+skeleton that lets the user confirm what the post will say, in what order, and
+which proven body shapes will guide the draft before the system writes body
+copy.
+
+The outline must be concise, mobile-scanable, and concrete enough for the user
+to approve or correct. Do not hide it inside the validation receipt after the
+draft. Show it before writing the draft body unless the user explicitly says to
+skip outline/structure and write immediately. Even when the user skips the
+visible checkpoint, still include the outline in the validation receipt.
+
+The `Pre-Draft Narrative Outline` must use hierarchical outline notation:
+Roman numerals for major narrative beats, letters for sub-beats, and lowercase
+roman numerals for proof/examples/body moves. Do not replace this with a flat
+field list.
+
+The `Pre-Draft Narrative Outline` must include:
+
+```text
+Pre-Draft Narrative Outline
+I. Hook and click debt
+   A. Selected hook:
+   B. Rendered mobile preview verdict:
+   C. What "see more" must repay:
+
+II. Thesis the post will defend
+   A. One-sentence thesis:
+   B. Reader being taught:
+   C. Why this reader cares now:
+
+III. Operating model
+   A. Core equation or mechanism:
+   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:
+   B. Working body pattern(s) being adapted:
+      i. <pattern name>: <beat order and why it works>
+      ii. <pattern name>: <beat order and why it works>
+   C. What gets borrowed:
+      i. <narrative job, sequence, transition, or proof order>
+   D. 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:
+      ii. Concrete examples:
+   B. Beat 2: <job, reader state before/after, example/proof>
+      i. Line shape or section label:
+      ii. Concrete examples:
+   C. Beat 3: <job, reader state before/after, example/proof>
+      i. Line shape or section label:
+      ii. Concrete examples:
+
+VI. Scan path and proof safety
+   A. Mobile scan path:
+   B. Proof claims:
+      i. <claim>: <source + public-safety status>
+   C. Abstractions to remove:
+      i. <abstract phrase> -> <concrete replacement>
+   D. Draft risks:
+```
+
+Rules:
+
+- The hook must already have a rendered mobile and desktop preview record.
+- The thesis must be one sentence the post can defend.
+- The reader must be specific enough to guide what gets cut.
+- `Body shape borrowed from posts that worked` must name the body pattern or
+  explain why no-template is stronger. It must say what narrative job is being
+  borrowed, not just "make it like this creator."
+- `Narrative beats` must show the order of the argument with `I.`, `A.`, and
+  `i.`-style hierarchy. A flat checklist fails this step.
+- Key definitions must name concrete examples when the post teaches an
+  operating concept. For example, define `lead source` as how the list was
+  built, not as a persona label.
+- `mobile scan path` must say what a reader understands if they read only the
+  hook, separators, section labels, numbers, and final line.
+- `abstractions to remove` must list abstract phrases and the concrete words
+  that will replace them.
+- If the user corrects the outline, update the outline first, then draft. Do
+  not patch the final prose while leaving the outline stale.
+
 ## Step 2: Hook Candidates
 
 Generate at least 12 hook candidates from the selected premise unless the user
@@ -504,38 +1049,178 @@ Each hook must include:
 
 Do not copy source wording. Copy only the structure.
 
-Use this conservative mobile-first LinkedIn preview gate. LinkedIn does not
-publish exact "see more" cutoff rules, and rendering varies by device, app
-version, font, media, and line break. These are v1 safety budgets, not claims
-about an official LinkedIn limit:
-
-- `pass`: hook is <= 110 chars including newlines, every nonblank line is <= 45 chars, and the hook's core point lands before likely truncation.
-- `warn`: hook is 111-140 chars including newlines, any nonblank line is 46-55 chars, or blank lines create visual-line risk. Blank lines are allowed, but they count as physical lines.
-- `fail`: hook is > 140 chars including newlines, any nonblank line is > 55 chars, or the hook's point depends on text after likely truncation.
+Use the rendered-preview contract from
+`references/linkedin-preview-rendering.md`. LinkedIn does not publish exact
+"see more" cutoff rules, and rendering varies by device, app version, font,
+media, and line break. Treat character counts as diagnostics only, not as proof
+that the hook will render before "see more."
+
+The selected hook and top candidates must include literal mobile and desktop
+visible blocks from `mcp__sellable__calculate_linkedin_hook_preview`.
+Observed LinkedIn screenshots and current third-party preview tools support a
+line-count model: review the first 3 rendered visual lines, not the first 210
+characters. Blank lines and `--` separators consume visible preview lines.
+Use `mcp__sellable__render_linkedin_post_preview` only when a visual QA artifact
+is useful.
+
+Use:
+
+- `pass`: rendered mobile preview shows the pain, proof, or curiosity by the end
+  of the first 3 rendered lines, and either the core point is visible or a
+  specific intentional open loop is visible with immediate body payoff planned
+- `warn`: rendered mobile preview creates useful curiosity but wrapping,
+  blank-line rhythm, media risk, or one missing context word weakens it; include
+  a compact fallback
+- `fail`: the hook's real point appears after the rendered mobile review clamp,
+  the visible open loop is vague, blank lines consume the preview before the
+  point, or desktop fit is the only reason it looks good
 
 Desktop preview usually has more room. Still record `desktopPreviewFit`, but
-never let desktop fit compensate for a mobile `fail`.
+never let desktop fit compensate for a mobile `fail`. Do not tell the user "we
+know" how LinkedIn will render unless there is an authenticated LinkedIn
+screenshot; say it passes the renderer and show the visible blocks.
 
 If a hook's point depends on text after the likely preview, rewrite it before
 selecting it. A selected hook may carry a `warn` only when the warning is about
 intentional blank-line rhythm or a slight line-length overage; include a compact
 fallback in the validation receipt.
 
+## Step 2.5: Thought Leader Voice Variant Lab
+
+Run this step by default for draft-producing create-post flows using the
+configured active people in `discovery/influencers.md`. Skip it only when the
+user explicitly says to skip thought leaders, skip external inspiration, or use
+only general hook research. If the user supplied a `thought_leader_list`, use
+that named subset instead of the full configured list.
+
+This is a draft-readiness gate, not an optional research note. Before final
+prose, resolve the active configured influencer list, record the expected person
+count, and produce one voice variant for every active person. A draft
+cannot be `ready` when the configured list was not loaded, when an active person
+is missing a variant, or when the lab is summarized as generic hook research. If
+a profile fetch or post fetch succeeds but produces weak material, keep a
+`weak` variant with the attempted fetches and confidence gaps. If a profile URL
+cannot be resolved or the research tool fails, return `retry-needed` or save
+only `needs_revision` unless the user explicitly opted out of the lab.
+
+When the host supports background agents, fire one bounded
+`influencer-voice-worker` per specified person. This is the default execution
+mode. Do not process the configured influencer list sequentially just to keep
+the main orchestrator simple. Sequential processing is allowed only when the
+host has no background-agent mechanism; record that fallback in the receipt.
+Each worker owns only that person's voice role-play variant. The orchestrator
+owns comparison, synthesis, factual safety, and final Christian/Sellable proof.
+
+Each worker must return:
+
+- person name and profile URL or handle
+- worker status
+- recent post count sampled
+- follower count when available
+- normalization confidence
+- voice model, max 8 bullets, including representative length, rhythm,
+  vocabulary, formatting, proof style, and close style
+- complete role-played post variant in the creator's inferred voice and
+  representative length
+- hook options, max 3
+- best lines or moves worth stealing, max 5 bullets
+- what to drop or avoid, max 5 bullets
+- proof gaps and factual risks
+- source URLs sampled, max 3
+
+Do not return full research tables, long post autopsies, or full source text
+unless the user explicitly asks for the research report. The normal worker job is
+to draft the variant.
+
+The orchestrator then synthesizes the final post from the voice variants.
+Variant labels must be:
+
+```text
+voice_variant_from: <person>
+role_play_basis: public posts sampled + configured Reason lane
+post_variant: <complete variant>
+steal_for_final: hook | structure | proof order | rhythm | close move
+drop_for_final: copied wording | borrowed personal proof | fake user fact
+```
+
+It is acceptable for the worker to write the private variant "in <person>'s
+voice" for synthesis. It is not acceptable to publish the variant as that
+person, copy their wording, or borrow their personal proof/status. The final
+draft should be the most compelling synthesis, grounded in Christian/Sellable
+context.
+
+Before drafting, record:
+
+- `activeInfluencerSource`: `discovery/influencers.md` or named subset
+- `expectedActiveInfluencerCount`
+- `actualVoiceVariantCount`
+- `missingVoiceVariants`
+- `weakVoiceVariants`
+- `selectedSynthesisIngredients`
+- `voiceVariantsGeneratedBeforeFinalProse: yes | no`
+- `workerExecutionMode: background_agents | sequential_fallback`
+- `backgroundWorkerIds` or worker labels when available
+
+If `actualVoiceVariantCount` is lower than
+`expectedActiveInfluencerCount`, do not save the draft as `ready`.
+
+When returning the completed draft, show the synthesis review in this shape
+before the final post:
+
+```text
+BACKGROUND_AGENT_DRAFT_REVIEW
+workerExecutionMode: background_agents | sequential_fallback
+expectedActiveInfluencerCount: <number>
+actualVoiceVariantCount: <number>
+
+1. <person>
+- worker_status:
+- draft_review:
+- strongest_move:
+- weakness_or_drop:
+- synthesis_decision:
+
+SYNTHESIS_INGREDIENTS
+- hook:
+- structure:
+- rhythm:
+- proof_order:
+- close:
+- dropped:
+```
+
+The review must cover every active configured person, not only the winning
+variant. Then return `FINAL_POST` in Christian/Sellable voice.
+
 ## Step 3: Draft
 
 Draft from:
 
 - exact raw idea
+- transcript worldview packet
 - selected premise card
 - selected hook
+- approved or latest `Pre-Draft Narrative Outline`
 - hook research artifact
+- selected source template or no-template rationale
+- source-message outline for any outside post being adapted
+- viral-post outline
+- post positioning breakdown template
+- body expression candidates and combined body plan
 - user's core memory
 - story/proof files
 - post writing rules
 - 1-3 relevant approved gold standards when available
+- thought leader voice variants from the configured active influencer
+  list or supplied named subset
 
 If a claim cannot be traced to the raw idea, core memory, or user answer in the current session, remove it or ask.
 
+Do not write final draft prose until the Thought Leader Voice Variant Lab has
+either completed for every active configured influencer or the validation
+receipt has an explicit user opt-out reason. A light source-research summary
+does not satisfy this gate.
+
 ## Step 4: Validation
 
 Use `references/post-validation.md`.
@@ -544,16 +1229,29 @@ Every saved draft needs a validation receipt with:
 
 - source idea ID
 - hook research ID
+- transcript worldview packet
 - iteration metadata: version, priorDraftId, changeIntent, what changed,
   what improved, what got worse, score, and verdict
 - selected premise card
 - candidate hooks considered
 - selected hook and why
+- pre-draft narrative outline
+- selected source template and no-copy adaptation rationale
+- thought leader voice variant lab, including skipped/opt-out reason when
+  omitted and expected-vs-actual variant counts for the active configured list
+- post positioning breakdown
+- viral-post outline
+- hook-to-body promise map
+- body expression candidates and combined body plan
 - proof claims used and source
 - story/proof files consulted
 - gold standards consulted
 - LinkedIn preview audit
 - premise/value audit findings
+- audience-tension audit findings
+- mobile scanability audit findings
+- template-adaptation audit findings
+- abstraction-to-concrete rewrite audit findings
 - simplifier/concrete-language audit findings
 - voice audit findings
 - anti-AI audit findings
@@ -648,8 +1346,20 @@ iteration:
   score: <compact score object>
 selected_premise: <premise or none>
 selected_hook: <hook>
+pre_draft_narrative_outline: <compact I/A/i outline summary or none>
+selected_source_template: <template name/source or none>
+thought_leader_voice_variants: <variants and synthesis ingredients used or none>
+background_agent_draft_review: <per-person review and synthesis decision when the lab ran>
+final_post: <complete final post in Christian/Sellable voice>
+visible_flow_trace: <required when user asked for whole-flow/debug/step-by-step mode; include checkpoint statuses and quality break>
 validation_summary:
   premise_value: pass | needs_user_input | needs_revision
+  audience_tension: pass | needs_revision
+  mobile_scanability: pass | needs_revision
+  thought_leader_adaptation: pass | needs_revision | not_used
+  template_adaptation: pass | needs_revision | blocked
+  abstraction_to_concrete: pass | needs_revision
+  hook_to_body_repayment: pass | needs_revision
   proof: pass | needs_user_input | blocked
   voice: pass | needs_revision
   anti_ai: pass | needs_revision