File Location
Example: If your company is Extruct, the file is
claude-code-gtm/context/extruct_context.mdFile Structure
The context file has 8 main sections:What We Do
What We Do
Product description, value proposition, key numbers, and terminology.Fields:
- Product: One-liner description
- Value prop: Core value proposition (internal version)
- Email-safe value prop: Outreach-friendly version without banned words
- Key lingo: Internal terms and definitions
- Key numbers: Quantifiable claims (database size, speed, coverage)
- Read by
email-prompt-buildingfor P2 value angles - Email-safe version gets baked into prompt templates
- Key numbers used in emails for credibility
Voice
Voice
Sender identity, tone rules, and hard constraints for all outreach.Fields:
- Sender: Name and company (who emails come from)
- Tone: 1-sentence description (e.g., “Calm, analytical, builder-to-builder”)
- Language level: Complexity guide (e.g., “B2 English: simple, clear sentences”)
- Hard constraints: Numbered list of rules (e.g., “No dashes, no exclamation marks”)
- Banned words: Words that must never appear in outreach
- Scope boundaries: What the product IS and ISN’T
- Read by
email-prompt-buildingto set voice rules in templates - Read by
email-response-simulationto constrain rewrites - Enforced during
email-generation
ICP
ICP
Target customer profiles and anti-patterns.Structure:Usage:
- Read by
hypothesis-buildingto shape pain hypotheses - Read by
list-buildingfor query design and filters - Read by
market-researchto scope research queries
Win Cases
Win Cases
Past customers, what resonated, concrete outcomes.Structure:Usage:
- Read by
hypothesis-buildingto extract transferable patterns - Read by
list-buildingfor seed companies in lookalike mode - Source for Proof Library entries (every proof must trace to a win)
Proof Library
Proof Library
Pre-written proof point sentences for use in P4 of emails.Structure:Rules:
- Every proof point must trace back to a real win case
- Write as full sentence including “PS.”
- Map to audience type and hypothesis for conditional selection
- Read by
email-prompt-buildingto select proof points - Conditionally inserted in emails during
email-generation - 3-dimensional selection: peer relevance + hypothesis alignment + non-redundancy
Campaign History
Campaign History
Past campaigns with metrics and learnings.Structure:Usage:
- Updated via
context-buildingfeedback loop mode - Informs future hypothesis prioritization
- Tracks which verticals and angles work
Active Hypotheses
Active Hypotheses
Pain hypotheses organized by validation status.Structure:Usage:
- Read by
email-prompt-buildingfor P1 angle selection - Updated based on campaign results (promote/demote/retire)
- Target 5-7 active hypotheses
Do Not Contact
Do Not Contact
Domains to exclude from all lists.Structure:Reasons:
- Competitor
- Partner
- Existing customer
- Requested opt-out
- Read by
list-buildingto filter search results - Read by
campaign-sendingbefore upload to sequencer - Can auto-populate by running competitor search
Creating a Context File
Use the context-building skill:- Check if context file exists
- If not, read your website to extract product info
- Walk you through each section interactively
- Write the file using the standard schema
Updating the Context File
The context file evolves as you learn. Four update modes:Mode 1: Manual Update
Add new sections or entries:Mode 2: Call Recording Capture
Extract signals from sales calls:- ICP signals (role, company size, pain points)
- Win case data (what resonated)
- Proof point candidates (specific results)
- Hypothesis validation (confirmed/refuted)
- Voice feedback (reaction to tone/positioning)
Mode 3: Campaign Feedback Loop
Import campaign results:- Adds row to Campaign History table
- Promotes/demotes hypotheses based on reply rates
- Adds new proof points from positive replies
- Updates Proof Library with performance notes
Mode 4: Hypothesis Refinement
Move hypotheses between Validated/Testing/Retired based on data:Section Rules and Best Practices
What We Do
- Keep under 100 words
- Update when positioning changes
- Always maintain email-safe version (no banned words)
- Include key numbers for credibility
Voice
- Define sender identity clearly (name + company)
- Keep tone to 1 sentence
- Hard constraints should be enforceable (“no dashes” not “be authentic”)
- Update banned words when simulation flags issues
ICP
- Max 5 primary profiles
- Always include anti-patterns (prevents wasted outreach)
- Be specific on company size ranges (“50-200” not “mid-market”)
Win Cases
- Add every closed deal (anonymous is fine)
- Include concrete outcomes with metrics
- Note what pain triggered the purchase
Proof Library
- Every proof point must map to a real win case
- Write full PS sentences (“PS. Acme reduced…” not “reduced”)
- Map to audience and hypothesis for conditional selection
- Test proof points in campaigns before adding
Campaign History
- One row per campaign
- Update reply rate when final numbers are in
- Extract 1-sentence learning per campaign
Active Hypotheses
- Target 5-7 active hypotheses (3-4 Validated, 2-3 Testing)
- Move to Retired after 2-3 failed campaigns
- Promote to Validated after 10%+ reply rate
Do Not Contact
- Check before every list build
- Include competitors, partners, existing customers
- Consider running Extruct search for competitors to auto-populate
Cross-Skill References
The context file is consumed by:hypothesis-building
Reads: ICP, Win Cases, product value propGenerates pain hypotheses from patterns
list-building
Reads: ICP, Win Cases, DNC listUses for query design and seed companies
market-research
Reads: ICP, hypothesesScopes research queries
enrichment-design
Reads: HypothesesDesigns segmentation columns
list-segmentation
Reads: HypothesesMatches companies to hypotheses for tiering
email-prompt-building
Reads: Voice, What We Do, Proof Library, HypothesesBuilds self-contained prompt templates
email-response-simulation
Reads: Voice rulesConstrains rewrites
campaign-sending
Reads: DNC listFilters before upload
Full Schema Template
See the complete template in the source:Example: Extruct Context File
Show example context file (partial)
Show example context file (partial)
Next Steps
context-building Skill
Learn how to create and update context files
Campaign Artifacts
See where context files fit in directory structure
End-to-End Workflow
See how context flows through a campaign
hypothesis-building
Generate pain hypotheses from context