@stephen-lord/docs 1.0.0 → 1.0.1

package/dist-docs/Agent-Skills-for-Context-Engineering/examples/digital-brain-skill/references/file-formats.md

@@ -0,0 +1,386 @@
+# File Format Reference
+
+Detailed specifications for each file format used in Digital Brain.
+
+---
+
+## JSONL Files
+
+### Schema Convention
+
+Every JSONL file starts with a schema definition line:
+
+```json
+{"_schema": "schema_name", "_version": "1.0", "_description": "Purpose of this file"}
+```
+
+This line is skipped during data processing but documents the expected structure.
+
+### Common Fields
+
+All data entries should include:
+
+```json
+{
+  "id": "type_YYYYMMDD_HHMMSS",  // Unique identifier
+  "created": "ISO8601",           // Creation timestamp
+  "updated": "ISO8601"            // Last modification (optional)
+}
+```
+
+### ideas.jsonl
+
+```json
+{
+  "id": "idea_20241229_143022",
+  "created": "2024-12-29T14:30:22Z",
+  "idea": "Content of the idea",
+  "source": "observation|conversation|reading|shower_thought",
+  "pillar": "content_pillar_name",
+  "status": "raw|developing|ready|published|archived",
+  "priority": "high|medium|low",
+  "notes": "Additional context",
+  "tags": ["tag1", "tag2"]
+}
+```
+
+### posts.jsonl
+
+```json
+{
+  "id": "post_20241229_160000",
+  "published": "2024-12-29T16:00:00Z",
+  "platform": "twitter|linkedin|newsletter|blog|youtube",
+  "type": "post|thread|article|video|podcast",
+  "content": "Full content or summary",
+  "url": "https://...",
+  "pillar": "content_pillar_name",
+  "metrics": {
+    "impressions": 0,
+    "likes": 0,
+    "comments": 0,
+    "reposts": 0,
+    "saves": 0
+  },
+  "metrics_updated": "2024-12-29T20:00:00Z",
+  "notes": "What worked/didn't",
+  "tags": ["tag1", "tag2"]
+}
+```
+
+### contacts.jsonl
+
+```json
+{
+  "id": "contact_johndoe",
+  "created": "2024-01-15T00:00:00Z",
+  "updated": "2024-12-29T00:00:00Z",
+  "name": "John Doe",
+  "handle": "@johndoe",
+  "email": "john@example.com",
+  "company": "Acme Inc",
+  "role": "CEO",
+  "location": "San Francisco, USA",
+  "circle": "inner|active|network|dormant",
+  "how_met": "Met at conference",
+  "relationship": "friend|mentor|peer|collaborator|investor|customer",
+  "topics": ["ai", "startups"],
+  "can_help_with": ["intros to VCs"],
+  "you_can_help_with": ["technical advice"],
+  "notes": "Personal context",
+  "last_contact": "2024-12-15T00:00:00Z",
+  "links": {
+    "twitter": "https://twitter.com/johndoe",
+    "linkedin": "https://linkedin.com/in/johndoe",
+    "website": "https://johndoe.com"
+  }
+}
+```
+
+### interactions.jsonl
+
+```json
+{
+  "id": "int_20241229_100000",
+  "date": "2024-12-29T10:00:00Z",
+  "contact_id": "contact_johndoe",
+  "type": "call|coffee|dm|email|event|collab",
+  "context": "Discussed partnership opportunity",
+  "key_points": ["Point 1", "Point 2"],
+  "follow_ups": ["Send proposal", "Intro to Sarah"],
+  "sentiment": "positive|neutral|needs_attention"
+}
+```
+
+### bookmarks.jsonl
+
+```json
+{
+  "id": "bm_20241229_120000",
+  "saved_at": "2024-12-29T12:00:00Z",
+  "url": "https://example.com/article",
+  "title": "Article Title",
+  "source": "article|video|podcast|tool|tweet|paper",
+  "category": "ai_agents|building|growth|productivity|leadership|industry|personal",
+  "summary": "1-2 sentence summary",
+  "key_insights": ["Insight 1", "Insight 2"],
+  "status": "unread|read|reviewed|archived",
+  "rating": 1-5,
+  "tags": ["tag1", "tag2"]
+}
+```
+
+### meetings.jsonl
+
+```json
+{
+  "id": "mtg_20241229_140000",
+  "date": "2024-12-29T14:00:00Z",
+  "title": "Meeting Title",
+  "type": "1on1|team|external|interview|pitch|advisory",
+  "attendees": ["John Doe", "Jane Smith"],
+  "duration_mins": 30,
+  "agenda": ["Topic 1", "Topic 2"],
+  "notes": "Discussion summary",
+  "decisions": ["Decision made"],
+  "action_items": [
+    {"task": "Task description", "owner": "John", "due": "2024-12-31"}
+  ],
+  "follow_up": "Next steps"
+}
+```
+
+### metrics.jsonl
+
+```json
+{
+  "id": "metrics_20241229",
+  "week_of": "2024-12-23",
+  "recorded_at": "2024-12-29T00:00:00Z",
+  "audience": {
+    "twitter_followers": 5000,
+    "newsletter_subscribers": 1200,
+    "linkedin_connections": 3000,
+    "youtube_subscribers": 500
+  },
+  "engagement": {
+    "avg_impressions": 10000,
+    "avg_engagement_rate": 0.05,
+    "newsletter_open_rate": 0.45
+  },
+  "content": {
+    "posts_published": 7,
+    "threads_published": 2,
+    "newsletters_sent": 1
+  },
+  "business": {
+    "revenue": 0,
+    "mrr": 0,
+    "customers": 0,
+    "leads": 5
+  },
+  "personal": {
+    "deep_work_hours": 25,
+    "exercise_sessions": 4,
+    "books_read": 0.5
+  },
+  "notes": "Strong week for content"
+}
+```
+
+---
+
+## YAML Files
+
+### values.yaml
+
+```yaml
+core_values:
+  - name: "Value Name"
+    description: "What it means"
+    in_practice: "How it shows up"
+
+beliefs:
+  - "Belief statement"
+
+contrarian_views:
+  - view: "The view"
+    reasoning: "Why you hold it"
+
+non_negotiables:
+  - "Line you won't cross"
+
+principles:
+  content_creation:
+    - "Principle"
+  business:
+    - "Principle"
+```
+
+### goals.yaml
+
+```yaml
+current_period:
+  quarter: "Q1 2025"
+  theme: "Growth focus"
+
+objectives:
+  - objective: "Objective statement"
+    why: "Why it matters"
+    key_results:
+      - description: "KR description"
+        target: 100
+        current: 25
+        unit: "followers"
+        status: "on_track|at_risk|behind|completed"
+
+north_star:
+  metric: "The one metric"
+  current: 1000
+  target: 10000
+  why: "Why this matters most"
+```
+
+### learning.yaml
+
+```yaml
+current_focus:
+  skill: "Skill name"
+  why: "Why learning this"
+  target_level: "Target proficiency"
+  deadline: "2025-03-31"
+
+skills:
+  - name: "Skill name"
+    category: "technical|creative|business|personal"
+    current_level: "beginner|intermediate|advanced|expert"
+    target_level: "Target"
+    status: "learning|practicing|maintaining"
+    resources:
+      - type: "course|book|tutorial|project"
+        title: "Resource name"
+        url: "https://..."
+        status: "not_started|in_progress|completed"
+    milestones:
+      - "Milestone description"
+    last_practiced: "2024-12-29"
+```
+
+### circles.yaml
+
+```yaml
+circles:
+  inner:
+    description: "Close relationships"
+    touchpoint_frequency: "weekly"
+    members:
+      - "Name - context"
+
+  active:
+    description: "Current collaborators"
+    touchpoint_frequency: "bi-weekly"
+    members:
+      - "Name - context"
+
+groups:
+  founders:
+    description: "Fellow founders"
+    members:
+      - "Name"
+
+goals:
+  this_quarter:
+    - "Relationship goal"
+```
+
+---
+
+## Markdown Files
+
+### Structure Convention
+
+All markdown files follow this structure:
+
+```markdown
+# Title
+
+Brief description.
+
+---
+
+## Section 1
+
+Content...
+
+---
+
+## Section 2
+
+Content...
+
+---
+
+*Last updated: [DATE]*
+```
+
+### Placeholder Convention
+
+Use `[PLACEHOLDER: description]` for user-fillable fields:
+
+```markdown
+### Your Story
+```
+[PLACEHOLDER: Write your founder journey here]
+```
+```
+
+---
+
+## XML Files
+
+### Prompt Template Structure
+
+```xml
+<?xml version="1.0" encoding="UTF-8"?>
+<prompt name="prompt-name" version="1.0">
+  <description>
+    What this prompt does
+  </description>
+
+  <instructions>
+    <context>
+      Background for the task
+    </context>
+
+    <guidelines>
+      Rules to follow
+    </guidelines>
+
+    <output_requirements>
+      Expected output format
+    </output_requirements>
+  </instructions>
+
+  <examples>
+    Input/output examples
+  </examples>
+</prompt>
+```
+
+---
+
+## ID Generation
+
+### Convention
+
+`{type}_{YYYYMMDD}_{HHMMSS}` or `{type}_{unique_slug}`
+
+Examples:
+- `idea_20241229_143022`
+- `contact_johndoe`
+- `post_20241229_160000`
+- `bm_20241229_120000`
+
+### Uniqueness
+
+IDs must be unique within their file. Timestamp-based IDs ensure uniqueness for time-series data.

package/dist-docs/Agent-Skills-for-Context-Engineering/examples/digital-brain-skill/scripts/install.sh

@@ -0,0 +1,79 @@
+#!/bin/bash
+# Digital Brain Installation Script
+# Installs Digital Brain as a Claude Code skill
+
+set -e
+
+SKILL_NAME="digital-brain"
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+BRAIN_DIR="$(dirname "$SCRIPT_DIR")"
+
+# Colors
+GREEN='\033[0;32m'
+BLUE='\033[0;34m'
+NC='\033[0m' # No Color
+
+echo -e "${BLUE}Digital Brain Installer${NC}"
+echo "========================"
+echo ""
+
+# Detect installation type
+echo "Where would you like to install Digital Brain?"
+echo ""
+echo "1) User-wide (recommended) - ~/.claude/skills/"
+echo "2) Current project only   - ./.claude/skills/"
+echo "3) Custom location"
+echo ""
+read -p "Enter choice [1-3]: " choice
+
+case $choice in
+    1)
+        TARGET_DIR="$HOME/.claude/skills/$SKILL_NAME"
+        ;;
+    2)
+        TARGET_DIR="./.claude/skills/$SKILL_NAME"
+        ;;
+    3)
+        read -p "Enter custom path: " custom_path
+        TARGET_DIR="$custom_path/$SKILL_NAME"
+        ;;
+    *)
+        echo "Invalid choice. Exiting."
+        exit 1
+        ;;
+esac
+
+# Create target directory
+mkdir -p "$(dirname "$TARGET_DIR")"
+
+# Check if already exists
+if [ -d "$TARGET_DIR" ]; then
+    read -p "Directory exists. Overwrite? [y/N]: " overwrite
+    if [ "$overwrite" != "y" ] && [ "$overwrite" != "Y" ]; then
+        echo "Installation cancelled."
+        exit 0
+    fi
+    rm -rf "$TARGET_DIR"
+fi
+
+# Copy files
+echo ""
+echo "Installing to: $TARGET_DIR"
+cp -r "$BRAIN_DIR" "$TARGET_DIR"
+
+# Remove install script from target (not needed there)
+rm -f "$TARGET_DIR/scripts/install.sh"
+
+echo ""
+echo -e "${GREEN}Installation complete!${NC}"
+echo ""
+echo "Next steps:"
+echo "1. Navigate to your Digital Brain: cd $TARGET_DIR"
+echo "2. Start with identity/voice.md - define your voice"
+echo "3. Fill out identity/brand.md - your positioning"
+echo "4. Add contacts to network/contacts.jsonl"
+echo "5. Capture ideas in content/ideas.jsonl"
+echo ""
+echo "Claude Code will automatically discover the skill."
+echo "Try: 'Help me write a post in my voice'"
+echo ""