feat: Cursor platform support - skills, commands, and rules

AGENTS.md

@@ -240,7 +240,7 @@ Cannot skip in /next-task:
 - Use CHANGELOG.md for completion tracking (not summary files)
 - BEFORE starting → Read the relevant checklist (`checklists/*.md`)
 - BEFORE delivering any work, especially releases → Go through that checklist item by item
-- 3 platforms: Claude Code + OpenCode + Codex - ALL must work
+- 4 platforms: Claude Code + OpenCode + Codex + Cursor - ALL must work
 - Agent/Skill pattern: Agents invoke skills, skills have implementation
 - Create PRs for non-trivial changes
 </end-reminder>

CHANGELOG.md

@@ -11,6 +11,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Added
 
+- **Cursor platform support (#261)** — agentsys now installs to Cursor as a 4th platform alongside Claude Code, OpenCode, and Codex CLI. Use `agentsys --tool cursor` or `agentsys install <plugin> --tool cursor` to install. Skills are copied to `.cursor/skills/` (same SKILL.md format - no transform needed), commands to `.cursor/commands/` (light transform), and rules to `.cursor/rules/*.mdc` (MDC frontmatter). All content is project-scoped. Cursor v2.4+ natively supports the Agent Skills standard.
+
 - **`/web-ctl` plugin** — New plugin for browser automation and web testing. Headless browser control via Playwright with persistent encrypted sessions, human-in-the-loop auth handoff (including CAPTCHA detection and checkpoint mode), anti-bot measures (webdriver spoofing, random delays), WSL detection with Windows Chrome fallback, and prompt injection defense via `[PAGE_CONTENT: ...]` delimiters. Includes `web-session` agent, `web-auth` and `web-browse` skills, and the `/web-ctl` command. Available at [agent-sh/web-ctl](https://github.com/agent-sh/web-ctl).
 
 - **Plugin extraction to standalone repos (#250)** — All 13 plugins extracted from `plugins/` into standalone repos under the `agent-sh` org (`agent-sh/next-task`, `agent-sh/ship`, `agent-sh/deslop`, `agent-sh/audit-project`, `agent-sh/enhance`, `agent-sh/perf`, `agent-sh/drift-detect`, `agent-sh/sync-docs`, `agent-sh/repo-map`, `agent-sh/learn`, `agent-sh/consult`, `agent-sh/debate`, `agent-sh/agnix`). The `plugins/` directory has been removed from this repo. agentsys is now a marketplace + installer.

CLAUDE.md

@@ -54,5 +54,202 @@ npm run validate  # All validators
 
 ## References
 
+<<<<<<< HEAD
+40 agents across 11 plugins. Key agents by model:
+
+| Model | Agents | Use Case |
+|-------|--------|----------|
+| **opus** | planning, implementation, perf-orchestrator, debate-orchestrator | Complex reasoning, judgment |
+| **sonnet** | exploration, learn, task-discoverer, delivery-validator, ci-fixer, deslop-agent, reporters | Validation, pattern matching |
+| **haiku** | worktree-manager, ci-monitor, simple-fixer | Mechanical execution |
+
+See [README.md](./README.md#command-details) and [docs/reference/AGENTS.md](./docs/reference/AGENTS.md) for full agent list.
+</agents>
+
+<skills>
+## Skills
+
+26 skills across plugins. Agents invoke skills for reusable implementation.
+
+| Category | Key Skills |
+|----------|------------|
+| Workflow | `orchestrate-review`, `discover-tasks`, `validate-delivery` |
+| Enhancement | `enhance-*` (9 skills for plugins, agents, docs, prompts, hooks) |
+| Performance | `baseline`, `benchmark`, `profile`, `theory-tester` |
+| Cleanup | `deslop`, `sync-docs`, `drift-analysis`, `repo-mapping` |
+
+See [README.md](./README.md#skills) for full skill list.
+</skills>
+
+<state-files>
+## State Files
+
+| File | Location | Purpose |
+|------|----------|---------|
+| `tasks.json` | `{stateDir}/` | Active task registry |
+| `flow.json` | `{stateDir}/` (worktree) | Workflow progress |
+| `preference.json` | `{stateDir}/sources/` | Cached task source |
+| `suppressions.json` | `~/.<claude\|opencode\|codex>/enhance/` | Auto-learned suppressions |
+
+Platform-aware state directory:
+- Claude Code: `.claude/`
+- OpenCode: `config/.opencode/`
+- Codex: `.codex/`
+</state-files>
+
+<workflow-agents>
+## Workflow Agents (MUST-CALL)
+
+Cannot skip in /next-task:
+- `exploration-agent` → before planning
+- `planning-agent` → before implementation
+- **Phase 9 review loop** → MUST use orchestrate-review skill
+- `delivery-validator` → before sync-docs:sync-docs-agent
+- `sync-docs:sync-docs-agent` → before /ship
+</workflow-agents>
+
+<pr-auto-review>
+## PR Auto-Review
+
+4 reviewers: Copilot, Claude, Gemini, Codex
+
+1. Wait 3 min after PR creation (initial auto-reviews)
+2. Claude-review may take 10+ min - wait for it
+3. Read ALL comments
+4. Address EVERY comment
+5. Iterate until zero unresolved
+</pr-auto-review>
+
+<model-selection>
+## Model Selection
+
+| Model | When to Use |
+|-------|-------------|
+| **Opus** | Complex reasoning, analysis where imperfection compounds |
+| **Sonnet** | Validation, pattern matching, most agents |
+| **Haiku** | Mechanical execution, no judgment needed |
+</model-selection>
+
+<priorities>
+## Core Priorities
+
+1. User DX (plugin users)
+2. Worry-free automation
+3. Token efficiency
+4. Quality output
+5. Simplicity
+</priorities>
+
+<end-reminder>
+**REMEMBER**:
+- Use CHANGELOG.md for completion tracking (not summary files)
+- BEFORE starting → Read the relevant checklist (`checklists/*.md`)
+- BEFORE delivering any work, especially releases → Go through that checklist item by item
+- 4 platforms: Claude Code + OpenCode + Codex + Cursor - ALL must work
+- Agent/Skill pattern: Agents invoke skills, skills have implementation
+- Create PRs for non-trivial changes
+</end-reminder>
+
+</project-memory>
+||||||| ddd8211
+40 agents across 11 plugins. Key agents by model:
+
+| Model | Agents | Use Case |
+|-------|--------|----------|
+| **opus** | planning, implementation, perf-orchestrator, debate-orchestrator | Complex reasoning, judgment |
+| **sonnet** | exploration, learn, task-discoverer, delivery-validator, ci-fixer, deslop-agent, reporters | Validation, pattern matching |
+| **haiku** | worktree-manager, ci-monitor, simple-fixer | Mechanical execution |
+
+See [README.md](./README.md#command-details) and [docs/reference/AGENTS.md](./docs/reference/AGENTS.md) for full agent list.
+</agents>
+
+<skills>
+## Skills
+
+26 skills across plugins. Agents invoke skills for reusable implementation.
+
+| Category | Key Skills |
+|----------|------------|
+| Workflow | `orchestrate-review`, `discover-tasks`, `validate-delivery` |
+| Enhancement | `enhance-*` (9 skills for plugins, agents, docs, prompts, hooks) |
+| Performance | `baseline`, `benchmark`, `profile`, `theory-tester` |
+| Cleanup | `deslop`, `sync-docs`, `drift-analysis`, `repo-mapping` |
+
+See [README.md](./README.md#skills) for full skill list.
+</skills>
+
+<state-files>
+## State Files
+
+| File | Location | Purpose |
+|------|----------|---------|
+| `tasks.json` | `{stateDir}/` | Active task registry |
+| `flow.json` | `{stateDir}/` (worktree) | Workflow progress |
+| `preference.json` | `{stateDir}/sources/` | Cached task source |
+| `suppressions.json` | `~/.<claude\|opencode\|codex>/enhance/` | Auto-learned suppressions |
+
+Platform-aware state directory:
+- Claude Code: `.claude/`
+- OpenCode: `config/.opencode/`
+- Codex: `.codex/`
+</state-files>
+
+<workflow-agents>
+## Workflow Agents (MUST-CALL)
+
+Cannot skip in /next-task:
+- `exploration-agent` → before planning
+- `planning-agent` → before implementation
+- **Phase 9 review loop** → MUST use orchestrate-review skill
+- `delivery-validator` → before sync-docs:sync-docs-agent
+- `sync-docs:sync-docs-agent` → before /ship
+</workflow-agents>
+
+<pr-auto-review>
+## PR Auto-Review
+
+4 reviewers: Copilot, Claude, Gemini, Codex
+
+1. Wait 3 min after PR creation (initial auto-reviews)
+2. Claude-review may take 10+ min - wait for it
+3. Read ALL comments
+4. Address EVERY comment
+5. Iterate until zero unresolved
+</pr-auto-review>
+
+<model-selection>
+## Model Selection
+
+| Model | When to Use |
+|-------|-------------|
+| **Opus** | Complex reasoning, analysis where imperfection compounds |
+| **Sonnet** | Validation, pattern matching, most agents |
+| **Haiku** | Mechanical execution, no judgment needed |
+</model-selection>
+
+<priorities>
+## Core Priorities
+
+1. User DX (plugin users)
+2. Worry-free automation
+3. Token efficiency
+4. Quality output
+5. Simplicity
+</priorities>
+
+<end-reminder>
+**REMEMBER**:
+- Use CHANGELOG.md for completion tracking (not summary files)
+- BEFORE starting → Read the relevant checklist (`checklists/*.md`)
+- BEFORE delivering any work, especially releases → Go through that checklist item by item
+- 3 platforms: Claude Code + OpenCode + Codex - ALL must work
+- Agent/Skill pattern: Agents invoke skills, skills have implementation
+- Create PRs for non-trivial changes
+</end-reminder>
+
+</project-memory>
+
+## References
+
 - Part of the [agentsys](https://github.com/agent-sh/agentsys) ecosystem
 - https://agentskills.io

README.md

@@ -21,7 +21,7 @@
 </p>
 
 <p align="center">
-  <b>14 plugins · 43 agents · 30 skills (across all repos) · 26k lines of lib code · 3,357 tests · 3 platforms</b><br>
+  <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>
 
@@ -30,7 +30,7 @@
 </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>
@@ -51,7 +51,7 @@ An agent orchestration system — 14 plugins, 43 agents, and 30 skills that comp
 
 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 via the marketplace or the npm installer, and the plugins are fetched automatically from their repos.
+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.
 
 ---
 
@@ -916,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)
 ```
@@ -971,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