Self-evolving second brain with 35 AI skills, 10 agents, and people CRM. Closed-loop harness: a V-model verification lifecycle where the worker never grades its own homework. Plus paired anti-slop design skills for marketing and product UI. Works with Claude Code, Cursor, Kiro, Gemini CLI, Codex.
Python agent-loopagent-pluginsagent-skillsagenticai-agentsclaude-codeclosed-loopcursorgarry-tangbraingstackknowledge-managementloop-engineeringobsidianpeople-crmproductivitysecond-brainself-evolvingverification-harnessworker-agents
Add planning and submission documents
Huy Tieu6e68466edeb3
diff --git a/.claude/IMPLEMENTATION-TODO.md b/.claude/IMPLEMENTATION-TODO.mdnew file mode 100644index 0000000..0193800--- /dev/null+++ b/.claude/IMPLEMENTATION-TODO.md@@ -0,0 +1,981 @@+# COG Second Brain - Implementation TODO++**Created:** 2025-10-31+**Purpose:** Step-by-step implementation guide for skills migration+**Estimated Time:** 4-6 hours for complete implementation++---++## Overview++This document provides detailed, actionable steps to migrate the Light-Personal-Agent skills architecture to COG-second-brain as a generic, reusable system.++**Prerequisites:**+- Light-Personal-Agent skills fully read and analyzed ✅+- Migration plan reviewed and approved+- Decision made on which skills to include++---++## Phase 1: Core Infrastructure Setup++### 1.1 Create Directory Structure++```bash+# Navigate to COG-second-brain+cd "/Users/huy.tieu/Library/Mobile Documents/iCloud~md~obsidian/Documents/COG-second-brain"++# Create .claude/skills directory structure+mkdir -p .claude/skills/{obsidian-workspace,domain-classifier,braindump-processor,strategic-analyst}+mkdir -p .claude/skills/{content-analyzer,meeting-processor,news-curator,social-media-publisher}+mkdir -p .claude/skills/templates/{project-intelligence,content-publisher}++# Create vault directory structure+mkdir -p 00-inbox+mkdir -p 01-daily/{briefs,checkins}+mkdir -p 02-personal/{braindumps,goals,knowledge,resources}+mkdir -p 03-professional/{braindumps,knowledge,meetings,resources}+mkdir -p 04-projects/_project-template/{braindumps,competitive,knowledge,meetings}+mkdir -p 05-knowledge+```++**Estimated Time:** 5 minutes++---++### 1.2 Create Skills README++**File:** `.claude/skills/README.md`++**Content Summary:**+- Overview of skills architecture+- How skills activate automatically+- List of available skills+- Integration between skills+- How to customize or add new skills++**Todo:**+- [ ] Copy obsidian-workspace skill structure as reference+- [ ] Write general overview of autonomous skills+- [ ] Document skill activation triggers+- [ ] Explain skill integration patterns+- [ ] Add troubleshooting section++**Estimated Time:** 30 minutes++---++### 1.3 Create Customization Guide++**File:** `.claude/skills/CUSTOMIZATION-GUIDE.md`++**Content Summary:**+- How to modify existing skills+- How to create custom skills+- How to configure interests/projects+- Template usage instructions+- Best practices++**Todo:**+- [ ] Explain YAML frontmatter customization+- [ ] Document skill modification process+- [ ] Provide examples of customization+- [ ] Show how to add project-specific skills+- [ ] Include troubleshooting tips++**Estimated Time:** 45 minutes++---++## Phase 2: Core Skills (Priority 1)++### 2.1 Obsidian Workspace Skill++**File:** `.claude/skills/obsidian-workspace/SKILL.md`++**Source:** Light-Personal-Agent `.claude/skills/obsidian-workspace/SKILL.md`++**Changes to Make:**+- [ ] Replace "Light-Personal-Agent" with "COG-second-brain" in vault structure+- [ ] Remove Scout AI references in examples+- [ ] Genericize project examples (use placeholders like [project-name])+- [ ] Update file paths to COG structure+- [ ] Keep all YAML standards (those are universal)+- [ ] Keep markdown formatting standards+- [ ] Keep domain classification references++**Specific Replacements:**+```+FIND: Light-Personal-Agent/+REPLACE: COG-second-brain/++FIND: scout-ai+REPLACE: [project-name]++FIND: Scout+REPLACE: [Your Project]++FIND: Katalon, Ghostship, Mabl (any company names)+REPLACE: [Company], [Competitor A], [Competitor B]+```++**Estimated Time:** 20 minutes++---++### 2.2 Domain Classifier Skill++**File:** `.claude/skills/domain-classifier/SKILL.md`++**Source:** Light-Personal-Agent `.claude/skills/domain-classifier/SKILL.md`++**Changes to Make:**+- [ ] Keep domain framework exactly as-is (universal)+- [ ] Replace Scout AI example with generic project example+- [ ] Remove Katalon, Scout-specific keywords from project detection+- [ ] Update examples to use generic project names+- [ ] Keep all confidence triggers and scoring logic+- [ ] Keep privacy protection rules+- [ ] Keep cross-domain connection strategy++**Specific Replacements:**+```+FIND: Scout AI, Scout+REPLACE: [Project Name]++FIND: AI testing, automated testing product, Ghostship (competitor)+REPLACE: [Your domain], [Your product description], [Competitor]++FIND: scout-ai/+REPLACE: [project-name]/+```++**Estimated Time:** 15 minutes++---++### 2.3 Braindump Processor Skill++**File:** `.claude/skills/braindump-processor/SKILL.md`++**Source:** Light-Personal-Agent `.claude/skills/braindump-processor/SKILL.md`++**Changes to Make:**+- [ ] Keep processing framework (universal)+- [ ] Remove Scout competitor detection examples+- [ ] Make competitive intelligence detection generic with user-configurable keywords+- [ ] Replace Scout/Katalon references with placeholders+- [ ] Keep theme extraction methodology+- [ ] Keep action item identification+- [ ] Keep emotional context detection+- [ ] Update file path examples++**Specific Section Changes:**++**Competitive Intelligence Detection (lines ~60-75):**+```markdown+# BEFORE (Scout-specific):+**Trigger Keywords**: Ghostship, Mabl, Testers.ai, TestSprite, QA.tech, Scout AI...++# AFTER (Generic):+**Trigger Keywords**: [User configures in project-intelligence skill]+**Action**: Extract competitor information to `04-projects/[project]/competitive/[competitor-name].md`+```++**Examples:**+```+FIND: Scout examples+REPLACE: Generic project examples++FIND: Specific competitor names+REPLACE: [Competitor A], [Competitor B], etc.+```++**Estimated Time:** 25 minutes++---++### 2.4 Strategic Analyst Skill++**File:** `.claude/skills/strategic-analyst/SKILL.md`++**Source:** Light-Personal-Agent `.claude/skills/strategic-analyst/SKILL.md`++**Changes to Make:**+- [ ] Keep ALL frameworks as-is (SWOT, JTBD, First Principles, ICE, RICE, etc.)+- [ ] Replace Scout AI examples with generic product examples+- [ ] Replace Ghostship competitor with [Competitor A]+- [ ] Genericize all scenarios+- [ ] Keep framework selection logic+- [ ] Keep output standards+- [ ] Keep quality standards++**Specific Examples to Update:**++**Example 1 (lines ~516-521):**+```markdown+# BEFORE:+"We have three features we could build next for Scout: AI test generation..."++# AFTER:+"We have three features we could build next for [Product]: Feature A, Feature B, Feature C..."+```++**Example 2 (lines ~526-531):**+```markdown+# BEFORE:+"Ghostship just raised $10M..."++# AFTER:+"[Competitor A] just raised $XM and launched a feature that competes with our roadmap..."+```++**Estimated Time:** 20 minutes++---++## Phase 3: Content Skills (Priority 2)++### 3.1 Content Analyzer Skill++**File:** `.claude/skills/content-analyzer/SKILL.md`++**Source:** Light-Personal-Agent `.claude/skills/content-analyzer/SKILL.md`++**Changes to Make:**+- [ ] Keep analysis framework (universal)+- [ ] Remove scout-intelligence integration references+- [ ] Genericize domain examples+- [ ] Replace Scout-specific examples with generic ones+- [ ] Keep quality standards+- [ ] Keep verification protocols+- [ ] Keep knowledge integration logic++**Specific Changes:**+```+FIND: scout-intelligence references+REPLACE: project-intelligence (if skill exists) or remove++FIND: Scout-specific examples+REPLACE: Generic product/project examples++FIND: Technical Article on AI Testing (example)+REPLACE: Technical Article on [Your Domain Topic]+```++**Estimated Time:** 20 minutes++---++### 3.2 Meeting Processor Skill++**File:** `.claude/skills/meeting-processor/SKILL.md`++**Source:** Light-Personal-Agent `.claude/skills/meeting-processor/SKILL.md`++**Changes to Make:**+- [ ] Keep processing framework entirely (universal)+- [ ] Replace Scout meeting examples with generic ones+- [ ] Remove specific names (Tom, Thanh, Huy, etc.)+- [ ] Genericize project references+- [ ] Keep content filtering rules+- [ ] Keep team dynamics assessment+- [ ] Keep decision extraction logic++**Specific Changes:**+```+FIND: Tom, Thanh, Huy, John, Sarah (any specific names)+REPLACE: [Team Member A], [Team Member B], [Manager], etc.++FIND: Scout positioning discussion+REPLACE: [Product] strategy discussion++FIND: scout-intelligence applies+REPLACE: project-intelligence applies (if user has it)+```++**Estimated Time:** 15 minutes++---++### 3.3 News Curator Skill++**File:** `.claude/skills/news-curator/SKILL.md`++**Source:** Light-Personal-Agent `.claude/skills/news-curator/SKILL.md`++**Changes to Make:**+- [ ] Keep verification standards (universal)+- [ ] Remove Scout AI-specific interest defaults+- [ ] Make interest areas user-configurable+- [ ] Genericize industry examples+- [ ] Keep source credibility framework+- [ ] Keep strategic relevance analysis+- [ ] Keep error handling for no news found++**Specific Changes:**++**Interest Profiling (lines ~82-110):**+```markdown+# BEFORE (Scout-specific):+### Industry-Specific+- [User's industry] developments ← Keep this approach+- AI testing, QA platforms, etc. ← Remove specifics++# AFTER (Generic with examples):+### Industry-Specific (User Configures)+- [Your industry] developments+- Examples: AI/ML, SaaS, Healthcare, Finance, etc.+- Configured via daily-brief command parameters+```++**Example Updates:**+```+FIND: Scout AI focus, Ghostship, Mabl+REPLACE: [Your Product], [Competitor A], [Competitor B]++FIND: AI testing platform news+REPLACE: [Your industry] news+```++**Estimated Time:** 25 minutes++---++## Phase 4: Optional/Social Skills (Priority 3)++### 4.1 Social Media Publisher Skill++**File:** `.claude/skills/social-media-publisher/SKILL.md`++**Source:** Light-Personal-Agent `.claude/skills/social-media-publisher/SKILL.md`++**Changes to Make:**+- [ ] Keep platform formatting rules (universal)+- [ ] Remove Scout-specific examples+- [ ] Genericize audience targeting examples+- [ ] Keep voice and tone guidelines+- [ ] Keep platform-specific structures+- [ ] Update content type examples++**Specific Changes:**++**Audience Keywords (lines ~230-255):**+```markdown+# Keep structure but make examples generic++### Keywords for [Your Audience]+- [Your domain keywords]+- [Your industry terms]+```++**Examples:**+```+FIND: Technical Article on AI Testing+REPLACE: Technical Article on [Your Topic]++FIND: Scout strategy case study+REPLACE: [Product] strategy case study++FIND: QA/Testers specific examples+REPLACE: [Your Target Audience] examples+```++**Estimated Time:** 20 minutes++---++## Phase 5: Template Skills (Priority 4)++### 5.1 Project Intelligence Template++**File:** `.claude/skills/templates/project-intelligence/SKILL-TEMPLATE.md`++**Source:** Light-Personal-Agent `.claude/skills/scout-intelligence/SKILL.md`++**Changes to Make:**+- [ ] Convert entire skill to template format+- [ ] Add [PLACEHOLDER] markers for user to fill in+- [ ] Keep structure and logic+- [ ] Add inline instructions+- [ ] Create sections for user customization++**Template Structure:**+```markdown+---+name: [YOUR-PROJECT]-intelligence+description: [DESCRIBE YOUR PROJECT CONTEXT]+---++# [YOUR PROJECT NAME] Intelligence Skill++## Purpose+[DESCRIBE WHAT THIS SKILL DOES FOR YOUR PROJECT]++## When This Skill Activates+- Mentions of "[YOUR PROJECT NAME]", "[YOUR PRODUCT]"+- [ADD YOUR TRIGGER KEYWORDS]++## Project Context++### Product Overview+**[YOUR PROJECT NAME]** is [DESCRIBE YOUR PROJECT]++**Core Value Proposition:**+- [VALUE PROP 1]+- [VALUE PROP 2]+- [VALUE PROP 3]++**Target Market:**+- [TARGET CUSTOMER 1]+- [TARGET CUSTOMER 2]++### Key Competitive Differentiators+1. **[DIFFERENTIATOR 1]**: [Description]+2. **[DIFFERENTIATOR 2]**: [Description]++## Competitive Landscape++### Primary Competitors++#### [Competitor 1 Name]+**Positioning:** [How they position]+**Strengths:**+- [Strength 1]+- [Strength 2]++**Weaknesses:**+- [Weakness 1]+- [Weakness 2]++**Our Response:**+- [How we respond]++**Monitoring:**+- [What to track]++[REPEAT FOR OTHER COMPETITORS]++## Strategic Framework for [YOUR PROJECT]+[FILL IN YOUR POSITIONING STRATEGY]++## Technical Architecture Context+[FILL IN YOUR TECH STACK AND DECISIONS]++## Product Roadmap Context+[FILL IN FEATURES AND PRIORITIES]++## Automatic Processing Rules++### Trigger Keywords+- [Your project name]+- [Your product features]+- [Your competitor names]+- [Your domain terms]++### Auto-Actions+[KEEP STRUCTURE FROM SCOUT-INTELLIGENCE, BUT USER FILLS IN SPECIFICS]+```++**Estimated Time:** 45 minutes++---++### 5.2 Project Intelligence Instructions++**File:** `.claude/skills/templates/project-intelligence/CUSTOMIZATION-INSTRUCTIONS.md`++**Content:**+```markdown+# How to Customize Project Intelligence Skill++## Step 1: Copy Template+1. Copy `SKILL-TEMPLATE.md` to `.claude/skills/[your-project]-intelligence/SKILL.md`+2. Rename to match your project (e.g., `my-saas-intelligence`)++## Step 2: Fill in Project Details+Search for ALL `[PLACEHOLDER]` markers and replace:+- `[YOUR PROJECT NAME]` → Your actual project name+- `[YOUR PRODUCT]` → Your product description+- `[Competitor 1]` → Your actual competitor names+- `[YOUR TECH STACK]` → Your technologies++## Step 3: Configure Trigger Keywords+Add your specific keywords that should activate this skill:+- Project names+- Product features+- Competitor names+- Domain terminology++## Step 4: Add Competitive Intelligence+Fill in competitor sections:+- Who are they?+- What are their strengths/weaknesses?+- How do you respond?+- What should you monitor?++## Step 5: Test Activation+Try mentioning your project name in a braindump and verify:+- Skill activates automatically+- Content routes to correct domain+- Competitive intelligence extracted properly++## Examples+See `EXAMPLE.md` for a filled-in template example.+```++**Estimated Time:** 15 minutes++---++### 5.3 Project Intelligence Example++**File:** `.claude/skills/templates/project-intelligence/EXAMPLE.md`++**Content:**+Create a fictional example project (e.g., "Acme SaaS Platform") with the template fully filled in to show users what a completed project-intelligence skill looks like.++**Estimated Time:** 30 minutes++---++### 5.4 Content Publisher Template++**File:** `.claude/skills/templates/content-publisher/SKILL-TEMPLATE.md`++**Source:** Light-Personal-Agent `.claude/skills/confluence-publisher/SKILL.md`++**Changes to Make:**+- [ ] Convert to generic template+- [ ] Replace Confluence-specific with [DESTINATION]+- [ ] Add placeholders for authentication+- [ ] Keep markup conversion logic as examples+- [ ] Add instructions for different platforms++**Template Structure:**+```markdown+---+name: content-publisher-[DESTINATION]+description: Publish content to [YOUR PLATFORM]+allowed-tools: [YOUR MCP TOOLS OR APIs]+---++# Content Publisher to [DESTINATION] Skill++## Purpose+Publish content from COG-second-brain to [YOUR DESTINATION]++## Destination Configuration++### Platform+**Platform:** [Confluence | Notion | WordPress | GitHub Pages | etc.]+**Authentication:** [How you authenticate]+**Base URL:** [Your platform URL]++### Publishing Targets+**Primary:** [Where content goes by default]+**Secondary:** [Alternative locations]++## Markup Conversion++### [Source Format] → [Destination Format]+[USER FILLS IN CONVERSION RULES]++Examples:+- Markdown → Confluence: [rules]+- Markdown → Notion: [rules]+- Markdown → HTML: [rules]++## Content Adaptation+[HOW TO ADAPT FOR YOUR AUDIENCE]++## Publishing Workflow+[YOUR SPECIFIC WORKFLOW]++## Error Handling+[PLATFORM-SPECIFIC ERROR HANDLING]+```++**Estimated Time:** 40 minutes++---++### 5.5 Content Publisher Instructions & Example++**Files:**+- `.claude/skills/templates/content-publisher/CUSTOMIZATION-INSTRUCTIONS.md`+- `.claude/skills/templates/content-publisher/EXAMPLE.md`++**Similar approach to project-intelligence above**++**Estimated Time:** 45 minutes (both files)++---++## Phase 6: Documentation (Priority 5)++### 6.1 Main Vault README++**File:** `README.md` (root of COG-second-brain)++**Content:**+```markdown+# COG Second Brain++Your personal AI-powered second brain system with autonomous skills.++## What is This?++COG-second-brain is an Obsidian vault with integrated Claude Code skills that:+- ✅ Automatically processes your thoughts and ideas+- ✅ Classifies content into appropriate domains+- ✅ Applies strategic frameworks to your decisions+- ✅ Curates personalized news briefings+- ✅ Analyzes meetings and extracts insights+- ✅ Builds consolidated knowledge over time++## Quick Start++1. **Capture Thoughts:** Use `/braindump` command+2. **Daily Brief:** Use `/daily-brief` for curated news+3. **Analyze Content:** Share URLs for analysis+4. **Process Meetings:** Share transcripts for insights++## Vault Structure++[DESCRIBE FOLDER STRUCTURE]++## Skills System++See `.claude/skills/README.md` for complete skills documentation.++Available skills:+- `obsidian-workspace` - Vault management+- `domain-classifier` - Content organization+- `braindump-processor` - Thought processing+- `strategic-analyst` - Strategic frameworks+- `content-analyzer` - Article analysis+- `meeting-processor` - Meeting insights+- `news-curator` - Personalized briefings+- `social-media-publisher` - Social content creation++## Customization++See `.claude/skills/CUSTOMIZATION-GUIDE.md` for:+- How to add your projects+- How to configure interests+- How to create custom skills++## Privacy++All processing happens locally. No external services required (except optional publishing).+```++**Estimated Time:** 30 minutes++---++### 6.2 Project Template README++**File:** `04-projects/_project-template/README.md`++**Content:**+```markdown+# Project Template++## How to Use This Template++1. **Copy this folder:** `cp -r _project-template your-project-name`+2. **Rename folders:** Update to match your project+3. **Create project-intelligence skill:** See `.claude/skills/templates/project-intelligence/`+4. **Start capturing:** Use `/braindump` and mention your project++## Folder Structure++- `braindumps/` - Raw project thoughts and ideas+ - `analysis/` - Processed strategic analysis+- `competitive/` - Competitor intelligence files+ - Each competitor gets own file: `competitor-name.md`+- `knowledge/` - Consolidated project knowledge+- `meetings/` - Project-specific meeting notes++## Integration with Skills++When you mention your project name:+- Content automatically routes here+- `project-intelligence` skill activates+- Competitive intelligence extracted+- Strategic analysis applied++## Best Practices++[ADD PROJECT MANAGEMENT BEST PRACTICES]+```++**Estimated Time:** 20 minutes++---++### 6.3 Individual Skill READMEs++**Files:** Each skill folder needs a `README.md`++**Template:**+```markdown+# [Skill Name] Skill++## Overview+[Brief description of what this skill does]++## When It Activates+[Trigger conditions]++## What It Does+[Key capabilities]++## Configuration+[How to customize, if applicable]++## Integration+[Which other skills it works with]++## Examples+[Usage examples]++## Troubleshooting+[Common issues and solutions]+```++**Todo:**+- [ ] Create README for obsidian-workspace+- [ ] Create README for domain-classifier+- [ ] Create README for braindump-processor+- [ ] Create README for strategic-analyst+- [ ] Create README for content-analyzer+- [ ] Create README for meeting-processor+- [ ] Create README for news-curator+- [ ] Create README for social-media-publisher++**Estimated Time:** 10 minutes each (80 minutes total)++---++## Phase 7: Commands Migration++### 7.1 Update Daily Brief Command++**File:** `.claude/commands/daily-brief.md`++**Changes:**+- [ ] Already updated in previous session ✅+- [ ] Verify it references generic interests, not Scout-specific+- [ ] Ensure it works with generic news-curator skill++**Estimated Time:** 5 minutes (verification only)++---++### 7.2 Update Braindump Command++**File:** `.claude/commands/braindump.md`++**Changes:**+- [ ] Already updated in previous session ✅+- [ ] Remove Scout competitor detection from examples+- [ ] Make competitive intelligence detection generic+- [ ] Update file paths to COG structure++**Estimated Time:** 10 minutes++---++### 7.3 Other Commands++**Files to review:**+- `.claude/commands/brain-dump-analysis.md`+- `.claude/commands/link.md` (if exists)+- Any other custom commands++**Changes:**+- [ ] Remove Scout/company-specific references+- [ ] Genericize examples+- [ ] Update file paths++**Estimated Time:** 15 minutes each++---++## Phase 8: Testing & Validation++### 8.1 Skill Activation Testing++**Todo:**+- [ ] Test `/braindump` command - verify braindump-processor activates+- [ ] Test domain classification - verify content routes correctly+- [ ] Test strategic analysis - try SWOT or RICE framework+- [ ] Test `/daily-brief` - verify news curation works+- [ ] Test content analysis - share a URL+- [ ] Test meeting processing - share transcript++**Estimated Time:** 30 minutes++---++### 8.2 Integration Testing++**Todo:**+- [ ] Verify skills work together (e.g., braindump → domain-classifier → obsidian-workspace)+- [ ] Test cross-domain connections+- [ ] Verify metadata consistency+- [ ] Check file organization++**Estimated Time:** 20 minutes++---++### 8.3 Documentation Review++**Todo:**+- [ ] Read through all READMEs+- [ ] Verify examples are clear+- [ ] Test customization instructions+- [ ] Check all links work++**Estimated Time:** 30 minutes++---++## Implementation Checklist++### Phase 1: Core Infrastructure ⏱️ ~2 hours+- [ ] 1.1 Create directory structure (5 min)+- [ ] 1.2 Create skills README (30 min)+- [ ] 1.3 Create customization guide (45 min)+- [ ] 2.1 Obsidian workspace skill (20 min)+- [ ] 2.2 Domain classifier skill (15 min)+- [ ] 2.3 Braindump processor skill (25 min)+- [ ] 2.4 Strategic analyst skill (20 min)++### Phase 2: Content Skills ⏱️ ~1 hour+- [ ] 3.1 Content analyzer skill (20 min)+- [ ] 3.2 Meeting processor skill (15 min)+- [ ] 3.3 News curator skill (25 min)++### Phase 3: Optional Skills ⏱️ ~20 min+- [ ] 4.1 Social media publisher skill (20 min)++### Phase 4: Templates ⏱️ ~2.5 hours+- [ ] 5.1 Project intelligence template (45 min)+- [ ] 5.2 Project intelligence instructions (15 min)+- [ ] 5.3 Project intelligence example (30 min)+- [ ] 5.4 Content publisher template (40 min)+- [ ] 5.5 Content publisher instructions & example (45 min)++### Phase 5: Documentation ⏱️ ~2 hours+- [ ] 6.1 Main vault README (30 min)+- [ ] 6.2 Project template README (20 min)+- [ ] 6.3 Individual skill READMEs (80 min)++### Phase 6: Commands & Testing ⏱️ ~1.5 hours+- [ ] 7.1 Verify daily brief command (5 min)+- [ ] 7.2 Update braindump command (10 min)+- [ ] 7.3 Review other commands (15 min)+- [ ] 8.1 Skill activation testing (30 min)+- [ ] 8.2 Integration testing (20 min)+- [ ] 8.3 Documentation review (30 min)++---++## Total Estimated Time: 9-10 hours++**Breakdown:**+- Core infrastructure: 2 hours+- Content skills: 1 hour+- Optional skills: 20 minutes+- Templates: 2.5 hours+- Documentation: 2 hours+- Testing: 1.5 hours++---++## Quick Reference: Files to Create++### Skills (8 + 2 templates)+1. `.claude/skills/obsidian-workspace/SKILL.md`+2. `.claude/skills/domain-classifier/SKILL.md`+3. `.claude/skills/braindump-processor/SKILL.md`+4. `.claude/skills/strategic-analyst/SKILL.md`+5. `.claude/skills/content-analyzer/SKILL.md`+6. `.claude/skills/meeting-processor/SKILL.md`+7. `.claude/skills/news-curator/SKILL.md`+8. `.claude/skills/social-media-publisher/SKILL.md`+9. `.claude/skills/templates/project-intelligence/SKILL-TEMPLATE.md`+10. `.claude/skills/templates/content-publisher/SKILL-TEMPLATE.md`++### Documentation (12 files)+1. `.claude/skills/README.md`+2. `.claude/skills/CUSTOMIZATION-GUIDE.md`+3. `.claude/skills/templates/project-intelligence/CUSTOMIZATION-INSTRUCTIONS.md`+4. `.claude/skills/templates/project-intelligence/EXAMPLE.md`+5. `.claude/skills/templates/content-publisher/CUSTOMIZATION-INSTRUCTIONS.md`+6. `.claude/skills/templates/content-publisher/EXAMPLE.md`+7. `README.md` (vault root)+8. `04-projects/_project-template/README.md`+9-16. Individual skill `README.md` files (8 total)++### Total: 22 files++---++## Notes++### Automation Opportunities+- Could create a script to do find/replace for common substitutions+- Could use Claude to batch-process multiple skills in one session+- Could create diff files showing exact changes needed++### Flexibility+- Can skip social-media-publisher if not needed+- Can skip template skills if you don't need them+- Can add custom skills later++### Maintenance+- Review skills quarterly and update+- Add new frameworks to strategic-analyst as you discover them+- Update competitive intelligence templates based on usage++---++## When Ready to Execute++**Option 1: Do it yourself**+- Follow this TODO step-by-step+- Use Light-Personal-Agent skills as reference+- Make changes as documented++**Option 2: Ask Claude to help**+- Ask Claude: "Generate Phase 1 skills (obsidian-workspace, domain-classifier, braindump-processor, strategic-analyst)"+- Review output+- Ask for next phase+- Continue until complete++**Option 3: One-shot generation**+- Ask Claude: "Generate all 22 files according to IMPLEMENTATION-TODO.md"+- Review complete system+- Make tweaks as needed++---++## Success Criteria++✅ All skills load without errors+✅ Skills activate on appropriate triggers+✅ Content routes to correct domains+✅ No company/personal information in skills+✅ Documentation is clear and helpful+✅ System works out of the box for new users+✅ Customization is straightforward++---++**Ready when you are!** Use this document to implement COG-second-brain skills system at your own pace.diff --git a/.claude/SKILLS-MIGRATION-PLAN.md b/.claude/SKILLS-MIGRATION-PLAN.mdnew file mode 100644index 0000000..b2e5206--- /dev/null+++ b/.claude/SKILLS-MIGRATION-PLAN.md@@ -0,0 +1,432 @@+# COG Second Brain - Skills Architecture Migration Plan++**Created:** 2025-10-31+**Source:** Light-Personal-Agent v2.0 Skills Architecture+**Target:** COG-second-brain (Generic, Reusable)++## Executive Summary++This document outlines the migration plan to create a generic, company-agnostic skills architecture for COG-second-brain based on the proven Light-Personal-Agent system, stripping out all personal/company-specific information while preserving the powerful autonomous skill framework.++---++## What's Being Removed/Generalized++### Personal/Company Information+- ❌ Scout AI, Katalon, specific company/product names+- ❌ Ghostship, Mabl, specific competitor names+- ❌ Personal names (Huy, Tom, Thanh, Sarah, Duke, etc.)+- ❌ Specific URLs, account details, API keys+- ❌ Spellar.ai, specific tool references+- ❌ Confluence-specific publishing (made optional/template)+- ❌ Hardcoded project structures+- ❌ Specific industry jargon (AI testing, QA-specific terms unless generic)++### Company-Specific Skills+- ❌ `scout-intelligence` (replaced with generic `project-intelligence` template)+- ❌ `confluence-publisher` (replaced with generic `content-publisher` template)++---++## What's Being Preserved++### Universal Frameworks+- ✅ Domain classification system (personal/professional/project/shared)+- ✅ Strategic analysis frameworks (SWOT, RICE, ICE, JTBD, etc.)+- ✅ Content processing pipelines+- ✅ Metadata standards and YAML structures+- ✅ Braindump processing workflows+- ✅ Meeting analysis patterns+- ✅ News curation methodology++### Core Architecture+- ✅ Skills-based autonomous activation+- ✅ Obsidian workspace integration+- ✅ File organization patterns+- ✅ Quality standards and verification protocols+- ✅ Error handling patterns+- ✅ Integration between skills++---++## Proposed COG-Second-Brain Skill Structure++### Core Skills (Universal - Always Included)++**1. obsidian-workspace**+- Purpose: Handle Obsidian vault operations+- Changes: Generic vault structure, no hardcoded project names+- Status: Adapt with COG-specific paths++**2. domain-classifier**+- Purpose: Classify content into appropriate domains+- Changes: Generic domain descriptions, user-configurable+- Status: Minimal changes needed++**3. braindump-processor**+- Purpose: Process stream-of-consciousness thoughts+- Changes: Remove Scout/company-specific examples+- Status: Generalize competitive intelligence detection++**4. strategic-analyst**+- Purpose: Apply strategic frameworks automatically+- Changes: Generic examples, no company-specific scenarios+- Status: Universal frameworks need no changes++---++### Content Skills (Universal - Always Included)++**5. content-analyzer**+- Purpose: Analyze articles, documents, web content+- Changes: Remove Scout-specific integration examples+- Status: Genericize domain examples++**6. meeting-processor**+- Purpose: Process meeting transcripts into insights+- Changes: Generic meeting examples, no company names+- Status: Universal methodology preserved++**7. news-curator**+- Purpose: Research and curate news with verification+- Changes: User-configurable interest areas+- Status: Remove Scout/testing-specific defaults++---++### Optional/Template Skills (User Configures)++**8. social-media-publisher**+- Purpose: Create platform-specific social posts+- Changes: Generic audience examples+- Status: Useful for many users, include as-is with generic examples++**9. project-intelligence (TEMPLATE)**+- Purpose: User fills in their own project context+- Changes: Template with placeholders for:+ - Project name+ - Competitors+ - Product positioning+ - Technical stack+ - Success metrics+- Status: New template based on scout-intelligence++**10. content-publisher (TEMPLATE)**+- Purpose: User configures their publishing destination+- Changes: Template with placeholders for:+ - Destination (Confluence, Notion, GitHub, etc.)+ - Authentication+ - Formatting rules+ - Audience adaptation+- Status: New template based on confluence-publisher++---++## File Structure for COG-Second-Brain++```+COG-second-brain/+├── .claude/+│ ├── settings.local.json+│ ├── commands/+│ │ ├── braindump.md+│ │ ├── daily-brief.md+│ │ ├── link.md+│ │ └── brain-dump-analysis.md+│ └── skills/+│ ├── README.md # Skills overview and guide+│ ├── CUSTOMIZATION-GUIDE.md # How to customize skills+│ │+│ ├── obsidian-workspace/+│ │ ├── SKILL.md+│ │ └── README.md+│ │+│ ├── domain-classifier/+│ │ ├── SKILL.md+│ │ └── README.md+│ │+│ ├── braindump-processor/+│ │ ├── SKILL.md+│ │ ├── KNOWLEDGE-EXTRACTION-GUIDE.md+│ │ └── README.md+│ │+│ ├── strategic-analyst/+│ │ ├── SKILL.md+│ │ └── README.md+│ │+│ ├── content-analyzer/+│ │ ├── SKILL.md+│ │ └── README.md+│ │+│ ├── meeting-processor/+│ │ ├── SKILL.md+│ │ └── README.md+│ │+│ ├── news-curator/+│ │ ├── SKILL.md+│ │ └── README.md+│ │+│ ├── social-media-publisher/+│ │ ├── SKILL.md+│ │ └── README.md+│ │+│ └── templates/ # User-customizable templates+│ ├── project-intelligence/+│ │ ├── SKILL-TEMPLATE.md+│ │ ├── CUSTOMIZATION-INSTRUCTIONS.md+│ │ └── EXAMPLE.md+│ │+│ └── content-publisher/+│ ├── SKILL-TEMPLATE.md+│ ├── CUSTOMIZATION-INSTRUCTIONS.md+│ └── EXAMPLE.md+│+├── 00-inbox/ # Temporary capture+├── 01-daily/ # Daily briefs and check-ins+│ ├── briefs/+│ └── checkins/+├── 02-personal/ # Personal domain+│ ├── braindumps/+│ ├── goals/+│ ├── knowledge/+│ └── resources/+├── 03-professional/ # Professional domain+│ ├── braindumps/+│ ├── knowledge/+│ ├── meetings/+│ └── resources/+├── 04-projects/ # Project-specific+│ └── _project-template/ # Template for new projects+│ ├── braindumps/+│ ├── competitive/+│ ├── knowledge/+│ ├── meetings/+│ └── README.md+├── 05-knowledge/ # Consolidated knowledge+└── README.md # Vault introduction+```++---++## Customization Strategy++### For Generic Users++**Out of Box:** Core skills (1-7) work immediately with zero configuration+- Obsidian workspace management+- Domain classification+- Braindump processing+- Strategic analysis+- Content analysis+- Meeting processing+- News curation (user specifies interests via commands)++**Optional:** Skills 8-10 activated if user wants them+- Social media publishing+- Project intelligence (user creates from template)+- Content publishing (user creates from template)++### For Advanced Users++**Project Intelligence Skill**+User copies template and fills in:+```yaml+---+name: [user-project]-intelligence+description: [User's project description]+---++# [User Project] Intelligence Skill++## Project Overview+[User fills in their product/project]++## Competitive Landscape+[User fills in their competitors]++## Strategic Framework+[User fills in positioning]+```++**Content Publisher Skill**+User copies template and configures:+```yaml+---+name: content-publisher-[destination]+description: Publish to [user's platform]+allowed-tools: [user's MCP tools]+---++# Content Publisher Skill++## Destination Configuration+[User specifies: Notion, Confluence, Blog, etc.]++## Authentication+[User configures their auth]+```++---++## Migration Benefits++### For You (Huy)+1. ✅ Portable system you can use across workspaces+2. ✅ No company-specific info leaked+3. ✅ Proven architecture from Light-Personal-Agent+4. ✅ Easy to share with others++### For Generic Users+1. ✅ Production-ready personal agent system+2. ✅ No configuration required for core functionality+3. ✅ Extensible with templates for advanced use+4. ✅ Privacy-first (no external services required)+5. ✅ Learn from your proven system++### For COG System+1. ✅ Second brain that learns and adapts+2. ✅ Autonomous skill activation+3. ✅ Strategic thinking built-in+4. ✅ Knowledge consolidation over time++---++## Deliverables++### Phase 1: Core Infrastructure (Priority 1)+- [ ] `.claude/skills/README.md` - Overview and architecture guide+- [ ] `.claude/skills/CUSTOMIZATION-GUIDE.md` - How to extend skills+- [ ] `obsidian-workspace/SKILL.md` - Generic Obsidian operations+- [ ] `domain-classifier/SKILL.md` - Universal classification+- [ ] `braindump-processor/SKILL.md` - Generic braindump processing++### Phase 2: Strategic & Content Skills (Priority 2)+- [ ] `strategic-analyst/SKILL.md` - Universal frameworks+- [ ] `content-analyzer/SKILL.md` - Generic content analysis+- [ ] `meeting-processor/SKILL.md` - Universal meeting processing+- [ ] `news-curator/SKILL.md` - Configurable news curation++### Phase 3: Optional Skills (Priority 3)+- [ ] `social-media-publisher/SKILL.md` - Generic social posting+- [ ] `templates/project-intelligence/` - Template + instructions + example+- [ ] `templates/content-publisher/` - Template + instructions + example++### Phase 4: Documentation (Priority 4)+- [ ] Main vault `README.md` - Introduction to COG-second-brain+- [ ] `04-projects/_project-template/` - Project folder template+- [ ] Individual skill `README.md` files for each skill+- [ ] YAML frontmatter templates++---++## Implementation Approach++### Option A: Full Migration (Recommended)+Generate all files in one go:+- All 8 core/content skills+- 2 template skills+- Complete documentation+- Ready to use immediately++**Pros:**+- Complete system ready to use+- All skills work together from day 1+- No gaps in functionality++**Cons:**+- Large output (10+ files)+- May need review/tweaking++### Option B: Phased Migration+Generate in phases:+1. Core infrastructure (3 skills + README)+2. Content skills (3 skills)+3. Optional skills (2 skills)+4. Templates and documentation++**Pros:**+- Can review each phase+- Easier to digest+- Can customize as we go++**Cons:**+- System incomplete until done+- May lose context between sessions++### Option C: Cherry-Pick+You tell me which specific skills you want:+- "Just give me braindump-processor and strategic-analyst"+- "I need the whole core set but skip social media"++**Pros:**+- Only get what you need+- Minimal setup++**Cons:**+- May miss skill integration benefits+- Skills expect each other to exist++---++## Recommended Next Steps++### Immediate (This Session)+1. **Review this plan** - Confirm approach aligns with your vision+2. **Choose implementation option** - Full, Phased, or Cherry-Pick+3. **Customize interests** - What domains/projects for news-curator?+4. **Begin generation** - Start creating skill files++### After Generation+1. **Test core skills** - Try `/braindump` command+2. **Verify skill activation** - Check Claude recognizes skills+3. **Customize optional skills** - Fill in project-intelligence template if needed+4. **Document your setup** - Add your specific interests/projects++### Long-Term+1. **Iterate based on usage** - Refine skills as you use them+2. **Add custom skills** - Create domain-specific skills+3. **Share with community** - Help others build personal agents++---++## Questions for You++Before I generate the files, please confirm:++1. **Implementation approach:** Full Migration, Phased, or Cherry-Pick?++2. **Social media skill:** Include or skip? (Useful even if you don't use all platforms)++3. **News interests:** What topics should news-curator monitor by default?+ - Technology trends?+ - Business strategy?+ - Specific industries?+ - (Can be configured later via commands)++4. **Vault structure:** Accept proposed structure or want changes?++5. **Custom projects:** Do you have specific projects to add to 04-projects/ now?++---++## Additional Notes++### Backward Compatibility+- This COG structure is similar enough to Light-Personal-Agent that you could migrate content+- File paths and metadata standards are preserved+- Skills would work if you copied files from Light-Personal-Agent++### Forward Compatibility+- Based on official Claude skills architecture (docs.claude.com)+- Will work with future Claude Code versions+- Portable to other Claude environments++### Privacy & Security+- All personal/company info removed+- No external services required (except optional publishing)+- Full local control+- Privacy-first domain classification++---++**Ready to proceed?** Let me know your preferred approach and I'll generate the complete skill system for COG-second-brain.diff --git a/.github/PR-AWESOME-CLAUDE-CODE.md b/.github/PR-AWESOME-CLAUDE-CODE.mdnew file mode 100644index 0000000..dfddce5--- /dev/null+++ b/.github/PR-AWESOME-CLAUDE-CODE.md@@ -0,0 +1,140 @@+# Pull Request for awesome-claude-code++## Instructions++1. Fork https://github.com/hesreallyhim/awesome-claude-code+2. Edit `README.md`+3. Find the "Workflows & Knowledge Guides" section (around line 239)+4. Under the "General" subsection, find the alphabetically ordered list+5. Add COG entry after "ClaudoPro Directory" (around line 289)+6. Submit PR++## Entry to Add++Add this text after the ClaudoPro Directory entry:++```markdown+[`COG (Claude + Obsidian + Git)`](https://github.com/huytieu/COG-second-brain) by [Huy Tieu](https://github.com/huytieu) ⚖️ MIT+A self-evolving second brain system that combines Claude Code with Obsidian and Git. Features specialized AI subagents for knowledge management (brain-dump-analyst, news-curator), daily intelligence briefings with verification-first approach, and automatic pattern recognition across notes. Privacy-first architecture with plain markdown files.++<details>+<summary>📊 GitHub Stats</summary>++++</details>+<br>+```++## PR Title+```+Add COG - Self-Evolving Second Brain Workflow+```++## PR Description+```markdown+## COG (Claude + Obsidian + Git)++Adding a self-evolving second brain workflow that demonstrates advanced subagent usage and knowledge management patterns.++**Repository**: https://github.com/huytieu/COG-second-brain+**Category**: Workflows & Knowledge Guides > General+**License**: MIT++### What Makes This Workflow Notable++1. **Specialized Subagent Architecture**+ - `brain-dump-analyst`: Transforms stream-of-consciousness into structured insights+ - `news-curator`: Verification-first news curation with 7-day freshness requirement+ - Demonstrates separation of orchestration (commands) vs processing (subagents)++2. **Knowledge Management Features**+ - Self-evolving: Pattern recognition across all notes+ - Self-healing: Auto-updates cross-references when files move+ - Knowledge consolidation: Builds frameworks from scattered insights++3. **Privacy-First Architecture**+ - Strict domain separation (personal/professional/projects)+ - Plain markdown files (no database)+ - Multi-device sync via iCloud + Git version control++4. **Verification-First Approach**+ - All news requires sources + dates+ - Multi-source validation to prevent hallucinations+ - Explicit confidence levels for all analysis++### Components Included+- 5 custom slash commands (onboarding, daily-brief, braindump, weekly-checkin, knowledge-consolidation)+- 2 specialized subagents with domain-specific quality gates+- Configuration-as-knowledge (settings stored as editable markdown)+- Complete directory structure for Obsidian vault integration++I've been using this workflow daily for 3 months with excellent results. The subagent architecture might be particularly interesting for the community as an example of advanced Claude Code usage.+```++## Alternative: Via GitHub CLI++If you have `gh` CLI installed:++```bash+# Fork the repo+gh repo fork hesreallyhim/awesome-claude-code --clone=false++# Clone your fork+git clone https://github.com/huytieu/awesome-claude-code.git+cd awesome-claude-code++# Create a new branch+git checkout -b add-cog-second-brain++# Edit README.md (add the entry above at line 289)+# Then commit+git add README.md+git commit -m "Add COG - Self-Evolving Second Brain Workflow"++# Push to your fork+git push origin add-cog-second-brain++# Create PR+gh pr create --title "Add COG - Self-Evolving Second Brain Workflow" \+ --body "$(cat <<'EOF'+## COG (Claude + Obsidian + Git)++Adding a self-evolving second brain workflow that demonstrates advanced subagent usage and knowledge management patterns.++**Repository**: https://github.com/huytieu/COG-second-brain+**Category**: Workflows & Knowledge Guides > General+**License**: MIT++### What Makes This Workflow Notable++1. **Specialized Subagent Architecture**+ - brain-dump-analyst: Transforms stream-of-consciousness into structured insights+ - news-curator: Verification-first news curation with 7-day freshness requirement+ - Demonstrates separation of orchestration (commands) vs processing (subagents)++2. **Knowledge Management Features**+ - Self-evolving: Pattern recognition across all notes+ - Self-healing: Auto-updates cross-references when files move+ - Knowledge consolidation: Builds frameworks from scattered insights++3. **Privacy-First Architecture**+ - Strict domain separation (personal/professional/projects)+ - Plain markdown files (no database)+ - Multi-device sync via iCloud + Git version control++4. **Verification-First Approach**+ - All news requires sources + dates+ - Multi-source validation to prevent hallucinations+ - Explicit confidence levels for all analysis++### Components Included+- 5 custom slash commands (onboarding, daily-brief, braindump, weekly-checkin, knowledge-consolidation)+- 2 specialized subagents with domain-specific quality gates+- Configuration-as-knowledge (settings stored as editable markdown)+- Complete directory structure for Obsidian vault integration++I've been using this workflow daily for 3 months with excellent results. The subagent architecture might be particularly interesting for the community as an example of advanced Claude Code usage.+EOF+)"+```