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 and SEO/GEO optimization (v3.5.0)

Huy Tieu034af4c82043
diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json
index 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.json
new file mode 100644
index 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/.cursorrules
new file mode 100644
index 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.md
index 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 Publish
Run 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:
```bash
git clone https://github.com/huytieu/COG-second-brain.git
cd 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 Checklist
1. 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 Links
diff --git a/README.md b/README.md
index 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) &bull; [Kiro](https://kiro.dev/) &bull; [Gemini CLI](https://github.com/google-gemini/gemini-cli) &bull; [OpenAI Codex](https://github.com/openai/codex) &bull; any AI that reads markdown
+> Works with [Claude Code](https://claude.ai/download) &bull; [Cursor](https://cursor.com/) &bull; [Kiro](https://kiro.dev/) &bull; [Gemini CLI](https://github.com/google-gemini/gemini-cli) &bull; [OpenAI Codex](https://github.com/openai/codex) &bull; any AI that reads markdown
+>
+> Inspired by [Garry Tan's gstack](https://github.com/garrytan/gstack) and [gbrain](https://github.com/garrytan/gbrain)
```mermaid
graph 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 History
diff --git a/cog-update.sh b/cog-update.sh
index 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 infrastructure
diff --git a/marketplace-entry.json b/marketplace-entry.json
index 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"
}