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
Rebrand COG as agentic second brain with multi-agent support
Huy Tieue739f8811b97
diff --git a/CHANGELOG.md b/CHANGELOG.mdindex 5088962..5b2c8fd 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -1,6 +1,94 @@# Changelog-All notable changes to COG (Claude + Obsidian + Git) will be documented in this file.+All notable changes to COG (Cognition + Obsidian + Git) will be documented in this file.++## [3.0.0] - 2026-01-19++### Multi-Agent Support - COG Goes Agentic++This release transforms COG from a Claude Code-only system to a truly agent-agnostic second brain that works with multiple AI platforms.++### Added++#### Multi-Agent Architecture+- **`agents.md`** - Universal agent documentation for OpenAI and other agents+ - Documents all 6 skills with triggers, purposes, and outputs+ - Works with any AI that reads markdown+ - Includes vault structure and quick start guide++- **`.kiro/powers/`** - Native Kiro support with 6 powers+ - `cog-onboarding/POWER.md` - Profile setup+ - `cog-braindump/POWER.md` - Thought capture+ - `cog-daily-brief/POWER.md` - News intelligence+ - `cog-weekly-checkin/POWER.md` - Weekly reflection+ - `cog-knowledge-consolidation/POWER.md` - Framework building+ - `cog-url-dump/POWER.md` - URL bookmarking++#### New Skill+- **url-dump** - Quick capture URLs with automatic content extraction+ - Fetches and extracts content from URLs+ - Auto-categorizes into booklets (articles, tools, reference, etc.)+ - Generates insights and key takeaways+ - Saves to `05-knowledge/booklets/` or project resources++### Changed++#### Rebranding+- **COG = Cognition + Obsidian + Git** (previously Claude + Obsidian + Git)+- Positioned as "agentic second brain" rather than Claude-specific+- Updated all documentation to reflect multi-agent support++#### Documentation Updates+- **README.md** - Complete rewrite for multi-agent support+ - New prerequisites section with agent options+ - Updated directory structure showing all agent formats+ - Agent-agnostic installation instructions+ - FAQ updated for multi-agent questions++- **SETUP.md** - Multi-agent setup instructions+ - Separate setup steps for Claude Code, Kiro, and other agents+ - Updated troubleshooting for each agent type+ - Skill customization guide for all formats++- **CONTRIBUTING.md** - Multi-format contribution guidelines+ - How to add skills in all agent formats+ - Coding conventions for each format+ - Keep-in-sync guidance++### Architecture++#### Skill Formats+COG skills are now defined in three parallel formats:++| Format | Location | Agent |+|--------|----------|-------|+| SKILL.md | `.claude/skills/[name]/` | Claude Code |+| POWER.md | `.kiro/powers/cog-[name]/` | Kiro |+| agents.md | Root directory | OpenAI, others |++#### Benefits+- **Agent flexibility**: Use whichever AI agent you prefer+- **Future-proof**: Easy to add support for new agents+- **Consistent experience**: Same 6 skills across all platforms+- **No lock-in**: Switch agents without losing functionality++### Migration Guide++If upgrading from v2.x:++1. **Pull new files**:+ ```bash+ git pull origin main+ ```++2. **New files added automatically**:+ - `agents.md` - Universal documentation+ - `.kiro/powers/` - Kiro support+ - `.claude/skills/url-dump/` - New skill++3. **No breaking changes** - All existing skills and content remain compatible++---## [2.0.0] - 2025-10-17diff --git a/CONTRIBUTING.md b/CONTRIBUTING.mdindex ed2fe96..80a5ede 100644--- a/CONTRIBUTING.md+++ b/CONTRIBUTING.md@@ -14,7 +14,7 @@ If you find a bug or have a suggestion:- Detailed description of the problem or suggestion- Steps to reproduce (for bugs)- Expected vs actual behavior- - Your environment (OS, Obsidian version, Claude Code version)+ - Your environment (OS, Obsidian version, AI agent used: Claude Code/Kiro/Other)### Suggesting Enhancements@@ -39,7 +39,10 @@ We welcome ideas for new features or improvements:#### Making Changes-1. **Commands**: New commands should be self-contained `.md` files in `.claude/commands/`+1. **Skills**: New skills should be added in all supported formats:+ - `.claude/skills/[name]/SKILL.md` - Claude Code format+ - `.kiro/powers/cog-[name]/POWER.md` - Kiro format+ - Update `agents.md` - Universal documentation2. **Templates**: Follow existing YAML frontmatter conventions3. **Documentation**: Update README.md if adding major features4. **Examples**: Provide examples of your feature in action@@ -74,14 +77,14 @@ Before submitting:### High Priority-- **New Commands**: Useful slash commands for common workflows-- **Improved Templates**: Better templates for specific use cases+- **New Skills**: Useful skills for common workflows (add in all agent formats)+- **Agent Format Support**: Improve support for additional AI agents- **Documentation**: Tutorials, examples, use cases- **Bug Fixes**: Fixes for reported issues### Medium Priority-- **Specialized Agents**: New subagents for specific domains+- **Specialized Skills**: New skills for specific domains- **Integration Scripts**: Scripts for connecting COG with other tools- **Workflow Examples**: Real-world workflow demonstrations- **Performance Improvements**: Optimizations for large vaults@@ -102,29 +105,53 @@ Before submitting:## Coding Conventions-### Command Files+### Claude Code Skills (`.claude/skills/[name]/SKILL.md`)```markdown-# Command Name+---+name: skill-name+description: What this skill does+----## Purpose-[Clear one-sentence description]+# Skill Name-## Command: `/command-name`+## When to Invoke+[Trigger patterns]## Process Flow[Step-by-step process]-## Metadata Template-[YAML template]-## Output Structure[Expected output format]+```-## Guidelines-[Usage guidelines]+### Kiro Powers (`.kiro/powers/cog-[name]/POWER.md`)++```markdown+---+name: "cog-skill-name"+displayName: "Skill Display Name"+description: "What this power does"+keywords: ["keyword1", "keyword2", "keyword3"]+---++# Skill Name++## When This Power Activates+[Trigger patterns]++## Process Flow+[Step-by-step process]```+### Universal Documentation (`agents.md`)++Add new skills under "## Available Commands" with:+- Command name and triggers+- Description and purpose+- What it does (numbered list)+- Output locations+### Template Files```yamldiff --git a/README.md b/README.mdindex 8851fdd..bb6678c 100644--- a/README.md+++ b/README.md@@ -1,8 +1,8 @@-# COG: The Easiest Second Brain That Actually Self-Evolves+# COG: The Agentic Second Brain That Actually Self-Evolves-**COG = Claude + Obsidian + Git**+**COG = Cognition + Obsidian + Git**-A self-evolving second brain system using Claude Code, Obsidian markdown files, and Git version control. No database, no vendor lock-in—just `.md` files that think.+A self-evolving second brain powered by AI agents, Obsidian markdown files, and Git version control. Works with **Claude Code**, **Kiro**, **OpenAI agents**, and any AI that reads markdown. No database, no vendor lock-in—just `.md` files that think.## What is COG?@@ -13,14 +13,18 @@ COG is a personal productivity and knowledge management system that:- 📝 **Plain text**: Just markdown files (no database, no vendor lock-in)- 📱 **Multi-device**: Syncs via iCloud to iPhone, iPad, Mac- 🔒 **Privacy-first**: Your data, your files, your control-- 🎯 **Specialized agents**: Custom AI assistants for specific workflows+- 🤖 **Agent-agnostic**: Works with Claude Code, Kiro, OpenAI, and more+- 🎯 **Specialized skills**: Custom AI capabilities for specific workflows- ✅ **Verification-first**: No AI hallucinations, sources required## Quick Start### Prerequisites-- [Claude Code](https://claude.ai/download) - Required+- **AI Agent** (choose one or more):+ - [Claude Code](https://claude.ai/download) - Uses `.claude/skills/`+ - [Kiro](https://kiro.dev/) - Uses `.kiro/powers/`+ - Any OpenAI-compatible agent - Uses `agents.md`- [Obsidian](https://obsidian.md/) - Recommended for viewing/editing your notes- Git - Already on your system if you can run the clone command below@@ -32,19 +36,27 @@ COG is a personal productivity and knowledge management system that:cd COG-second-brain```-2. **Open Claude Code and run onboarding:**+2. **Open your AI agent and run onboarding:**```bash- code .- # In Claude Code, ask: "Run onboarding" or "Set up my COG profile"+ # Claude Code:+ code . # Then ask: "Run onboarding"++ # Kiro:+ # Open folder, mention "onboarding" or "setup COG"++ # Other agents:+ # Reference agents.md and ask to run onboarding```That's it! The onboarding will personalize COG for your needs in 2-3 minutes.**What just happened?**- The cloned repo IS your second brain - all files are ready to use-- `.claude/skills/` contains 5 AI skills ready to invoke+- Skills are defined in multiple formats for agent compatibility:+ - `.claude/skills/` - 6 Claude Code skills+ - `.kiro/powers/` - 6 Kiro powers+ - `agents.md` - Universal agent documentation- Onboarding will create your personalized directory structure-- Just run onboarding to set up and personalize COG**Want Obsidian integration?**- Open Obsidian → "Open folder as vault" → Select the `COG-second-brain` folder@@ -56,9 +68,9 @@ See [SETUP.md](SETUP.md) for optional configurations (Git sync, iCloud, etc.).## What You Get-### 5 Powerful Skills+### 6 Powerful Skills-COG uses Claude's Agent Skills architecture - specialized capabilities that Claude automatically invokes when relevant to your request.+COG provides specialized AI capabilities that work across different agents. The same skills are available whether you use Claude Code, Kiro, or other AI agents.**Setup & Personalization:**- **onboarding** - Personalize COG for your workflow (run this first!)@@ -66,6 +78,7 @@ COG uses Claude's Agent Skills architecture - specialized capabilities that Clau**Daily Operations:**- **braindump** - Quick capture of raw thoughts with intelligent domain classification and competitive intelligence extraction- **daily-brief** - Personalized news intelligence with verified sources (7-day freshness requirement)+- **url-dump** - Quick capture URLs with automatic content extraction, insights, and categorization**Weekly & Strategic:**- **weekly-checkin** - Cross-domain pattern analysis and strategic reflection@@ -134,18 +147,23 @@ Friday: Run knowledge-consolidation skill```your-obsidian-vault/+├── agents.md # Universal agent documentation (OpenAI, etc.)├── .claude/-│ └── skills/ # 5 specialized skills+│ └── skills/ # 6 Claude Code skills│ ├── onboarding/-│ │ └── SKILL.md│ ├── braindump/-│ │ └── SKILL.md│ ├── daily-brief/-│ │ └── SKILL.md│ ├── weekly-checkin/-│ │ └── SKILL.md-│ └── knowledge-consolidation/-│ └── SKILL.md+│ ├── knowledge-consolidation/+│ └── url-dump/+├── .kiro/+│ └── powers/ # 6 Kiro powers+│ ├── cog-onboarding/+│ ├── cog-braindump/+│ ├── cog-daily-brief/+│ ├── cog-weekly-checkin/+│ ├── cog-knowledge-consolidation/+│ └── cog-url-dump/├── 00-inbox/ # Temporary processing area│ ├── MY-PROFILE.md # Your profile (created by onboarding)│ ├── MY-INTERESTS.md # Your topics & news sources@@ -171,6 +189,7 @@ your-obsidian-vault/└── 05-knowledge/ # Consolidated insights├── consolidated/├── patterns/+ ├── booklets/ # URL bookmarks by category└── timeline/```@@ -245,9 +264,9 @@ Weekly or monthly:- ✅ **Git for thoughts**: Version control shows thinking evolution### What Doesn't Work-- ⚠️ Requires discipline—system only works if used consistently-- ⚠️ Not for everyone—if you don't think in text files, this won't click-- ⚠️ Requires Claude Code (though adaptable to other AI environments)+- Requires discipline—system only works if used consistently+- Not for everyone—if you don't think in text files, this won't click+- Requires an AI agent (Claude Code, Kiro, or compatible agent)### Unexpected Benefits- 💡 **Thinking partner, not just storage**: Writing brain dumps knowing they'll be analyzed improves clarity@@ -358,7 +377,11 @@ After 3 months of use:A: COG adds self-evolving intelligence. It doesn't just store—it learns, analyzes, and synthesizes insights automatically.**Q: Do I need Claude Code specifically?**-A: Claude Code is recommended, but you can adapt the commands for any AI environment (VSCode + Claude extension, custom API integration, etc.)+A: No! COG now supports multiple AI agents:+- **Claude Code**: Uses `.claude/skills/` (native support)+- **Kiro**: Uses `.kiro/powers/` (native support)+- **OpenAI/Other agents**: Use `agents.md` for skill documentation+- Any AI that reads markdown can use COG's skills**Q: How much does it cost?**A: COG is free (MIT license). You only pay for Claude Code usage (Anthropic's pricing).@@ -395,6 +418,7 @@ COG is free and open-source (MIT license). Your support helps keep it that way wBuilt with:- [Claude Code](https://claude.ai/code) by Anthropic+- [Kiro](https://kiro.dev/) by AWS- [Obsidian](https://obsidian.md/) for markdown management- Inspiration from Zettelkasten, Building a Second Brain, and GTD methodologies@@ -404,6 +428,6 @@ Built with:----**TL;DR:** COG is a self-evolving second brain using Claude Code + Obsidian + Git. Just `.md` files that sync via iCloud and learn your patterns. Setup in 3 steps, zero maintenance required.+**TL;DR:** COG is a self-evolving agentic second brain using AI agents + Obsidian + Git. Works with Claude Code, Kiro, OpenAI, and more. Just `.md` files that sync via iCloud and learn your patterns. Setup in 2 steps, zero maintenance required.⭐ Star this repo if you find it useful!diff --git a/SETUP.md b/SETUP.mdindex 7fbc3a9..cadd63d 100644--- a/SETUP.md+++ b/SETUP.md@@ -1,12 +1,15 @@# COG Setup Guide-Complete step-by-step instructions for setting up your COG (Claude + Obsidian + Git) second brain system.+Complete step-by-step instructions for setting up your COG (Cognition + Obsidian + Git) agentic second brain system.## Quick Start (Easiest Way)### What You Need-1. **Claude Code** ([Download here](https://claude.ai/download)) - Required+1. **AI Agent** (choose one or more):+ - [Claude Code](https://claude.ai/download) - Uses `.claude/skills/`+ - [Kiro](https://kiro.dev/) - Uses `.kiro/powers/`+ - Any OpenAI-compatible agent - Uses `agents.md`2. **Obsidian** ([Download here](https://obsidian.md/)) - Recommended (optional)3. **Git** - Already on your system if you can run clone commands@@ -18,19 +21,32 @@ git clone https://github.com/huytieu/COG-second-brain.gitcd COG-second-brain```-**Step 2: Open Claude Code and run onboarding**+**Step 2: Open your AI agent and run onboarding**++**Claude Code:**```bashcode .-# In Claude Code, ask: "Run onboarding"+# Ask: "Run onboarding"```+**Kiro:**+- Open the folder in Kiro+- Say "onboarding" or "setup COG"+- Kiro will activate the cog-onboarding power++**Other Agents:**+- Point the agent to `agents.md` for skill documentation+- Ask it to run the onboarding workflow+That's it! You now have a working second brain.**What just happened?**- The cloned `COG-second-brain` folder IS your second brain-- 5 AI skills are ready to use in `.claude/skills/`+- 6 AI skills are available in multiple formats:+ - `.claude/skills/` - For Claude Code+ - `.kiro/powers/` - For Kiro+ - `agents.md` - For any agent- Onboarding will create your personalized directory structure-- Just run onboarding to set up and personalize COG**Optional: Use with Obsidian**@@ -97,13 +113,23 @@ After running onboarding, you'll have this structure:```COG-second-brain/ # This is your second brain folder+├── agents.md # Universal agent documentation├── .claude/-│ └── skills/ # 5 AI skills ready to invoke+│ └── skills/ # 6 Claude Code skills│ ├── onboarding/│ ├── braindump/│ ├── daily-brief/│ ├── weekly-checkin/-│ └── knowledge-consolidation/+│ ├── knowledge-consolidation/+│ └── url-dump/+├── .kiro/+│ └── powers/ # 6 Kiro powers+│ ├── cog-onboarding/+│ ├── cog-braindump/+│ ├── cog-daily-brief/+│ ├── cog-weekly-checkin/+│ ├── cog-knowledge-consolidation/+│ └── cog-url-dump/├── 00-inbox/ # Temporary & profile files (created by onboarding)├── 01-daily/ # Daily briefs and check-ins│ ├── briefs/@@ -116,6 +142,7 @@ COG-second-brain/ # This is your second brain folder├── 05-knowledge/ # Consolidated insights│ ├── consolidated/│ ├── patterns/+│ ├── booklets/ # URL bookmarks│ └── timeline/└── 06-templates/ # Markdown templates```@@ -223,11 +250,12 @@ Update `00-inbox/MY-PROFILE.md` to include the new project in your active projec## Customizing Skills-Want to customize how COG works?+Want to customize how COG works? Skills are defined in multiple formats for different agents.++### For Claude Code**Edit existing skills:**```bash-# Example: Customize the braindump skillcode .claude/skills/braindump/SKILL.md```@@ -242,40 +270,55 @@ mkdir -p .claude/skills/my-skilltouch .claude/skills/my-skill/SKILL.md```-Add content:-```markdown-----name: my-skill-description: What this skill does (Claude uses this to decide when to invoke)----+### For Kiro-# My Custom Skill+**Edit existing powers:**+```bash+code .kiro/powers/cog-braindump/POWER.md+```-## When to Invoke-- User says "do the thing"-- User mentions "custom workflow"+Each `POWER.md` file contains:+- `name`, `displayName`, `description`, `keywords` in frontmatter+- Onboarding and steering instructions in body-## Process Flow+**Create new powers:**+```bash+mkdir -p .kiro/powers/my-power+touch .kiro/powers/my-power/POWER.md+```-### 1. Do Something-[Instructions for Claude]+### For Other Agents-### 2. Create Output-[More instructions]-```+Edit `agents.md` to add or modify skill documentation. This file serves as universal documentation that any AI agent can read.++### Keeping Skills in Sync++When you modify a skill, update all formats:+1. `.claude/skills/[name]/SKILL.md` - Claude Code+2. `.kiro/powers/cog-[name]/POWER.md` - Kiro+3. `agents.md` - Universal documentation## Troubleshooting### Skills Not Recognized-**Problem:** Claude doesn't recognize skill invocations+**Problem:** Agent doesn't recognize skill invocations-**Solutions:**+**Solutions for Claude Code:**1. Check `.claude/skills/` folder exists in your COG folder2. Verify each skill folder has a `SKILL.md` file3. Make sure you're running Claude Code from the COG folder root4. Try restarting Claude Code+**Solutions for Kiro:**+1. Check `.kiro/powers/` folder exists+2. Verify each power folder has a `POWER.md` file+3. Try mentioning specific keywords from the power's `keywords` list++**Solutions for Other Agents:**+1. Ensure `agents.md` exists in the root folder+2. Point the agent to read `agents.md` for available commands+### Files Saving to Wrong Location**Problem:** Braindumps or briefs save to unexpected directories@@ -371,4 +414,4 @@ Once you're comfortable:----**Welcome to COG!** Your second brain is ready to learn and evolve with you.+**Welcome to COG!** Your agentic second brain is ready to learn and evolve with you—powered by whichever AI agent you choose.diff --git a/agents.md b/agents.mdindex c83df56..50fc5b4 100644--- a/agents.md+++ b/agents.md@@ -1,6 +1,10 @@-# COG Second Brain - Agent Commands+# COG: Agentic Second Brain - Universal Agent Commands-This document defines the available commands/skills for AI agents interacting with COG (Claude + Obsidian + Git second brain system).+This document defines the available commands/skills for AI agents interacting with COG (Cognition + Obsidian + Git) - a self-evolving agentic second brain system.++**Compatible with:** OpenAI agents, Claude (via this file), and any AI that reads markdown.++> **Note:** Claude Code users should use `.claude/skills/` and Kiro users should use `.kiro/powers/` for native support. This file serves as universal documentation for all other agents.## Available Commands