@stephen-lord/docs 1.0.0 → 1.0.1

package/dist-docs/Agent-Skills-for-Context-Engineering/examples/digital-brain-skill/examples/meeting-prep.md

@@ -0,0 +1,243 @@
+# Example: Meeting Preparation Workflow
+
+A complete walkthrough of using Digital Brain for meeting preparation.
+
+---
+
+## Scenario
+
+You have a call with "Sarah Chen" in 30 minutes and need a quick brief.
+
+---
+
+## Step 1: Agent Activates Skill
+
+**User Input**: "Prepare me for my call with Sarah Chen"
+
+**Agent Recognition**:
+- Trigger: "prepare for" + person name → meeting prep
+- Action: Load Digital Brain skill, network module
+
+---
+
+## Step 2: Contact Lookup
+
+Agent searches `network/contacts.jsonl` for "Sarah Chen":
+
+```json
+{
+  "id": "contact_sarahchen",
+  "name": "Sarah Chen",
+  "handle": "@sarahchen_ai",
+  "company": "AI Ventures",
+  "role": "Partner",
+  "circle": "active",
+  "how_met": "She reached out after my thread on agent systems",
+  "relationship": "potential_investor",
+  "topics": ["ai_agents", "investing", "founder_market_fit"],
+  "can_help_with": ["Funding intros", "GTM strategy advice"],
+  "you_can_help_with": ["Technical due diligence", "Agent architecture insights"],
+  "notes": "Very technical for a VC. Former ML engineer at Google. Values depth over polish.",
+  "last_contact": "2024-12-15T00:00:00Z",
+  "links": {
+    "twitter": "https://twitter.com/sarahchen_ai",
+    "linkedin": "https://linkedin.com/in/sarahchen"
+  }
+}
+```
+
+---
+
+## Step 3: Interaction History
+
+Agent filters `network/interactions.jsonl` by `contact_id`:
+
+```json
+// Most recent interaction:
+{
+  "id": "int_20241215_100000",
+  "date": "2024-12-15T10:00:00Z",
+  "contact_id": "contact_sarahchen",
+  "type": "call",
+  "context": "Initial intro call. She's interested in our agent framework approach.",
+  "key_points": [
+    "She liked our context engineering approach",
+    "Asked about moat - I explained skill composability",
+    "She mentioned her portfolio company BuildAI might need our help"
+  ],
+  "follow_ups": [
+    "Send deck with technical architecture",
+    "Intro to BuildAI team"
+  ],
+  "sentiment": "positive"
+}
+
+// Earlier interaction:
+{
+  "id": "int_20241201_140000",
+  "date": "2024-12-01T14:00:00Z",
+  "contact_id": "contact_sarahchen",
+  "type": "dm",
+  "context": "She DMed after my agent systems thread",
+  "key_points": ["Impressed by technical depth", "Asked about investment stage"],
+  "follow_ups": ["Schedule intro call"],
+  "sentiment": "positive"
+}
+```
+
+---
+
+## Step 4: Check Pending Items
+
+Agent scans `operations/todos.md` for Sarah-related items:
+
+```markdown
+### Waiting On
+| Task | Waiting On | Since | Follow Up |
+|------|------------|-------|-----------|
+| BuildAI intro | Sarah Chen | 2024-12-15 | 2024-12-29 |
+
+### P1 - This Week
+- [ ] Send technical deck to Sarah Chen
+```
+
+**Insight**: Follow-up items are overdue!
+
+---
+
+## Step 5: Generate Brief
+
+Agent compiles contextual brief:
+
+```markdown
+# Meeting Brief: Sarah Chen
+
+**When**: Today, [TIME]
+**Who**: Sarah Chen, Partner @ AI Ventures
+**Relationship**: Potential Investor (active circle)
+**Days since last contact**: 14
+
+---
+
+## Quick Context
+- Former ML engineer at Google (technical background)
+- Reached out after your agent systems thread
+- Values depth over polish
+
+---
+
+## Last Conversation (Dec 15)
+- Initial intro call - positive sentiment
+- She liked context engineering approach
+- Asked about moat → explained skill composability
+- Mentioned BuildAI (portfolio company) might need help
+
+---
+
+## Pending Follow-ups ⚠️
+1. **Send technical deck** - Still pending (P1)
+2. **BuildAI intro** - Waiting on her, follow up today
+
+---
+
+## Her Interests
+- Agent architecture
+- Context engineering
+- Technical due diligence
+
+---
+
+## Value Exchange
+- **She can help**: Funding intros, GTM strategy
+- **You can help**: Technical DD, agent architecture
+
+---
+
+## Suggested Talking Points
+1. Apologize for delayed deck, offer to walk through live
+2. Ask about BuildAI intro status
+3. Share recent progress on [relevant feature]
+4. Ask about her investment thesis timeline
+
+---
+
+## Links
+- Twitter: @sarahchen_ai
+- LinkedIn: linkedin.com/in/sarahchen
+```
+
+---
+
+## Step 6: Post-Meeting Logging
+
+After the call, agent helps log to `network/interactions.jsonl`:
+
+**User**: "Just finished with Sarah. She's moving forward with intro to BuildAI and wants to see the deck by Friday."
+
+Agent appends:
+
+```json
+{
+  "id": "int_20241229_143000",
+  "date": "2024-12-29T14:30:00Z",
+  "contact_id": "contact_sarahchen",
+  "type": "call",
+  "context": "Follow-up call. Positive momentum on both fronts.",
+  "key_points": [
+    "She's proceeding with BuildAI intro",
+    "Wants technical deck by Friday",
+    "Mentioned Series A timeline is Q1"
+  ],
+  "follow_ups": [
+    "Send deck by Friday Dec 31",
+    "Expect BuildAI intro next week"
+  ],
+  "sentiment": "positive"
+}
+```
+
+Agent updates `operations/todos.md`:
+
+```markdown
+### P0 - Must Do Today
+- [ ] Send technical deck to Sarah Chen (due: Friday)
+
+### Waiting On
+| Task | Waiting On | Since | Follow Up |
+|------|------------|-------|-----------|
+| BuildAI intro | Sarah Chen | 2024-12-29 | 2025-01-05 |
+```
+
+Agent updates contact's `last_contact`:
+
+```json
+{
+  "id": "contact_sarahchen",
+  ...
+  "last_contact": "2024-12-29T14:30:00Z"
+}
+```
+
+---
+
+## Files Accessed
+
+| File | Purpose | Tokens (~) |
+|------|---------|------------|
+| `SKILL.md` | Routing | 50 |
+| `network/NETWORK.md` | Module instructions | 60 |
+| `network/contacts.jsonl` | Contact lookup | 80 |
+| `network/interactions.jsonl` | History | 150 |
+| `operations/todos.md` | Pending items | 50 |
+
+**Total**: ~390 tokens
+
+---
+
+## Key Takeaways
+
+1. **Context Assembly**: Agent pulls from multiple sources
+2. **Actionable Output**: Brief highlights what to discuss
+3. **Follow-up Tracking**: Pending items surfaced proactively
+4. **Complete Loop**: Meeting → Log → Update todos → Update contact
+5. **Relationship Intelligence**: Notes inform meeting approach

package/dist-docs/Agent-Skills-for-Context-Engineering/examples/digital-brain-skill/identity/IDENTITY.md

@@ -0,0 +1,46 @@
+---
+name: identity-module
+description: Personal brand, voice, values, and positioning. Reference before creating any content or representing the user externally.
+---
+
+# Identity Module
+
+Your digital identity foundation. This module defines who you are, how you communicate, and what you stand for.
+
+## Files in This Module
+
+| File | Purpose |
+|------|---------|
+| `voice.md` | Tone, style, writing patterns |
+| `brand.md` | Positioning, topics, audience |
+| `values.yaml` | Core beliefs and principles |
+| `bio-variants.md` | Different bio lengths for platforms |
+| `prompts/` | Reusable prompts for content generation |
+
+## When to Use
+
+- **Writing any content**: Read `voice.md` first
+- **New platform profile**: Check `bio-variants.md`
+- **Strategic decisions**: Reference `values.yaml`
+- **Content topics**: Consult `brand.md` for positioning
+
+## Agent Instructions
+
+<instructions>
+When creating content for the user:
+1. ALWAYS read voice.md before drafting
+2. Match the energy level, vocabulary, and structural patterns
+3. Avoid words/phrases listed in "never use" section
+4. Incorporate signature phrases naturally
+5. Check brand.md for topic relevance
+</instructions>
+
+## Voice Quick Reference
+
+For detailed voice guidelines, see [voice.md](voice.md).
+
+Key elements agents should internalize:
+- Communication style (formal/casual spectrum)
+- Signature phrases and vocabulary
+- Structural patterns (post formats, hooks)
+- Topics to emphasize vs avoid

package/dist-docs/Agent-Skills-for-Context-Engineering/examples/digital-brain-skill/identity/bio-variants.md

@@ -0,0 +1,101 @@
+# Bio Variants
+
+Pre-written bios for different platforms and contexts.
+
+---
+
+## Twitter/X Bio (160 chars)
+```
+[PLACEHOLDER: Your Twitter bio]
+```
+
+## LinkedIn Headline (120 chars)
+```
+[PLACEHOLDER: Your LinkedIn headline]
+```
+
+## LinkedIn About Section
+```
+[PLACEHOLDER: Your LinkedIn about section - can be longer]
+```
+
+## Newsletter/Substack Bio
+```
+[PLACEHOLDER: 2-3 sentences for newsletter]
+```
+
+## Speaker Bio (Short - 50 words)
+```
+[PLACEHOLDER: For conference programs, short intros]
+```
+
+## Speaker Bio (Long - 150 words)
+```
+[PLACEHOLDER: For detailed speaker pages]
+```
+
+## Podcast Guest Bio
+```
+[PLACEHOLDER: What hosts should read when introducing you]
+```
+
+## Press/Media Bio
+```
+[PLACEHOLDER: Formal bio for press releases]
+```
+
+## Casual Intro
+```
+[PLACEHOLDER: How you introduce yourself at casual events]
+"Hey, I'm [Name]. I [one sentence about what you do]."
+```
+
+## Professional Intro
+```
+[PLACEHOLDER: For formal settings]
+```
+
+---
+
+## Bio Components
+
+### Credentials Block
+```
+[PLACEHOLDER: Your key credentials/achievements to mix and match]
+- [Credential 1]
+- [Credential 2]
+- [Credential 3]
+```
+
+### Personal Touch Block
+```
+[PLACEHOLDER: Human elements - hobbies, location, fun facts]
+- [Personal detail 1]
+- [Personal detail 2]
+```
+
+### CTA Block
+```
+[PLACEHOLDER: Calls to action for different contexts]
+- Newsletter: "Subscribe at [link]"
+- DMs: "DMs open for [topic]"
+- Booking: "Book a call at [link]"
+```
+
+---
+
+## Platform Links
+
+```yaml
+website: "[PLACEHOLDER]"
+twitter: "[PLACEHOLDER]"
+linkedin: "[PLACEHOLDER]"
+newsletter: "[PLACEHOLDER]"
+github: "[PLACEHOLDER]"
+youtube: "[PLACEHOLDER]"
+calendar: "[PLACEHOLDER: Booking link]"
+```
+
+---
+
+*Last updated: [DATE]*

package/dist-docs/Agent-Skills-for-Context-Engineering/examples/digital-brain-skill/identity/brand.md

@@ -0,0 +1,165 @@
+# Personal Brand Strategy
+
+Your positioning, audience, and strategic narrative.
+
+---
+
+## Brand Positioning
+
+### One-Liner
+<!-- How you describe yourself in one sentence -->
+```
+[PLACEHOLDER: e.g., "I help technical founders build in public and grow their audience."]
+```
+
+### Elevator Pitch (30 seconds)
+```
+[PLACEHOLDER: 2-3 sentence expanded version]
+```
+
+### Origin Story
+<!-- Your narrative arc - where you came from, pivotal moments, where you're going -->
+```
+[PLACEHOLDER: Write your founder/creator story]
+```
+
+---
+
+## Target Audience
+
+### Primary Audience
+```yaml
+who: "[PLACEHOLDER: e.g., Early-stage technical founders]"
+pain_points:
+  - "[PLACEHOLDER: e.g., Don't know how to market themselves]"
+  - "[PLACEHOLDER]"
+  - "[PLACEHOLDER]"
+aspirations:
+  - "[PLACEHOLDER: e.g., Build a personal brand that attracts investors/talent]"
+  - "[PLACEHOLDER]"
+where_they_hang_out:
+  - "[PLACEHOLDER: e.g., Twitter, Hacker News, specific Discords]"
+  - "[PLACEHOLDER]"
+```
+
+### Secondary Audiences
+```yaml
+- segment: "[PLACEHOLDER: e.g., Aspiring founders]"
+  relevance: "[PLACEHOLDER: How you serve them]"
+- segment: "[PLACEHOLDER]"
+  relevance: "[PLACEHOLDER]"
+```
+
+---
+
+## Content Pillars
+
+### Primary Topics (80% of content)
+<!-- Topics you're known for and have authority in -->
+
+| Pillar | Description | Example Angles |
+|--------|-------------|----------------|
+| `[PLACEHOLDER: e.g., Building in Public]` | `[Description]` | `[Example topics]` |
+| `[PLACEHOLDER: e.g., AI/Agents]` | `[Description]` | `[Example topics]` |
+| `[PLACEHOLDER]` | `[Description]` | `[Example topics]` |
+
+### Secondary Topics (20% of content)
+<!-- Adjacent topics that round out your brand -->
+```
+- [PLACEHOLDER: e.g., Productivity/Systems]
+- [PLACEHOLDER: e.g., Founder mental health]
+- [PLACEHOLDER]
+```
+
+### Off-Limits Topics
+<!-- Topics you deliberately avoid -->
+```
+- [PLACEHOLDER: e.g., Politics]
+- [PLACEHOLDER: e.g., Competitors by name]
+- [PLACEHOLDER]
+```
+
+---
+
+## Unique Value Proposition
+
+### What Makes You Different
+```
+[PLACEHOLDER: Your unique combination of skills/experience/perspective]
+```
+
+### Credibility Markers
+```yaml
+achievements:
+  - "[PLACEHOLDER: e.g., Built X to $Y ARR]"
+  - "[PLACEHOLDER: e.g., Z followers across platforms]"
+  - "[PLACEHOLDER]"
+experience:
+  - "[PLACEHOLDER: e.g., 10 years in industry]"
+  - "[PLACEHOLDER]"
+social_proof:
+  - "[PLACEHOLDER: e.g., Featured in...]"
+  - "[PLACEHOLDER: e.g., Advised companies like...]"
+```
+
+---
+
+## Brand Voice Alignment
+
+### Emotional Territory
+<!-- How you want people to feel after engaging with your content -->
+```
+[PLACEHOLDER: e.g., "Inspired to take action, equipped with practical knowledge, part of a community"]
+```
+
+### Brand Personality
+```yaml
+if_brand_were_a_person:
+  age: "[PLACEHOLDER]"
+  style: "[PLACEHOLDER: e.g., Smart casual, approachable]"
+  conversation_style: "[PLACEHOLDER: e.g., Like talking to a smart friend]"
+  energy: "[PLACEHOLDER: e.g., High energy but not manic]"
+```
+
+---
+
+## Competitive Positioning
+
+### Similar Voices (Inspiration)
+```
+- [PLACEHOLDER: e.g., @name - what you like about their approach]
+- [PLACEHOLDER]
+```
+
+### Differentiation
+```
+[PLACEHOLDER: How you're different from similar creators/founders]
+```
+
+---
+
+## Growth Strategy
+
+### Current Focus
+```
+[PLACEHOLDER: e.g., Growing Twitter to 50k, launching newsletter]
+```
+
+### Platform Priority
+```yaml
+primary: "[PLACEHOLDER: e.g., Twitter/X]"
+secondary: "[PLACEHOLDER: e.g., LinkedIn]"
+experimenting: "[PLACEHOLDER: e.g., YouTube]"
+```
+
+### Key Metrics
+```yaml
+north_star: "[PLACEHOLDER: e.g., Newsletter subscribers]"
+leading_indicators:
+  - "[PLACEHOLDER: e.g., Engagement rate]"
+  - "[PLACEHOLDER: e.g., Profile visits]"
+```
+
+---
+
+*Last updated: [DATE]*

package/dist-docs/Agent-Skills-for-Context-Engineering/examples/digital-brain-skill/identity/prompts/content-generation.xml

@@ -0,0 +1,46 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<prompt name="content-generation" version="1.0">
+  <description>
+    Master prompt for generating content in user's authentic voice.
+    Load voice.md and brand.md before using.
+  </description>
+
+  <instructions>
+    <context>
+      You are writing as {{USER_NAME}}, a {{USER_DESCRIPTION}}.
+
+      Before generating ANY content:
+      1. Review the voice profile in identity/voice.md
+      2. Check brand positioning in identity/brand.md
+      3. Reference recent successful posts if available
+    </context>
+
+    <voice_guidelines>
+      <formal_casual_level>{{VOICE_LEVEL}}</formal_casual_level>
+      <signature_phrases>
+        <!-- Populated from voice.md -->
+      </signature_phrases>
+      <avoid>
+        <!-- Words/phrases to never use -->
+      </avoid>
+    </voice_guidelines>
+
+    <output_requirements>
+      <format>{{CONTENT_FORMAT}}</format>
+      <platform>{{TARGET_PLATFORM}}</platform>
+      <length>{{TARGET_LENGTH}}</length>
+      <include_cta>{{INCLUDE_CTA}}</include_cta>
+    </output_requirements>
+
+    <quality_checks>
+      - Does this sound like the user's authentic voice?
+      - Is it aligned with their content pillars?
+      - Does it provide value to their target audience?
+      - Is the tone appropriate for the platform?
+    </quality_checks>
+  </instructions>
+
+  <examples>
+    <!-- Agent should pull examples from content/posts.jsonl -->
+  </examples>
+</prompt>

package/dist-docs/Agent-Skills-for-Context-Engineering/examples/digital-brain-skill/identity/prompts/reply-generator.xml

@@ -0,0 +1,40 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<prompt name="reply-generator" version="1.0">
+  <description>
+    Generate authentic replies to comments, DMs, or mentions.
+    Maintains voice while being contextually appropriate.
+  </description>
+
+  <instructions>
+    <context>
+      You are replying as {{USER_NAME}} to a {{CONTEXT_TYPE}}.
+
+      Original message/post being replied to:
+      <original>{{ORIGINAL_CONTENT}}</original>
+
+      Relationship context (if known):
+      <relationship>{{RELATIONSHIP_CONTEXT}}</relationship>
+    </context>
+
+    <reply_principles>
+      - Match the energy of the original (if positive, be positive)
+      - Add value - don't just acknowledge
+      - Be concise on social, more detailed in DMs
+      - If disagreeing, be respectful and constructive
+      - Reference shared context when appropriate
+    </reply_principles>
+
+    <tone_calibration>
+      <public_reply>Slightly more polished, brand-aware</public_reply>
+      <dm_reply>More casual, direct, personal</dm_reply>
+      <comment_reply>Concise, appreciative, engaging</comment_reply>
+    </tone_calibration>
+
+    <output>
+      Provide 2-3 reply options:
+      1. Standard reply
+      2. More casual/playful version
+      3. If appropriate, a version that extends the conversation
+    </output>
+  </instructions>
+</prompt>

package/dist-docs/Agent-Skills-for-Context-Engineering/examples/digital-brain-skill/identity/values.yaml

@@ -0,0 +1,60 @@
+# Core Values & Principles
+# These guide decision-making and content creation
+
+core_values:
+  - name: "[PLACEHOLDER: e.g., Transparency]"
+    description: "[PLACEHOLDER: What this means to you]"
+    in_practice: "[PLACEHOLDER: How this shows up in your work/content]"
+
+  - name: "[PLACEHOLDER: e.g., Ownership]"
+    description: "[PLACEHOLDER]"
+    in_practice: "[PLACEHOLDER]"
+
+  - name: "[PLACEHOLDER: e.g., Continuous Learning]"
+    description: "[PLACEHOLDER]"
+    in_practice: "[PLACEHOLDER]"
+
+  - name: "[PLACEHOLDER]"
+    description: "[PLACEHOLDER]"
+    in_practice: "[PLACEHOLDER]"
+
+beliefs:
+  # Strong opinions you hold
+  - "[PLACEHOLDER: e.g., The best marketing is building great products]"
+  - "[PLACEHOLDER: e.g., AI will augment, not replace, human creativity]"
+  - "[PLACEHOLDER]"
+  - "[PLACEHOLDER]"
+
+contrarian_views:
+  # Views that differ from mainstream in your industry
+  - view: "[PLACEHOLDER: e.g., You don't need VC funding to build a great company]"
+    reasoning: "[PLACEHOLDER: Why you believe this]"
+  - view: "[PLACEHOLDER]"
+    reasoning: "[PLACEHOLDER]"
+
+non_negotiables:
+  # Lines you won't cross
+  - "[PLACEHOLDER: e.g., Won't promote products I haven't used]"
+  - "[PLACEHOLDER: e.g., Won't engage in public negativity about individuals]"
+  - "[PLACEHOLDER]"
+
+principles:
+  content_creation:
+    - "[PLACEHOLDER: e.g., Value over virality]"
+    - "[PLACEHOLDER: e.g., Share learnings, not just wins]"
+    - "[PLACEHOLDER]"
+
+  business:
+    - "[PLACEHOLDER: e.g., Customer success is company success]"
+    - "[PLACEHOLDER]"
+
+  relationships:
+    - "[PLACEHOLDER: e.g., Give before you ask]"
+    - "[PLACEHOLDER: e.g., Be genuinely helpful]"
+    - "[PLACEHOLDER]"
+
+decision_framework:
+  # How you make decisions
+  when_uncertain: "[PLACEHOLDER: e.g., Bias toward action, iterate fast]"
+  priorities: "[PLACEHOLDER: e.g., Impact > Revenue > Growth]"
+  tradeoffs: "[PLACEHOLDER: e.g., Long-term reputation over short-term gains]"