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 and SEO/GEO optimization (v3.5.0)
Huy Tieu034af4c82043
diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.jsonindex 4fb74ab..a4d62ac 100644--- a/.claude-plugin/plugin.json+++ b/.claude-plugin/plugin.json@@ -1,7 +1,7 @@{"name": "cog-second-brain","version": "3.5.0",- "description": "A self-evolving second brain built on Obsidian markdown, Git, and multi-agent skill surfaces for Claude Code, Kiro, Gemini CLI, Codex, and other markdown-reading assistants.",+ "description": "Self-evolving second brain with 17 AI agent skills, 6 worker agents, and people CRM. Inspired by Garry Tan's gstack specialist sessions and gbrain knowledge patterns. Works with Claude Code, Cursor, Kiro, Gemini CLI, Codex, and any markdown-reading agent.","author": {"name": "Huy Tieu","url": "https://github.com/huytieu"@@ -16,13 +16,26 @@"second-brain","knowledge-management","obsidian",- "productivity","ai-agents",+ "productivity",+ "garry-tan",+ "gstack",+ "gbrain",+ "worker-agents",+ "people-crm",+ "braindump",+ "daily-brief",+ "team-intelligence",+ "claude-code",+ "cursor",+ "kiro",+ "gemini-cli",+ "codex",+ "agentic",+ "self-evolving","personal-intelligence","note-taking",- "self-evolving",- "braindump",- "daily-brief"+ "specialist-sessions"],"category": "productivity","tags": [@@ -31,7 +44,14 @@"second-brain","ai-agents","productivity",- "note-taking"+ "garry-tan",+ "gstack",+ "gbrain",+ "worker-agents",+ "people-crm",+ "claude-code",+ "cursor",+ "specialist-sessions"],"skills": [{diff --git a/.cursor-plugin/plugin.json b/.cursor-plugin/plugin.jsonnew file mode 100644index 0000000..aebfff3--- /dev/null+++ b/.cursor-plugin/plugin.json@@ -0,0 +1,70 @@+{+ "name": "cog-second-brain",+ "displayName": "COG: Agentic Second Brain",+ "version": "3.5.0",+ "description": "Self-evolving second brain powered by AI agents, Obsidian markdown, and Git. 17 skills, 6 worker agents, people CRM with tiered enrichment. Inspired by Garry Tan's gstack and gbrain patterns. Works with Claude Code, Cursor, Kiro, Gemini CLI, Codex, and any markdown-reading agent.",+ "author": {+ "name": "Huy Tieu",+ "email": "[email protected]",+ "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",+ "ai-agents",+ "productivity",+ "garry-tan",+ "gstack",+ "gbrain",+ "worker-agents",+ "people-crm",+ "braindump",+ "daily-brief",+ "team-intelligence",+ "claude-code",+ "cursor",+ "kiro",+ "gemini-cli",+ "codex",+ "agentic",+ "self-evolving",+ "markdown",+ "note-taking",+ "personal-intelligence"+ ],+ "category": "productivity",+ "skills": [+ "onboarding",+ "braindump",+ "daily-brief",+ "weekly-checkin",+ "knowledge-consolidation",+ "url-dump",+ "update-cog",+ "team-brief",+ "meeting-transcript",+ "comprehensive-analysis",+ "auto-research",+ "create-user-story",+ "generate-prd",+ "generate-release-notes",+ "export-open-issues",+ "publish-to-confluence",+ "update-knowledge-base"+ ],+ "agents": [+ "worker-data-collector",+ "worker-researcher",+ "worker-file-ops",+ "worker-executor",+ "worker-publisher",+ "brief-people-updater"+ ]+}diff --git a/.cursorrules b/.cursorrulesnew file mode 100644index 0000000..9fdc8ba--- /dev/null+++ b/.cursorrules@@ -0,0 +1,50 @@+# COG Second Brain — Cursor Rules+# This is the Cursor-compatible version of CLAUDE.md+# COG: Cognition + Obsidian + Git — a self-evolving agentic second brain+# Inspired by Garry Tan's gstack and gbrain patterns++## Skills++COG exposes 17 skills via `.claude/skills/*/SKILL.md`. Each skill has a `name` and `description` in YAML frontmatter. Use AGENTS.md as the universal command reference.++## Worker Agents++6 worker agents live in `.claude/agents/`. Workers handle data-heavy tasks; the lead session handles reasoning and synthesis.++- worker-data-collector: Structured extraction from GitHub, Slack, Jira, Linear+- worker-researcher: Web research with source citations+- worker-file-ops: Vault file operations, metadata, profiles+- worker-executor: Pre-approved mutations (Jira, Linear, APIs)+- worker-publisher: Publishing to Slack, Confluence, Notion+- brief-people-updater: Batch-update people profiles++## Brain-First Protocol++Before answering questions about people, projects, strategy, or decisions:+1. Read relevant notes from `05-knowledge/` first+2. If project-specific, read `04-projects/<project>/`+3. Then synthesize an answer++## Integration Preferences++Check `00-inbox/MY-INTEGRATIONS.md` before using any external integration:+- Active: use normally+- Disabled: skip silently+- Unknown: ask the user++## Vault Structure++```+00-inbox/ — Profiles, interests, integrations+01-daily/ — Briefs and check-ins+02-personal/ — Personal braindumps (private)+03-professional/ — Professional braindumps and strategy+04-projects/ — Per-project tracking+05-knowledge/ — Consolidated insights, people CRM, patterns+06-templates/ — Document templates+```++## Citation Rule++For factual statements in durable notes, include:+`[Source: [[path/to/note]] | YYYY-MM-DD | confidence: high|medium|low]`diff --git a/.github/MARKETPLACE.md b/.github/MARKETPLACE.mdindex aa9afb0..f0cb93d 100644--- a/.github/MARKETPLACE.md+++ b/.github/MARKETPLACE.md@@ -1,15 +1,30 @@-# Publishing COG to Claude Code Marketplaces+# Publishing COG to Marketplaces & Directories-This guide covers the packaging metadata and release checks for publishing COG.+This guide covers packaging metadata, platform-specific requirements, and release checks for publishing COG across all supported directories.++## Supported Platforms++| Platform | Listing method | Status |+|---|---|---|+| **skills.sh** (Vercel) | Auto-detected via `npx skills add huytieu/COG-second-brain` | Ready — `.claude/skills/*/SKILL.md` files have required frontmatter |+| **agentskill.sh** | Submit repo URL at agentskill.sh/submit | Ready — SKILL.md files auto-indexed |+| **cursor.directory** | Submit at cursor.directory/plugins/new | Ready — `.cursor-plugin/plugin.json` + `.cursorrules` shipped |+| **Claude Code Marketplace** | `.claude-plugin/plugin.json` + `marketplace-entry.json` | Ready — canonical manifest shipped |+| **GitHub** | Repository topics and description | Ready — topics set via `gh` |## Packaged Metadata-COG ships marketplace metadata in two files:+COG ships marketplace metadata in multiple formats:-- **`.claude-plugin/plugin.json`** — canonical manifest for the packaged Claude Code surface-- **`marketplace-entry.json`** — lightweight catalog entry for marketplace maintainers+| File | Platform | Purpose |+|---|---|---|+| `.claude-plugin/plugin.json` | Claude Code marketplace | Canonical skill manifest (17 skills, 6 agents) |+| `.cursor-plugin/plugin.json` | cursor.directory | Cursor-compatible manifest |+| `.cursorrules` | Cursor | Editor rules for Cursor users |+| `marketplace-entry.json` | General marketplaces | Lightweight catalog entry |+| `AGENTS.md` | Universal | Command reference for any markdown-reading agent |-Current packaged version: **3.4.1**+Current packaged version: **3.5.0**## Surface Model@@ -17,13 +32,20 @@ COG is a **multi-agent package**, not a single-surface plugin:| Surface | Coverage ||---|---:|-| Claude Code (`.claude/skills/`) | 17 native skills |-| Universal docs (`AGENTS.md`) | 17 documented commands |+| Claude Code (`.claude/skills/`) | 17 native skills + 6 worker agents |+| Cursor (`.cursor-plugin/`) | Plugin manifest + rules |+| Universal docs (`AGENTS.md`) | 17+ documented commands || Kiro (`.kiro/powers/`) | 7 core powers || Gemini CLI (`.gemini/commands/`) | 7 core commands |For the detailed contract, see [`docs/AGENT-SUPPORT.md`](../docs/AGENT-SUPPORT.md).+## SEO/GEO Keywords++These keywords are set across all manifests and the GitHub repo for discoverability:++`second-brain`, `garry-tan`, `gstack`, `gbrain`, `ai-agents`, `obsidian`, `claude-code`, `cursor`, `kiro`, `gemini-cli`, `codex`, `worker-agents`, `people-crm`, `knowledge-management`, `specialist-sessions`, `agentic`, `self-evolving`, `productivity`+## Before You PublishRun the packaging validator from the repo root:@@ -32,24 +54,9 @@ Run the packaging validator from the repo root:./scripts/validate-agent-surface.sh```-This catches the most common release mistakes:-- invalid JSON in manifests-- skill paths listed in the manifest but missing on disk-- plugin skill counts drifting from `.claude/skills/`-- `AGENTS.md` missing commands that the manifest claims to ship-- wrong `AGENTS.md` filename casing in packaging docs-- version mismatches across `COG-VERSION`, `plugin.json`, and `marketplace-entry.json`--## Manual Validation Commands--If you want extra spot checks:-+Also validate Cursor manifest:```bash-python3 -m json.tool .claude-plugin/plugin.json > /dev/null-python3 -m json.tool marketplace-entry.json > /dev/null-find .claude/skills -name SKILL.md | wc -l-find .kiro/powers -name POWER.md | wc -l-find .gemini/commands -type f | wc -l+python3 -m json.tool .cursor-plugin/plugin.json > /dev/null```## Installation Guidance for Marketplace Descriptions@@ -59,7 +66,12 @@ Preferred install flow:```bashgit clone https://github.com/huytieu/COG-second-brain.gitcd COG-second-brain-# Open in Claude Code, Kiro, Gemini CLI, Codex, or another AGENTS-compatible agent+# Open in Claude Code, Cursor, Kiro, Gemini CLI, Codex, or another AGENTS-compatible agent+```++Skills.sh install:+```bash+npx skills add huytieu/COG-second-brain```Do **not** describe installation as copying only `.claude/` into another folder — COG is a full vault/repo layout, not just a loose skill pack.@@ -67,12 +79,14 @@ Do **not** describe installation as copying only `.claude/` into another folder## Release Checklist1. Bump `COG-VERSION`-2. Update `.claude-plugin/plugin.json`-3. Update `marketplace-entry.json`-4. Update `CHANGELOG.md`-5. Add any new framework files to `FRAMEWORK_FILES` in `cog-update.sh`-6. Run `./scripts/validate-agent-surface.sh`-7. Smoke test onboarding from a clean clone+2. Update `.claude-plugin/plugin.json` (version + any new skills/agents)+3. Update `.cursor-plugin/plugin.json` (version + skills list)+4. Update `marketplace-entry.json` (version)+5. Update `CHANGELOG.md`+6. Add any new framework files to `FRAMEWORK_FILES` in `cog-update.sh`+7. Run `./scripts/validate-agent-surface.sh`+8. Update GitHub repo topics if keywords changed+9. Smoke test onboarding from a clean clone## Support Linksdiff --git a/README.md b/README.mdindex 12a528b..cc1eb5e 100644--- a/README.md+++ b/README.md@@ -4,7 +4,9 @@[Quick Start](#quick-start) | [Skills](#skills) | [Features](#features-at-a-glance) | [FAQ](#faq) | [SETUP.md](SETUP.md)-> Works with [Claude Code](https://claude.ai/download) • [Kiro](https://kiro.dev/) • [Gemini CLI](https://github.com/google-gemini/gemini-cli) • [OpenAI Codex](https://github.com/openai/codex) • any AI that reads markdown+> Works with [Claude Code](https://claude.ai/download) • [Cursor](https://cursor.com/) • [Kiro](https://kiro.dev/) • [Gemini CLI](https://github.com/google-gemini/gemini-cli) • [OpenAI Codex](https://github.com/openai/codex) • any AI that reads markdown+>+> Inspired by [Garry Tan's gstack](https://github.com/garrytan/gstack) and [gbrain](https://github.com/garrytan/gbrain)```mermaidgraph LR@@ -33,11 +35,17 @@ cd COG-second-brain| Agent | Command | How it finds skills ||---|---|---|| Claude Code | `code .` → "Run onboarding" | `.claude/skills/` |+| Cursor | Open folder → "Run onboarding" | `.cursor-plugin/` + `.cursorrules` || Kiro | Open folder → "setup COG" | `.kiro/powers/` || Gemini CLI | `gemini` → `/onboarding` | `GEMINI.md` + `.gemini/commands/` || OpenAI Codex | `codex` → "Run onboarding" | `AGENTS.md` || Other agents | Point at `AGENTS.md` → "Run onboarding" | `AGENTS.md` |+**Or install via [skills.sh](https://skills.sh):**+```bash+npx skills add huytieu/COG-second-brain+```+Done — COG is personalized and ready in ~2 minutes. See [SETUP.md](SETUP.md) for optional config (Git sync, iCloud, Obsidian Tasks, etc.).## Agent Support Matrix@@ -46,7 +54,8 @@ COG ships a **full Claude Code surface** plus **core native surfaces** for Kiro| Surface | Current support | Notes ||---|---|---|-| Claude Code | 17 native skills | Full first-class surface |+| Claude Code | 17 native skills + 6 worker agents | Full first-class surface |+| Cursor | Plugin manifest + rules | `.cursor-plugin/plugin.json` + `.cursorrules` || Kiro | 7 native powers | Core workflows today || Gemini CLI | 7 native commands | Core workflows today || `AGENTS.md` | 17 documented commands | Universal fallback for Codex and other agents |@@ -160,6 +169,7 @@ graph TD|---|---|---|| **Self-Evolving** — Learns your patterns, auto-organizes content, builds frameworks | **Self-Healing** — Rename files or restructure; cross-references update automatically | **Verification-First** — Sources required, 7-day freshness, confidence levels on all analysis || **Privacy-First** — Local `.md` files, strict domain separation, no external servers | **Multi-Device** — iCloud sync to iPhone/iPad/Mac; Git for version history | **Obsidian Tasks** — `📅 YYYY-MM-DD` emoji format works with Tasks plugin dashboards |+| **Garry Tan Inspired** — gstack specialist sessions + gbrain knowledge patterns | **Multi-Platform** — Listed on [skills.sh](https://skills.sh), [agentskill.sh](https://agentskill.sh), [cursor.directory](https://cursor.directory) | **Worker Agents** — Sonnet handles I/O, Opus handles thinking |## Your Vault@@ -248,9 +258,16 @@ Git is optional but recommended for version history. COG works fine with just iC| [Contribute](CONTRIBUTING.md) | [Report bugs](https://github.com/huytieu/COG-second-brain/issues) | [Discussions](https://github.com/huytieu/COG-second-brain/discussions) || [Sponsor on GitHub](https://github.com/sponsors/huytieu) | [Buy me a coffee](https://buymeacoffee.com/0xlight) | [MIT License](LICENSE) |-## Acknowledgments+## Acknowledgments & Inspiration++Built with [Claude Code](https://claude.ai/code), [Cursor](https://cursor.com/), [Kiro](https://kiro.dev/), [Gemini CLI](https://github.com/google-gemini/gemini-cli), [OpenAI Codex](https://github.com/openai/codex), and [Obsidian](https://obsidian.md/).-Built with [Claude Code](https://claude.ai/code), [Kiro](https://kiro.dev/), [Gemini CLI](https://github.com/google-gemini/gemini-cli), [OpenAI Codex](https://github.com/openai/codex), and [Obsidian](https://obsidian.md/). Inspired by Zettelkasten, Building a Second Brain, and GTD.+**Key inspirations:**+- [**Garry Tan's gstack**](https://github.com/garrytan/gstack) — specialist sessions, clear operating gears, repo-local skill distribution. COG's worker agent architecture and model routing borrow directly from gstack's explicit mode separation.+- [**Garry Tan's gbrain**](https://github.com/garrytan/gbrain) — Compiled Truth + Timeline pattern, tiered enrichment for people profiles, brain-first lookup protocol. COG's people CRM and knowledge-first approach are adapted from gbrain's design.+- **Zettelkasten** — atomic, interlinked notes as the foundation of knowledge+- **Building a Second Brain (Tiago Forte)** — PARA organization, progressive summarization+- **GTD (David Allen)** — capture everything, process systematically## Star Historydiff --git a/cog-update.sh b/cog-update.shindex cf54817..9ea4ea7 100755--- a/cog-update.sh+++ b/cog-update.sh@@ -105,6 +105,8 @@ FRAMEWORK_FILES=(# Plugin metadata".claude-plugin/plugin.json"+ ".cursor-plugin/plugin.json"+ ".cursorrules""marketplace-entry.json"# Git infrastructurediff --git a/marketplace-entry.json b/marketplace-entry.jsonindex 9265069..58941ca 100644--- a/marketplace-entry.json+++ b/marketplace-entry.json@@ -6,6 +6,22 @@"email": "[email protected]","url": "https://github.com/huytieu"},- "description": "Self-evolving second brain with multi-agent surfaces for Claude Code, Kiro, Gemini CLI, and AGENTS-compatible assistants",- "version": "3.5.0"+ "description": "Self-evolving second brain with 17 AI skills, 6 worker agents, and people CRM. Inspired by Garry Tan's gstack and gbrain. Works with Claude Code, Cursor, Kiro, Gemini CLI, Codex.",+ "version": "3.5.0",+ "keywords": [+ "second-brain",+ "garry-tan",+ "gstack",+ "gbrain",+ "ai-agents",+ "obsidian",+ "claude-code",+ "cursor",+ "worker-agents",+ "people-crm",+ "knowledge-management",+ "specialist-sessions"+ ],+ "category": "productivity",+ "homepage": "https://github.com/huytieu/COG-second-brain"}