agentsys 5.1.0 → 5.2.0

package/README.md

@@ -13,23 +13,24 @@
 <p align="center">
   <a href="https://www.npmjs.com/package/agentsys"><img src="https://img.shields.io/npm/v/agentsys.svg" alt="npm version"></a>
   <a href="https://www.npmjs.com/package/agentsys"><img src="https://img.shields.io/npm/dm/agentsys.svg" alt="npm downloads"></a>
-  <a href="https://github.com/avifenesh/agentsys/actions/workflows/ci.yml"><img src="https://github.com/avifenesh/agentsys/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
-  <a href="https://github.com/avifenesh/agentsys/stargazers"><img src="https://img.shields.io/github/stars/avifenesh/agentsys?style=social" alt="GitHub stars"></a>
+  <a href="https://github.com/agent-sh/agentsys/actions/workflows/ci.yml"><img src="https://github.com/agent-sh/agentsys/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
+  <a href="https://github.com/agent-sh/agentsys/stargazers"><img src="https://img.shields.io/github/stars/agent-sh/agentsys.svg" alt="GitHub stars"></a>
   <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License: MIT"></a>
-  <a href="https://avifenesh.github.io/agentsys/"><img src="https://img.shields.io/badge/Website-AgentSys-blue?style=flat&logo=github" alt="Website"></a>
+  <a href="https://agent-sh.github.io/agentsys/"><img src="https://img.shields.io/badge/Website-AgentSys-blue?style=flat&logo=github" alt="Website"></a>
   <a href="https://github.com/hesreallyhim/awesome-claude-code"><img src="https://awesome.re/mentioned-badge.svg" alt="Mentioned in Awesome Claude Code"></a>
 </p>
 
 <p align="center">
-  <b>13 plugins · 42 agents · 28 skills · 26k lines of lib code · 3,357 tests · 3 platforms</b>
+  <b>14 plugins · 43 agents · 30 skills (across all repos) · 26k lines of lib code · 3,357 tests · 4 platforms</b><br>
+  <em>Plugins distributed as standalone repos under <a href="https://github.com/agent-sh">agent-sh</a> org — agentsys is the marketplace &amp; installer</em>
 </p>
 
 <p align="center">
-  <a href="#commands">Commands</a> · <a href="#installation">Installation</a> · <a href="https://avifenesh.github.io/agentsys/">Website</a> · <a href="https://github.com/avifenesh/agentsys/discussions">Discussions</a>
+  <a href="#commands">Commands</a> · <a href="#installation">Installation</a> · <a href="https://agent-sh.github.io/agentsys/">Website</a> · <a href="https://github.com/agent-sh/agentsys/discussions">Discussions</a>
 </p>
 
 <p align="center">
-  <b>Built for Claude Code · Codex CLI · OpenCode</b>
+  <b>Built for Claude Code · Codex CLI · OpenCode · Cursor</b>
 </p>
 
 <p align="center"><em>New skills, agents, and integrations ship constantly. Follow for real-time updates:</em></p>
@@ -42,15 +43,15 @@
 AI models can write code. That's not the hard part anymore. The hard part is everything around it — task selection, branch management, code review, artifact cleanup, CI, PR comments, deployment. **AgentSys is the runtime that orchestrates agents to handle all of it** — structured pipelines, gated phases, specialized agents, and persistent state that survives session boundaries.
 
 ---
-> Building custom skills, agents, hooks, or MCP tools? [agnix](https://github.com/avifenesh/agnix) is the CLI + LSP linter that catches config errors before they fail silently - real-time IDE validation, auto suggestions, auto-fix, and 155 rules for Cursor, Claude Code, Cline, Copilot, Codex, Windsurf, and more.
+> Building custom skills, agents, hooks, or MCP tools? [agnix](https://github.com/agent-sh/agnix) is the CLI + LSP linter that catches config errors before they fail silently - real-time IDE validation, auto suggestions, auto-fix, and 155 rules for Cursor, Claude Code, Cline, Copilot, Codex, Windsurf, and more.
 
 ## What This Is
 
-An agent orchestration system — 13 plugins, 42 agents, and 28 skills that compose into structured pipelines for software development.
+An agent orchestration system — 14 plugins, 43 agents, and 30 skills that compose into structured pipelines for software development. Each plugin lives in its own standalone repo under the [agent-sh](https://github.com/agent-sh) org. agentsys is the marketplace and installer that ties them together.
 
 Each agent has a single responsibility, a specific model assignment, and defined inputs/outputs. Pipelines enforce phase gates so agents can't skip steps. State persists across sessions so work survives interruptions.
 
-The system runs on Claude Code, OpenCode, and Codex CLI. Install the plugins, get the runtime.
+The system runs on Claude Code, OpenCode, Codex CLI, and Cursor. Install via the marketplace or the npm installer, and the plugins are fetched automatically from their repos.
 
 ---
 
@@ -79,19 +80,6 @@ This came from testing on 1,000+ repositories.
 <!-- GEN:START:readme-commands -->
 | Command | What it does |
 |---------|--------------|
-| [`/next-task`](#next-task) | Task → exploration → plan → implementation → review → ship |
-| [`/agnix`](#agnix) | **Lint agent configs** - 155 rules for Skills, Memory, Hooks, MCP across 10+ AI tools |
-| [`/ship`](#ship) | Branch → PR → CI → reviews addressed → merge → cleanup |
-| [`/deslop`](#deslop) | 3-phase detection pipeline, certainty-graded findings |
-| [`/perf`](#perf) | 10-phase performance investigation with baselines and profiling |
-| [`/drift-detect`](#drift-detect) | AST-based plan vs code analysis, finds what's documented but not built |
-| [`/audit-project`](#audit-project) | Multi-agent code review, iterates until issues resolved |
-| [`/enhance`](#enhance) | Analyzes prompts, agents, plugins, docs, hooks, skills |
-| [`/repo-map`](#repo-map) | AST symbol and import mapping via ast-grep |
-| [`/sync-docs`](#sync-docs) | Finds outdated references, stale examples, missing CHANGELOG entries |
-| [`/learn`](#learn) | Research any topic, gather online sources, create learning guide with RAG index |
-| [`/consult`](#consult) | Consult another AI CLI tool for a second opinion. Use when you want to cross-check ideas, get alternative approaches, or validate decisions with Gemini, Codex, Claude, OpenCode, or Copilot. |
-| [`/debate`](#debate) | Structured debate between two AI tools to stress-test ideas. Proposer/Challenger format with a verdict. |
 <!-- GEN:END:readme-commands -->
 
 Each command works standalone. Together, they compose into end-to-end pipelines.
@@ -101,18 +89,10 @@ Each command works standalone. Together, they compose into end-to-end pipelines.
 ## Skills
 
 <!-- GEN:START:readme-skills -->
-28 skills included across the plugins:
+0 skills included across the plugins:
 
 | Category | Skills |
 |----------|--------|
-| **Performance** | `perf:perf-analyzer`, `perf:perf-baseline-manager`, `perf:perf-benchmarker`, `perf:perf-code-paths`, `perf:perf-investigation-logger`, `perf:perf-profiler`, `perf:perf-theory-gatherer`, `perf:perf-theory-tester` |
-| **Enhancement** | `enhance:enhance-agent-prompts`, `enhance:enhance-claude-memory`, `enhance:enhance-cross-file`, `enhance:enhance-docs`, `enhance:enhance-hooks`, `enhance:enhance-orchestrator`, `enhance:enhance-plugins`, `enhance:enhance-prompts`, `enhance:enhance-skills` |
-| **Workflow** | `next-task:discover-tasks`, `next-task:orchestrate-review`, `next-task:validate-delivery` |
-| **Cleanup** | `deslop:deslop`, `sync-docs:sync-docs` |
-| **Analysis** | `debate:debate`, `drift-detect:drift-analysis`, `repo-map:repo-mapping` |
-| **Productivity** | `consult:consult` |
-| **Learning** | `learn:learn` |
-| **Linting** | `agnix:agnix` |
 <!-- GEN:END:readme-skills -->
 
 Skills are the reusable implementation units. Agents invoke skills; commands orchestrate agents. When you install a plugin, its skills become available to all agents in that session.
@@ -124,8 +104,8 @@ Skills are the reusable implementation units. Agents invoke skills; commands orc
 | Section | What's there |
 |---------|--------------|
 | [The Approach](#the-approach) | Why it's built this way |
-| [Commands](#commands) | All 12 commands overview |
-| [Skills](#skills) | 28 skills across plugins |
+| [Commands](#commands) | All 13 commands overview |
+| [Skills](#skills) | 30 skills across plugins |
 | [Command Details](#command-details) | Deep dive into each command |
 | [How Commands Work Together](#how-commands-work-together) | Standalone vs integrated |
 | [Design Philosophy](#design-philosophy) | The thinking behind the architecture |
@@ -143,7 +123,7 @@ Skills are the reusable implementation units. Agents invoke skills; commands orc
 
 **What happens when you run it:**
 
-1. **Policy Selection** - Choose task source (GitHub issues, GitLab, local file), priority filter, stopping point
+1. **Policy Selection** - Choose task source (GitHub Issues, GitHub Projects, GitLab, local file), priority filter, stopping point
 2. **Task Discovery** - Shows top 5 prioritized tasks, you pick one
 3. **Worktree Setup** - Creates isolated branch and working directory
 4. **Exploration** - Deep codebase analysis to understand context
@@ -196,7 +176,7 @@ Phase 9 uses the `orchestrate-review` skill to spawn parallel reviewers (code qu
 
 **Purpose:** Lint agent configurations before they break your workflow. The first dedicated linter for AI agent configs.
 
-**[agnix](https://github.com/avifenesh/agnix)** is a standalone open-source project that provides the validation engine. This plugin integrates it into your workflow.
+**[agnix](https://github.com/agent-sh/agnix)** is a standalone open-source project that provides the validation engine. This plugin integrates it into your workflow.
 
 **The problem it solves:**
 
@@ -255,7 +235,7 @@ agnix outputs SARIF format for GitHub Code Scanning. Add it to your workflow:
 
 **Agent:** agnix-agent (sonnet model)
 
-**External tool:** Requires [agnix CLI](https://github.com/avifenesh/agnix)
+**External tool:** Requires [agnix CLI](https://github.com/agent-sh/agnix)
 
 ```bash
 npm install -g agnix         # Install via npm
@@ -650,10 +630,10 @@ agent-knowledge/
 
 | Tool | Default Model (high) | Reasoning Control |
 |------|---------------------|-------------------|
-| Claude | opus | max-turns |
-| Gemini | gemini-3-pro | built-in |
+| Claude | claude-opus-4-6 | max-turns |
+| Gemini | gemini-3.1-pro-preview | built-in |
 | Codex | gpt-5.3-codex | model_reasoning_effort |
-| OpenCode | github-copilot/claude-opus-4-6 | --variant |
+| OpenCode | (user-selected or default) | --variant |
 | Copilot | (default) | none |
 
 **Usage:**
@@ -670,6 +650,123 @@ agent-knowledge/
 
 ---
 
+### /debate
+
+**Purpose:** Stress-test ideas through structured multi-round debate between two AI CLI tools.
+
+**What it does:**
+
+1. **Tool Detection** - Detects which AI CLI tools are installed (cross-platform)
+2. **Interactive Picker** - If no tools specified, prompts for proposer, challenger, effort, rounds, and context in a single batch question
+3. **Proposer/Challenger Format** - First tool argues for the topic; second tool challenges with evidence
+4. **Multi-Round Exchange** - Each round the proposer defends and the challenger responds (1–5 rounds)
+5. **Verdict** - Orchestrator delivers a final synthesis picking a winner with reasoning
+
+**Usage:**
+
+```bash
+# Natural language
+/debate codex vs gemini about microservices vs monolith
+/debate with claude and codex about our auth implementation
+/debate thoroughly gemini vs codex about database schema design
+/debate codex vs gemini 3 rounds about event sourcing
+
+# Explicit flags
+/debate "Should we use event sourcing?" --tools=claude,gemini --rounds=3 --effort=high
+/debate "Valkey vs PostgreSQL for caching" --tools=codex,opencode
+
+# With codebase context
+/debate "Is our current approach correct?" --tools=gemini,codex --context=diff
+```
+
+**Options:**
+
+| Flag | Description |
+|------|-------------|
+| `--tools=TOOL1,TOOL2` | Proposer and challenger (comma-separated) |
+| `--rounds=N` | Number of debate rounds, 1–5 (default: 2) |
+| `--effort=low\|medium\|high\|max` | Reasoning depth per tool call |
+| `--context=diff\|file=PATH\|none` | Codebase context passed to both tools |
+
+**Agent:** debate-orchestrator (opus model for orchestration)
+
+### /web-ctl
+
+**Purpose:** Browser automation for AI agents - navigate, authenticate, and interact with web pages.
+
+**How it works:**
+
+Each invocation is a single Node.js process using Playwright. No daemon, no MCP server. Session state persists via Chrome's userDataDir with AES-256-GCM encrypted storage.
+
+```
+Agent calls skill -> node scripts/web-ctl.js <args> -> Playwright API -> JSON result
+```
+
+**Session lifecycle:**
+
+1. `session start <name>` - Create session (encrypted profile directory)
+2. `session auth <name> --url <login-url>` - Opens headed Chrome for human login (2FA, CAPTCHAs). Polls for success URL/selector, encrypts cookies on completion
+3. `run <name> <action>` - Headless actions using persisted cookies
+4. `session end <name>` - Cleanup
+
+**Actions:**
+
+| Action | Description | Key flag |
+|--------|-------------|----------|
+| `goto <url>` | Navigate to URL | |
+| `snapshot` | Get accessibility tree (primary page inspection) | |
+| `click <sel>` | Click element | `--wait-stable` |
+| `click-wait <sel>` | Click and wait for DOM + network stability | `--timeout <ms>` |
+| `type <sel> <text>` | Type with human-like delays | |
+| `read <sel>` | Read element text content | |
+| `fill <sel> <value>` | Clear field and set value | |
+| `wait <sel>` | Wait for element to appear | `--timeout <ms>` |
+| `evaluate <js>` | Execute JS in page context | `--allow-evaluate` |
+| `screenshot` | Full-page screenshot | `--path <file>` |
+| `network` | Capture network requests | `--filter <pattern>` |
+| `checkpoint` | Open headed browser for user (CAPTCHAs) | `--timeout <sec>` |
+
+`click-wait` waits for network idle + no DOM mutations for 500ms before returning. Cuts SPA interactions from multiple agent turns to one.
+
+**Error handling:**
+
+All errors return classified codes with actionable recovery suggestions:
+
+| Code | Recovery suggestion |
+|------|-------------------|
+| `element_not_found` | Snapshot included in response for selector discovery |
+| `timeout` | Increase `--timeout` |
+| `browser_closed` | `session start <name>` |
+| `network_error` | Check URL; verify cookies with `session status` |
+| `no_display` | Use `--vnc` flag |
+| `session_expired` | Re-authenticate |
+
+**Security:** Output sanitization (cookies/tokens redacted), prompt injection defense (`[PAGE_CONTENT: ...]` delimiters), AES-256-GCM encryption at rest, anti-bot measures (`webdriver=false`, random delays), read-only agent (no Write/Edit tools).
+
+**Selector syntax:** `role=button[name='Submit']`, `css=div.class`, `text=Click here`, `#id`
+
+**Usage:**
+
+```bash
+/web-ctl goto https://example.com
+/web-ctl auth twitter --url https://x.com/i/flow/login
+/web-ctl   # describe what you want to do, agent orchestrates it
+```
+
+**Install:**
+
+```bash
+agentsys install web-ctl
+npm install playwright
+npx playwright install chromium
+```
+
+**Agent:** web-session (sonnet model)
+
+**Skills:** web-auth (human-in-the-loop auth), web-browse (headless actions)
+
+---
+
 ## How Commands Work Together
 
 **Standalone use:**
@@ -808,7 +905,7 @@ Every command works standalone. [`/deslop`](#deslop) cleans code without needing
 ### Claude Code (Recommended way)
 
 ```bash
-/plugin marketplace add avifenesh/agentsys
+/plugin marketplace add agent-sh/agentsys
 /plugin install next-task@agentsys
 /plugin install ship@agentsys
 ```
@@ -819,11 +916,12 @@ Every command works standalone. [`/deslop`](#deslop) cleans code without needing
 npm install -g agentsys && agentsys
 ```
 
-Interactive installer for Claude Code, OpenCode, and Codex CLI.
+Interactive installer for Claude Code, OpenCode, Codex CLI, and Cursor.
 
 ```bash
 # Non-interactive install
 agentsys --tool claude              # Single tool
+agentsys --tool cursor              # Cursor (project-scoped skills + commands)
 agentsys --tools "claude,opencode"  # Multiple tools
 agentsys --development              # Dev mode (bypasses marketplace)
 ```
@@ -848,7 +946,7 @@ agentsys --development              # Dev mode (bypasses marketplace)
 - ast-grep (`sg`) installed
 
 **For /agnix:**
-- [agnix CLI](https://github.com/avifenesh/agnix) installed (`cargo install agnix-cli` or `brew install agnix`)
+- [agnix CLI](https://github.com/agent-sh/agnix) installed (`cargo install agnix-cli` or `brew install agnix`)
 
 **Local diagnostics (optional):**
 ```bash
@@ -874,7 +972,7 @@ The system is built on research, not guesswork.
 - 1,818 tests passing
 - Drift-detect validated on 1,000+ repositories
 - E2E workflow testing across all commands
-- Cross-platform validation (Claude Code, OpenCode, Codex CLI)
+- Cross-platform validation (Claude Code, OpenCode, Codex CLI, Cursor)
 
 **Methodology:**
 - `/perf` investigation phases based on recorded real performance investigation sessions
@@ -910,8 +1008,8 @@ The system is built on research, not guesswork.
 
 ## Support
 
-- **Issues:** [github.com/avifenesh/agentsys/issues](https://github.com/avifenesh/agentsys/issues)
-- **Discussions:** [github.com/avifenesh/agentsys/discussions](https://github.com/avifenesh/agentsys/discussions)
+- **Issues:** [github.com/agent-sh/agentsys/issues](https://github.com/agent-sh/agentsys/issues)
+- **Discussions:** [github.com/agent-sh/agentsys/discussions](https://github.com/agent-sh/agentsys/discussions)
 
 ---
 

package/SECURITY.md

@@ -7,7 +7,7 @@
 If you discover a security vulnerability:
 
 1. **Do not** open a public issue
-2. Use [GitHub Security Advisories](https://github.com/avifenesh/agentsys/security/advisories) to report privately
+2. Use [GitHub Security Advisories](https://github.com/agent-sh/agentsys/security/advisories) to report privately
 3. Include steps to reproduce and potential impact
 
 ## User Responsibility

package/adapters/README.md

@@ -7,7 +7,7 @@ This directory contains adapters for using agentsys commands with different AI c
 ### Claude Code (Native)
 The primary target. Install via marketplace:
 ```bash
-claude plugin marketplace add avifenesh/agentsys
+claude plugin marketplace add agent-sh/agentsys
 # Install specific plugins (e.g., next-task, ship, enhance)
 claude plugin install next-task@agentsys
 claude plugin install ship@agentsys
@@ -22,7 +22,7 @@ OpenAI's Codex command-line interface.
 
 **Installation:**
 ```bash
-git clone https://github.com/avifenesh/agentsys.git
+git clone https://github.com/agent-sh/agentsys.git
 cd agentsys
 ./adapters/codex/install.sh
 ```
@@ -44,7 +44,7 @@ Open-source AI coding assistant.
 
 **Installation:**
 ```bash
-git clone https://github.com/avifenesh/agentsys.git
+git clone https://github.com/agent-sh/agentsys.git
 cd agentsys
 ./adapters/opencode/install.sh
 ```
@@ -131,7 +131,7 @@ Installers automatically handle these substitutions.
 ### Claude Code
 ```bash
 # Via marketplace (easiest)
-claude plugin marketplace add avifenesh/agentsys
+claude plugin marketplace add agent-sh/agentsys
 claude plugin install next-task@agentsys
 ```
 
@@ -237,7 +237,7 @@ gh auth login
 
 Found a bug or want to add support for another tool?
 
-1. Open an issue: https://github.com/avifenesh/agentsys/issues
+1. Open an issue: https://github.com/agent-sh/agentsys/issues
 2. Submit a PR with:
    - New adapter directory: `adapters/[tool-name]/`
    - Installation script: `install.sh`
@@ -251,7 +251,7 @@ Found a bug or want to add support for another tool?
 - [Claude Code Documentation](https://code.claude.com/docs)
 - [Codex CLI Documentation](https://developers.openai.com/codex/cli)
 - [OpenCode Documentation](https://opencode.ai/docs)
-- [agentsys Repository](https://github.com/avifenesh/agentsys)
+- [agentsys Repository](https://github.com/agent-sh/agentsys)
 
 ---
 

package/adapters/codex/README.md

@@ -5,7 +5,7 @@ Professional-grade slash commands adapted for OpenAI's Codex CLI.
 ## Quick Install
 
 ```bash
-git clone https://github.com/avifenesh/agentsys.git
+git clone https://github.com/agent-sh/agentsys.git
 cd agentsys
 ./adapters/codex/install.sh
 ```
@@ -255,8 +255,8 @@ gh auth status
 
 ## Support
 
-- **Repository**: https://github.com/avifenesh/agentsys
-- **Issues**: https://github.com/avifenesh/agentsys/issues
+- **Repository**: https://github.com/agent-sh/agentsys
+- **Issues**: https://github.com/agent-sh/agentsys/issues
 - **Codex CLI Docs**: https://developers.openai.com/codex/cli
 
 ---

package/adapters/codex/install.sh

@@ -227,8 +227,8 @@ cd /path/to/agentsys
 
 ## Support
 
-- Repository: https://github.com/avifenesh/agentsys
-- Issues: https://github.com/avifenesh/agentsys/issues
+- Repository: https://github.com/agent-sh/agentsys
+- Issues: https://github.com/agent-sh/agentsys/issues
 EOF
 
 echo "  [OK] Created README"

package/adapters/opencode/README.md

@@ -5,7 +5,7 @@ Professional-grade slash commands adapted for OpenCode.
 ## Quick Install
 
 ```bash
-git clone https://github.com/avifenesh/agentsys.git
+git clone https://github.com/agent-sh/agentsys.git
 cd agentsys
 ./adapters/opencode/install.sh
 ```
@@ -284,8 +284,8 @@ gh auth status
 
 ## Support
 
-- **Repository**: https://github.com/avifenesh/agentsys
-- **Issues**: https://github.com/avifenesh/agentsys/issues
+- **Repository**: https://github.com/agent-sh/agentsys
+- **Issues**: https://github.com/agent-sh/agentsys/issues
 - **OpenCode Docs**: https://opencode.ai/docs
 
 ---

package/adapters/opencode/install.sh

@@ -234,8 +234,8 @@ cd /path/to/agentsys
 
 ## Support
 
-- Repository: https://github.com/avifenesh/agentsys
-- Issues: https://github.com/avifenesh/agentsys/issues
+- Repository: https://github.com/agent-sh/agentsys
+- Issues: https://github.com/agent-sh/agentsys/issues
 EOF
 
 echo "  [OK] Created README"

package/agent-knowledge/AGENTS.md

@@ -8,6 +8,11 @@
 |-------|------|---------|-------|---------|
 | AI CLI Non-Interactive & Programmatic Usage | ai-cli-non-interactive-programmatic-usage.md | 52 | deep | 2026-02-10 |
 | AI CLI Advanced Integration (MCP, SDKs, Cross-Tool) | ai-cli-advanced-integration-patterns.md | 38 | deep | 2026-02-10 |
+| Skill/Plugin Distribution Patterns | skill-plugin-distribution-patterns.md | 40 | deep | 2026-02-21 |
+| All-in-One Plus Modular Packages | all-in-one-plus-modular-packages.md | 40 | deep | 2026-02-21 |
+| GitHub Org Project Management (Multi-Repo OSS) | github-org-project-management.md | 15 | deep | 2026-02-21 |
+| GitHub Organization Structure Patterns | github-org-structure-patterns.md | 18 | deep | 2026-02-21 |
+| Multi-Product Org Docs & Website Architecture | multi-product-org-docs.md | 42 | deep | 2026-02-21 |
 
 ## Trigger Phrases
 
@@ -27,11 +32,91 @@ Use this knowledge when user asks about:
 - "claude mcp serve" -> ai-cli-advanced-integration-patterns.md
 - "MCP server mode" -> ai-cli-advanced-integration-patterns.md
 - "AI CLI MCP integration" -> ai-cli-advanced-integration-patterns.md
-- "Gemini extensions" -> ai-cli-advanced-integration-patterns.md
+- "Gemini CLI extensions" -> ai-cli-advanced-integration-patterns.md
 - "Codex MCP" -> ai-cli-advanced-integration-patterns.md
-- "Crush / OpenCode" -> ai-cli-advanced-integration-patterns.md
+- "Crush OpenCode" -> ai-cli-advanced-integration-patterns.md
 - "Agent SDK hosting" -> ai-cli-advanced-integration-patterns.md
+- "A2A protocol" -> ai-cli-advanced-integration-patterns.md
 - "Cross-tool MCP" -> ai-cli-advanced-integration-patterns.md
+- "AI CLI server mode" -> ai-cli-advanced-integration-patterns.md
+- "Claude Code as service" -> ai-cli-advanced-integration-patterns.md
+- "Plugin distribution patterns" -> skill-plugin-distribution-patterns.md
+- "npm vs git submodules vs vendoring" -> skill-plugin-distribution-patterns.md
+- "How to distribute CLI plugins" -> skill-plugin-distribution-patterns.md
+- "Plugin registry architecture" -> skill-plugin-distribution-patterns.md
+- "Extension marketplace design" -> skill-plugin-distribution-patterns.md
+- "asdf mise plugin model" -> skill-plugin-distribution-patterns.md
+- "Terraform provider registry" -> skill-plugin-distribution-patterns.md
+- "Homebrew taps" -> skill-plugin-distribution-patterns.md
+- "oh-my-zsh plugin system" -> skill-plugin-distribution-patterns.md
+- "Plugin contract design" -> skill-plugin-distribution-patterns.md
+- "Small ecosystem plugin strategy" -> skill-plugin-distribution-patterns.md
+- "Convention-based plugin discovery" -> skill-plugin-distribution-patterns.md
+- "monorepo packages" -> all-in-one-plus-modular-packages.md
+- "meta-package pattern" -> all-in-one-plus-modular-packages.md
+- "batteries included but removable" -> all-in-one-plus-modular-packages.md
+- "npm workspaces" -> all-in-one-plus-modular-packages.md
+- "pnpm workspaces" -> all-in-one-plus-modular-packages.md
+- "Lerna monorepo" -> all-in-one-plus-modular-packages.md
+- "Changesets versioning" -> all-in-one-plus-modular-packages.md
+- "modular package architecture" -> all-in-one-plus-modular-packages.md
+- "scoped npm packages" -> all-in-one-plus-modular-packages.md
+- "plugin architecture" -> all-in-one-plus-modular-packages.md
+- "CLI installer pattern" -> all-in-one-plus-modular-packages.md
+- "degit tiged scaffolding" -> all-in-one-plus-modular-packages.md
+- "dual CJS ESM" -> all-in-one-plus-modular-packages.md
+- "package exports map" -> all-in-one-plus-modular-packages.md
+- "independent versioning" -> all-in-one-plus-modular-packages.md
+- "GitHub releases distribution" -> all-in-one-plus-modular-packages.md
+- "AWS SDK v3 modular" -> all-in-one-plus-modular-packages.md
+- "lodash per-method packages" -> all-in-one-plus-modular-packages.md
+- "Babel plugin architecture" -> all-in-one-plus-modular-packages.md
+- "Turborepo Nx Rush" -> all-in-one-plus-modular-packages.md
+- "GitHub Projects v2" -> github-org-project-management.md
+- "org-level project management" -> github-org-project-management.md
+- "multi-repo GitHub board" -> github-org-project-management.md
+- "GitHub Issue Types" -> github-org-project-management.md
+- "GitHub sub-issues" -> github-org-project-management.md
+- "GitHub roadmap project" -> github-org-project-management.md
+- "addProjectV2ItemById" -> github-org-project-management.md
+- "actions/add-to-project" -> github-org-project-management.md
+- "Kubernetes SIG model" -> github-org-project-management.md
+- "RFC process GitHub" -> github-org-project-management.md
+- "cross-repo issue tracking" -> github-org-project-management.md
+- "GitHub Projects automation" -> github-org-project-management.md
+- "GitHub org structure" -> github-org-structure-patterns.md
+- "GitHub .github repo" -> github-org-structure-patterns.md
+- "org community health files" -> github-org-structure-patterns.md
+- "reusable GitHub Actions workflows" -> github-org-structure-patterns.md
+- "CODEOWNERS working groups" -> github-org-structure-patterns.md
+- "GitHub org profile README" -> github-org-structure-patterns.md
+- "developer tool org layout" -> github-org-structure-patterns.md
+- "open source org patterns" -> github-org-structure-patterns.md
+- "multi-product docs" -> multi-product-org-docs.md
+- "documentation architecture" -> multi-product-org-docs.md
+- "docs site structure" -> multi-product-org-docs.md
+- "Docusaurus multi-instance" -> multi-product-org-docs.md
+- "Starlight Astro docs" -> multi-product-org-docs.md
+- "Mintlify docs" -> multi-product-org-docs.md
+- "VitePress multi-sidebar" -> multi-product-org-docs.md
+- "developer portal" -> multi-product-org-docs.md
+- "plugin catalog page" -> multi-product-org-docs.md
+- "marketplace page design" -> multi-product-org-docs.md
+- "docs SEO multi-product" -> multi-product-org-docs.md
+- "hub and spoke docs" -> multi-product-org-docs.md
+- "unified docs vs separate sites" -> multi-product-org-docs.md
+- "llms.txt AI discoverability" -> multi-product-org-docs.md
+- "GitHub Pages org site docs" -> multi-product-org-docs.md
+- "HashiCorp developer portal" -> multi-product-org-docs.md
+- "Supabase docs structure" -> multi-product-org-docs.md
+- "agent-sh website" -> multi-product-org-docs.md
+- "agnix docs separate site" -> multi-product-org-docs.md
+- "plugin catalog generation" -> multi-product-org-docs.md
+- "cross-product navigation" -> multi-product-org-docs.md
+- "product switcher docs" -> multi-product-org-docs.md
+- "Diataxis framework" -> multi-product-org-docs.md
+- "Pagefind search" -> multi-product-org-docs.md
+- "docs-as-code" -> multi-product-org-docs.md
 
 ## Quick Lookup
 
@@ -48,11 +133,65 @@ Use this knowledge when user asks about:
 | subprocess, spawn, piping | ai-cli-non-interactive-programmatic-usage.md |
 | consultant pattern | ai-cli-non-interactive-programmatic-usage.md |
 | claude mcp serve, mcp server | ai-cli-advanced-integration-patterns.md |
-| gemini extensions, a2a | ai-cli-advanced-integration-patterns.md |
+| gemini extensions, a2a protocol | ai-cli-advanced-integration-patterns.md |
 | codex shell-tool-mcp | ai-cli-advanced-integration-patterns.md |
 | crush, opencode successor | ai-cli-advanced-integration-patterns.md |
-| agent sdk hosting | ai-cli-advanced-integration-patterns.md |
-| cross-tool mcp | ai-cli-advanced-integration-patterns.md |
+| agent sdk hosting, containers | ai-cli-advanced-integration-patterns.md |
+| cross-tool mcp, tool integration | ai-cli-advanced-integration-patterns.md |
+| remote agents, long-running | ai-cli-advanced-integration-patterns.md |
+| plugin distribution, extension marketplace | skill-plugin-distribution-patterns.md |
+| npm packages, vendoring, git submodules | skill-plugin-distribution-patterns.md |
+| terraform registry, homebrew taps | skill-plugin-distribution-patterns.md |
+| asdf plugins, mise backends | skill-plugin-distribution-patterns.md |
+| plugin contract, plugin protocol | skill-plugin-distribution-patterns.md |
+| oh-my-zsh, zsh plugins, vim plugins | skill-plugin-distribution-patterns.md |
+| vscode extensions, grafana plugins | skill-plugin-distribution-patterns.md |
+| small ecosystem, plugin discovery | skill-plugin-distribution-patterns.md |
+| monorepo, workspaces, multi-package | all-in-one-plus-modular-packages.md |
+| lerna, changesets, turborepo, nx, rush | all-in-one-plus-modular-packages.md |
+| meta-package, re-export, barrel | all-in-one-plus-modular-packages.md |
+| lodash, aws-sdk, babel, eslint, angular | all-in-one-plus-modular-packages.md |
+| plugin architecture, core + plugins | all-in-one-plus-modular-packages.md |
+| degit, tiged, create-react-app, scaffolding | all-in-one-plus-modular-packages.md |
+| npm publish, semantic-release, np | all-in-one-plus-modular-packages.md |
+| CJS, ESM, dual module, exports map | all-in-one-plus-modular-packages.md |
+| cargo workspaces, go modules, pip extras | all-in-one-plus-modular-packages.md |
+| github releases, binary distribution | all-in-one-plus-modular-packages.md |
+| github projects v2, projects board | github-org-project-management.md |
+| issue types, sub-issues, github hierarchy | github-org-project-management.md |
+| cross-repo tracking, org project | github-org-project-management.md |
+| graphql addProjectV2ItemById | github-org-project-management.md |
+| actions/add-to-project, auto-add | github-org-project-management.md |
+| kubernetes SIG, KEP, enhancement proposals | github-org-project-management.md |
+| rust RFC, working groups | github-org-project-management.md |
+| astro roadmap, withastro | github-org-project-management.md |
+| github public roadmap, shipped label | github-org-project-management.md |
+| iteration fields, sprint planning github | github-org-project-management.md |
+| label sync, org labels | github-org-project-management.md |
+| .github repo, org defaults, community health | github-org-structure-patterns.md |
+| CODEOWNERS, working groups, wg-tauri | github-org-structure-patterns.md |
+| reusable workflows, workflow_call | github-org-structure-patterns.md |
+| org profile README, pinned repos | github-org-structure-patterns.md |
+| bun org, deno org, astro org | github-org-structure-patterns.md |
+| AI contribution policy, AI disclosure | github-org-structure-patterns.md |
+| just commands, justfile | github-org-structure-patterns.md |
+| starter workflows, workflow-templates | github-org-structure-patterns.md |
+| github pages org site | github-org-structure-patterns.md |
+| verified domain github | github-org-structure-patterns.md |
+| multi-product docs, documentation architecture | multi-product-org-docs.md |
+| Docusaurus, Starlight, Mintlify, VitePress | multi-product-org-docs.md |
+| developer portal, docs site structure | multi-product-org-docs.md |
+| plugin catalog, marketplace page | multi-product-org-docs.md |
+| docs SEO, llms.txt, AI discoverability | multi-product-org-docs.md |
+| hub-and-spoke, unified portal | multi-product-org-docs.md |
+| HashiCorp, Supabase, Vercel docs | multi-product-org-docs.md |
+| product switcher, cross-product navigation | multi-product-org-docs.md |
+| Diataxis, docs-as-code | multi-product-org-docs.md |
+| Pagefind, Algolia DocSearch | multi-product-org-docs.md |
+| agent-sh website, agnix docs | multi-product-org-docs.md |
+| GitBook, ReadMe, Nextra | multi-product-org-docs.md |
+| GitHub Pages docs hosting | multi-product-org-docs.md |
+| Cloudflare Pages, Vercel hosting | multi-product-org-docs.md |
 
 ## How to Use