Skip to content

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.

Rebrand COG as agentic second brain with multi-agent support

Huy Tieue739f8811b97
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 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-17
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 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 documentation
2. **Templates**: Follow existing YAML frontmatter conventions
3. **Documentation**: Update README.md if adding major features
4. **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
```yaml
diff --git a/README.md b/README.md
index 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 w
Built 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.md
index 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.git
cd COG-second-brain
```
-**Step 2: Open Claude Code and run onboarding**
+**Step 2: Open your AI agent and run onboarding**
+
+**Claude Code:**
```bash
code .
-# 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 skill
code .claude/skills/braindump/SKILL.md
```
@@ -242,40 +270,55 @@ mkdir -p .claude/skills/my-skill
touch .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 folder
2. Verify each skill folder has a `SKILL.md` file
3. Make sure you're running Claude Code from the COG folder root
4. 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.md
index 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