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.

Add marketplace compatibility for Claude Code plugin distribution

Huy Tieucb6b689240fb
diff --git a/MARKETPLACE.md b/MARKETPLACE.md
new file mode 100644
index 0000000..f4a57c4
--- /dev/null
+++ b/MARKETPLACE.md
@@ -0,0 +1,166 @@
+# Publishing COG to Claude Code Plugin Marketplaces
+
+This guide explains how to publish COG to Claude Code plugin marketplaces.
+
+## What's Included
+
+COG is now marketplace-compatible with the following files:
+
+- **`plugin.json`** - Complete plugin manifest with all commands, agents, and metadata
+- **`marketplace-entry.json`** - Example marketplace entry for marketplace maintainers
+
+## Plugin Manifest (`plugin.json`)
+
+The `plugin.json` file contains:
+
+### Required Fields
+- `name`: "cog-second-brain" (plugin identifier)
+- `version`: "1.0.0" (semantic versioning)
+- `description`: Full description of COG's capabilities
+
+### Metadata
+- `author`: Author information with GitHub URL
+- `homepage`: GitHub repository URL
+- `repository`: Git repository details
+- `license`: "MIT"
+- `keywords`: Search keywords for discoverability
+- `category`: "productivity"
+- `tags`: Additional categorization tags
+
+### Components
+
+#### Commands (5 total)
+1. `/onboarding` - Personalization workflow
+2. `/daily-brief` - News intelligence
+3. `/braindump` - Thought capture
+4. `/weekly-checkin` - Pattern analysis
+5. `/knowledge-consolidation` - Framework building
+
+#### Agents (2 total)
+1. `brain-dump-analyst` - Stream-of-consciousness analysis
+2. `news-curator` - Verified news curation
+
+### Extended Metadata
+- `features`: List of key COG features
+- `requirements`: Prerequisites (Obsidian, Git, Claude Code)
+- `installation`: Quick start guide
+- `directoryStructure`: Vault organization
+
+## Marketplace Entry (`marketplace-entry.json`)
+
+This is what marketplace maintainers would add to their marketplace catalog:
+
+```json
+{
+ "name": "cog-second-brain",
+ "source": "https://github.com/huytieu/COG-second-brain",
+ "owner": {
+ "name": "Huy Tieu",
+ "email": "[email protected]",
+ "url": "https://github.com/huytieu"
+ },
+ "description": "Self-evolving second brain with AI agents for knowledge management",
+ "version": "1.0.0"
+}
+```
+
+## How to Publish
+
+### Option 1: Submit to Official Claude Code Marketplace
+
+1. Wait for Anthropic to launch the official Claude Code plugin marketplace
+2. Follow their submission process (to be announced)
+3. Provide the GitHub repository URL: `https://github.com/huytieu/COG-second-brain`
+
+### Option 2: Third-Party Marketplace
+
+If a third-party marketplace exists:
+
+1. **Fork or contact the marketplace repository**
+2. **Add the marketplace entry** to their catalog file
+3. **Submit a pull request** with:
+ - Your `marketplace-entry.json` content
+ - Link to your repository
+ - Verification that `plugin.json` exists and is valid
+
+### Option 3: Self-Hosted Marketplace
+
+Create your own marketplace JSON file:
+
+```json
+{
+ "marketplaces": [
+ {
+ "name": "cog-second-brain",
+ "source": "https://github.com/huytieu/COG-second-brain",
+ "owner": {
+ "name": "Huy Tieu",
+ "email": "[email protected]",
+ "url": "https://github.com/huytieu"
+ },
+ "version": "1.0.0"
+ }
+ ]
+}
+```
+
+Host this file publicly and users can add your marketplace URL to their Claude Code settings.
+
+## Validation
+
+To validate your plugin manifest:
+
+```bash
+# Check JSON syntax
+cat plugin.json | python3 -m json.tool > /dev/null && echo "✓ JSON is valid"
+
+# Verify all file paths exist
+ls .claude/commands/onboarding.md
+ls .claude/commands/daily-brief.md
+ls .claude/commands/braindump.md
+ls .claude/commands/weekly-checkin.md
+ls .claude/commands/knowledge-consolidation.md
+ls .claude/subagents/brain-dump-analyst.md
+ls .claude/subagents/news-curator.md
+```
+
+All paths should exist relative to the repository root.
+
+## Installation for Users
+
+Once published to a marketplace, users can install COG:
+
+### Via Marketplace (Future)
+1. Open Claude Code in their Obsidian vault
+2. Open plugin marketplace interface
+3. Search for "cog-second-brain"
+4. Click install
+5. Run `/onboarding` to personalize
+
+### Via Manual Installation (Current)
+```bash
+cd /path/to/your/obsidian-vault
+git clone https://github.com/huytieu/COG-second-brain.git
+cp -r COG-second-brain/.claude .
+cp COG-second-brain/plugin.json .
+```
+
+## Versioning
+
+COG follows semantic versioning:
+
+- **Major** (1.0.0): Breaking changes (architecture overhaul)
+- **Minor** (1.1.0): New features (new commands/agents)
+- **Patch** (1.0.1): Bug fixes, documentation
+
+Update both `plugin.json` and `marketplace-entry.json` when releasing new versions.
+
+## Support and Issues
+
+- Report bugs: https://github.com/huytieu/COG-second-brain/issues
+- Discussions: https://github.com/huytieu/COG-second-brain/discussions
+- Documentation: https://github.com/huytieu/COG-second-brain/wiki
+
+## License
+
+COG is licensed under MIT - free for personal and commercial use.
diff --git a/README.md b/README.md
index 7e4d97d..d30d462 100644
--- a/README.md
+++ b/README.md
@@ -24,7 +24,31 @@ COG is a personal productivity and knowledge management system that:
- [Claude Code](https://claude.ai/download) (or VSCode with Claude extension)
- Git (optional but recommended)
-### Installation (3 Steps)
+### Installation
+
+#### Option 1: Install from Claude Code Plugin Marketplace (Recommended)
+
+Once COG is published to a marketplace, you can install it directly in Claude Code:
+
+1. **Open Claude Code in your Obsidian vault:**
+ ```bash
+ cd /path/to/your/obsidian-vault
+ code .
+ ```
+
+2. **Install the plugin:**
+ - Use the Claude Code plugin marketplace interface
+ - Search for "cog-second-brain"
+ - Click install
+
+3. **Run onboarding:**
+ ```
+ /onboarding
+ ```
+
+That's it! The onboarding will personalize COG for your needs in 3-5 minutes.
+
+#### Option 2: Manual Installation (3 Steps)
1. **Clone this repo into your Obsidian vault:**
```bash
@@ -35,6 +59,7 @@ COG is a personal productivity and knowledge management system that:
2. **Copy COG structure to your vault:**
```bash
cp -r COG-second-brain/.claude .
+ cp COG-second-brain/plugin.json .
```
3. **Open Claude Code in your vault and run onboarding:**
@@ -45,7 +70,7 @@ COG is a personal productivity and knowledge management system that:
That's it! The onboarding will personalize COG for your needs in 3-5 minutes.
-### Alternative: Manual Setup
+### Alternative: Detailed Manual Setup
See [SETUP.md](SETUP.md) for detailed step-by-step instructions.
diff --git a/marketplace-entry.json b/marketplace-entry.json
new file mode 100644
index 0000000..8405950
--- /dev/null
+++ b/marketplace-entry.json
@@ -0,0 +1,11 @@
+{
+ "name": "cog-second-brain",
+ "source": "https://github.com/huytieu/COG-second-brain",
+ "owner": {
+ "name": "Huy Tieu",
+ "email": "[email protected]",
+ "url": "https://github.com/huytieu"
+ },
+ "description": "Self-evolving second brain with AI agents for knowledge management",
+ "version": "1.0.0"
+}
diff --git a/plugin.json b/plugin.json
new file mode 100644
index 0000000..ae53f03
--- /dev/null
+++ b/plugin.json
@@ -0,0 +1,105 @@
+{
+ "name": "cog-second-brain",
+ "version": "1.0.0",
+ "description": "A self-evolving second brain system using Claude Code, Obsidian markdown files, and Git version control. Features specialized AI agents for knowledge management, daily intelligence briefings, and strategic insights extraction.",
+ "author": {
+ "name": "Huy Tieu",
+ "url": "https://github.com/huytieu"
+ },
+ "homepage": "https://github.com/huytieu/COG-second-brain",
+ "repository": {
+ "type": "git",
+ "url": "https://github.com/huytieu/COG-second-brain"
+ },
+ "license": "MIT",
+ "keywords": [
+ "second-brain",
+ "knowledge-management",
+ "obsidian",
+ "productivity",
+ "ai-agents",
+ "personal-intelligence",
+ "note-taking",
+ "self-evolving",
+ "braindump",
+ "daily-brief"
+ ],
+ "category": "productivity",
+ "tags": [
+ "knowledge-management",
+ "obsidian",
+ "second-brain",
+ "ai-agents",
+ "productivity",
+ "note-taking"
+ ],
+ "commands": [
+ {
+ "name": "onboarding",
+ "path": ".claude/commands/onboarding.md",
+ "description": "Personalize COG for your workflow - creates profile, interests, and watchlist files (run this first!)"
+ },
+ {
+ "name": "daily-brief",
+ "path": ".claude/commands/daily-brief.md",
+ "description": "Generate personalized news intelligence with verified sources (7-day freshness requirement)"
+ },
+ {
+ "name": "braindump",
+ "path": ".claude/commands/braindump.md",
+ "description": "Quick capture of raw thoughts with intelligent domain classification and competitive intelligence extraction"
+ },
+ {
+ "name": "weekly-checkin",
+ "path": ".claude/commands/weekly-checkin.md",
+ "description": "Cross-domain pattern analysis and strategic reflection for weekly review"
+ },
+ {
+ "name": "knowledge-consolidation",
+ "path": ".claude/commands/knowledge-consolidation.md",
+ "description": "Build frameworks from scattered insights across all braindumps and notes"
+ }
+ ],
+ "agents": [
+ {
+ "name": "brain-dump-analyst",
+ "path": ".claude/subagents/brain-dump-analyst.md",
+ "description": "Transforms stream-of-consciousness into structured insights with domain classification and competitive intelligence extraction"
+ },
+ {
+ "name": "news-curator",
+ "path": ".claude/subagents/news-curator.md",
+ "description": "Finds verified news with strict 7-day freshness requirement, cross-references sources, and generates personalized briefings"
+ }
+ ],
+ "metadata": {
+ "pluginRoot": ".",
+ "features": [
+ "Self-evolving intelligence with pattern recognition",
+ "Self-healing system with auto-updating cross-references",
+ "Verification-first approach (no AI hallucinations)",
+ "Privacy-first architecture with strict domain separation",
+ "Plain text markdown files (no database, no vendor lock-in)",
+ "Multi-device sync via iCloud (iPhone, iPad, Mac)",
+ "Git version control for tracking thinking evolution"
+ ],
+ "requirements": {
+ "obsidian": "Recommended for markdown file management",
+ "git": "Optional but recommended for version control",
+ "claudeCode": "Required for AI agent functionality"
+ },
+ "installation": {
+ "quickStart": "Clone repo into Obsidian vault, copy .claude directory, run /onboarding",
+ "setupTime": "3-5 minutes",
+ "onboardingTime": "2 minutes"
+ },
+ "directoryStructure": {
+ "00-inbox": "Temporary processing area with profile and interests files",
+ "01-daily": "Daily briefs and check-ins",
+ "02-personal": "Personal domain (strict privacy)",
+ "03-professional": "Professional domain with competitive watchlist",
+ "04-projects": "Project-specific tracking",
+ "05-knowledge": "Consolidated insights and patterns"
+ }
+ }
+}