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 marketplace compatibility for Claude Code plugin distribution
Huy Tieucb6b689240fb
diff --git a/MARKETPLACE.md b/MARKETPLACE.mdnew file mode 100644index 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.mdindex 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:**```bashcp -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 SetupSee [SETUP.md](SETUP.md) for detailed step-by-step instructions.diff --git a/marketplace-entry.json b/marketplace-entry.jsonnew file mode 100644index 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.jsonnew file mode 100644index 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"+ }+ }+}