sinapse-ai 7.0.5 → 7.2.0

package/docs/ide-integration.md

@@ -6,41 +6,25 @@
 
 Guide for integrating SINAPSE with supported IDEs and AI development platforms.
 
-**Version:** 4.2.11
-**Last Updated:** 2026-02-16
-
----
-
-## Compatibility Contract (SINAPSE 4.2.11)
-
-The IDE matrix is enforced by a versioned contract:
-
-- Contract file: `.sinapse-ai/infrastructure/contracts/compatibility/sinapse-4.2.11.yaml`
-- Validator: `npm run validate:parity`
-
-If matrix claims in this document diverge from validator results, parity validation fails.
+**Version:** 7.0.5
+**Last Updated:** 2026-03-25
 
 ---
 
 ## Supported IDEs
 
-SINAPSE supports multiple AI-powered development platforms. Choose the one that best fits your workflow.
+SINAPSE supports the following AI-powered development platforms:
 
-### Quick Status Matrix (SINAPSE 4.2.11)
+### Quick Status Matrix
 
-| IDE/CLI | Overall Status | How to Activate an Agent | Auto-Checks Before/After Actions | Workaround if Limited |
-| --- | --- | --- | --- | --- |
-| Claude Code | Works | `/agent-name` commands | Works (full) | -- |
-| Gemini CLI | Works | `/sinapse-menu` then `/sinapse-<agent>` | Works (minor differences in event handling) | -- |
-| Codex CLI | Limited | `/skills` then `sinapse-<agent-id>` | Limited (some checks need manual sync) | Run `npm run sync:ide:codex` and follow `/skills` flow |
-| Cursor | Limited | `@agent` + synced rules | Not available | Follow synced rules and run validators manually (`npm run validate:parity`) |
-| GitHub Copilot | Limited | chat modes + repo instructions | Not available | Use repo instructions and VS Code MCP config for context |
-| AntiGravity | Limited | workflow-driven activation | Not available | Use generated workflows and run validators manually |
+| IDE/CLI | Overall Status | How to Activate an Agent | Auto-Checks Before/After Actions |
+| --- | --- | --- | --- |
+| Claude Code | Works | `/agent-name` commands | Works (full) |
+| Codex CLI | Limited | `/skills` then `sinapse-<agent-id>` | Limited (some checks need manual sync) |
 
 Legend:
-- `Works`: fully recommended for new users in SINAPSE 4.2.11.
+- `Works`: fully recommended for new users.
 - `Limited`: usable with the documented workaround.
-- `Not available`: this IDE does not offer this capability; use the workaround instead.
 
 ### What You Lose Without Full Auto-Checks
 
@@ -49,32 +33,26 @@ Some IDEs run automatic checks before and after each action (e.g., validating co
 | IDE | Auto-Check Level | What Is Reduced | How to Compensate |
 | --- | --- | --- | --- |
 | Claude Code | Full | Nothing | Built-in checks handle everything |
-| Gemini CLI | High | Minor timing differences in checks | Gemini native checks cover most scenarios |
 | Codex CLI | Partial | Less automatic session tracking; some pre/post-action checks need manual trigger | Use `AGENTS.md` + `/skills` + sync/validation scripts |
-| Cursor | None | No automatic pre/post-action checks; no automatic audit trail | Follow synced rules, use MCP for context, run validators |
-| GitHub Copilot | None | Same as Cursor, plus more reliance on manual workflow | Use repo instructions, chat modes, VS Code MCP |
-| AntiGravity | None | No automatic check equivalents | Use generated workflows and run validators |
 
 ### Beginner Decision Guide
 
 If your goal is to get started as fast as possible:
 
-1. **Best option:** Use `Claude Code` or `Gemini CLI` -- they have the most automation and fewest manual steps.
+1. **Best option:** Use `Claude Code` -- it has the most automation and fewest manual steps.
 2. **Good option:** Use `Codex CLI` if you prefer a terminal-first workflow and can follow the `/skills` activation flow.
-3. **Usable with extra steps:** Use `Cursor`, `Copilot`, or `AntiGravity` -- they work but require more manual validation steps (see workarounds in the table above).
 
 ### Practical Consequences by Capability
 
 - **Session tracking** (automatic start/end detection):
-  - Automatic on Claude Code and Gemini CLI.
-  - Manual or partial on Codex, Cursor, Copilot, and AntiGravity.
+  - Automatic on Claude Code.
+  - Manual or partial on Codex CLI.
 - **Pre/post-action guardrails** (checks that run before and after each tool use):
-  - Full on Claude Code and Gemini CLI.
+  - Full on Claude Code.
   - Partial on Codex CLI (run sync scripts to compensate).
-  - Not available on Cursor, Copilot, and AntiGravity (run validators manually).
 - **Automatic audit trail** (record of what happened in each session):
-  - Richest on Claude Code and Gemini CLI.
-  - Reduced on other IDEs (compensate with manual logging or validator output).
+  - Richest on Claude Code.
+  - Reduced on Codex CLI (compensate with manual logging or validator output).
 
 ---
 
@@ -159,158 +137,6 @@ ls -la AGENTS.md .codex/agents/ .codex/skills/
 
 ---
 
-### Cursor
-
-**Recommendation Level:** Best (popular AI IDE)
-
-```yaml
-config_file: .cursor/rules.md
-agent_folder: .cursor/rules
-activation: @agent-name
-format: condensed-rules
-mcp_support: via configuration
-special_features:
-  - Composer integration
-  - Chat modes
-  - @codebase context
-  - Multi-file editing
-  - Subagents and cloud handoff support (latest Cursor releases)
-  - Long-running agent workflows (research preview)
-```
-
-**Setup:**
-
-1. SINAPSE creates `.cursor/` directory on init
-2. Agents activated with @mention: `@dev`, `@qa`
-3. Rules synchronized to `.cursor/rules/`
-
-**Configuration:**
-
-```bash
-# Sync Cursor only
-npm run sync:ide:cursor
-
-# Verify setup
-ls -la .cursor/rules/
-```
-
-**MCP Configuration (`.cursor/mcp.json`):**
-
-```json
-{
-  "mcpServers": {
-    "context7": {
-      "url": "https://mcp.context7.com/sse"
-    }
-  }
-}
-```
-
----
-
-### GitHub Copilot
-
-**Recommendation Level:** Good (GitHub integration)
-
-```yaml
-config_file: .github/copilot-instructions.md
-agent_folder: .github/agents
-activation: chat modes
-format: text
-mcp_support: via VS Code MCP config
-special_features:
-  - GitHub integration
-  - PR assistance
-  - Code review
-  - Works with repo instructions and VS Code MCP config
-```
-
-**Setup:**
-
-1. Enable GitHub Copilot in your repository
-2. SINAPSE creates `.github/copilot-instructions.md`
-3. Agent instructions synchronized
-
-**Configuration:**
-
-```bash
-# Sync all enabled IDE targets
-npm run sync:ide
-
-# Verify setup
-cat .github/copilot-instructions.md
-```
-
----
-
-### AntiGravity
-
-**Recommendation Level:** Good (Google integration)
-
-```yaml
-config_file: .antigravity/rules.md
-config_json: .antigravity/antigravity.json
-agent_folder: .agent/workflows
-activation: workflow-based
-format: cursor-style
-mcp_support: native (Google)
-special_features:
-  - Google Cloud integration
-  - Workflow system
-  - Native Firebase tools
-```
-
-**Setup:**
-
-1. SINAPSE creates `.antigravity/` directory
-2. Configure Google Cloud credentials
-3. Agents synchronized as workflows
-
----
-
-### Gemini CLI
-
-**Recommendation Level:** Good
-
-```yaml
-config_file: .gemini/rules.md
-agent_folder: .gemini/rules/SINAPSE/agents
-activation: slash launcher commands
-format: text
-mcp_support: native
-special_features:
-  - Google AI models
-  - CLI-based workflow
-  - Multimodal support
-  - Native hooks events and hook commands
-  - Native MCP server support
-  - Rapidly evolving command/tooling UX
-```
-
-**Setup:**
-
-1. Run installer flow selecting `gemini` in IDE selection (wizard path)
-2. SINAPSE creates:
-   - `.gemini/rules.md`
-   - `.gemini/rules/SINAPSE/agents/*.md`
-   - `.gemini/commands/*.toml` (`/sinapse-menu`, `/sinapse-<agent>`)
-   - `.gemini/hooks/*.js`
-   - `.gemini/settings.json` (hooks enabled)
-3. Validate integration:
-
-```bash
-npm run sync:ide:gemini
-npm run validate:gemini-sync
-npm run validate:gemini-integration
-```
-
-4. Quick agent activation (recommended):
-   - `/sinapse-menu` to list shortcuts
-   - `/sinapse-dev`, `/sinapse-architect`, `/sinapse-qa`, etc.
-   - `/sinapse-agent <agent-id>` for generic launcher
-
----
-
 ## Sync System
 
 ### How Sync Works
@@ -319,13 +145,12 @@ SINAPSE maintains a single source of truth for agent definitions and synchronize
 
 ```
 ┌─────────────────────────────────────────────────────┐
-│                    SINAPSE Core                         │
-│  .sinapse-ai/development/agents/  (Source of Truth)  │
-│                        │                             │
+│                    SINAPSE Core                     │
+│  .sinapse-ai/development/agents/  (Source of Truth) │
+│                        │                            │
 │            ┌───────────┼───────────┐                │
-│            ▼           ▼           ▼                │
-│  .claude/     .codex/      .cursor/                  │
-│  .antigravity/ .gemini/                              │
+│            ▼           ▼                            │
+│  .claude/     .codex/                               │
 └─────────────────────────────────────────────────────┘
 ```
 
@@ -335,11 +160,6 @@ SINAPSE maintains a single source of truth for agent definitions and synchronize
 # Sync all IDE targets
 npm run sync:ide
 
-# Sync only Gemini
-npm run sync:ide:gemini
-npm run sync:ide:github-copilot
-npm run sync:ide:antigravity
-
 # Validate sync
 npm run sync:ide:check
 ```
@@ -357,10 +177,6 @@ auto_sync:
   platforms:
     - claude
     - codex
-    - github-copilot
-    - cursor
-    - gemini
-    - antigravity
 ```
 
 ---
@@ -378,9 +194,7 @@ npm run sync:ide
 npm run sync:ide:check
 
 # Check platform-specific directory
-ls .cursor/rules/agents/               # Cursor
 ls .claude/commands/SINAPSE/agents/       # Claude Code
-ls .gemini/rules/SINAPSE/agents/          # Gemini CLI
 ```
 
 ### Sync Conflicts
@@ -389,8 +203,7 @@ ls .gemini/rules/SINAPSE/agents/          # Gemini CLI
 # Preview what would change
 npm run sync:ide -- --dry-run
 
-# Backup before force sync
-cp -r .cursor/rules/ .cursor/rules.backup/
+# Force sync
 npm run sync:ide
 ```
 
@@ -402,7 +215,6 @@ sinapse mcp status
 
 # Verify MCP configuration for IDE
 cat ~/.claude.json  # For Claude Code
-cat .cursor/mcp.json  # For Cursor
 ```
 
 ### IDE-Specific Issues
@@ -412,67 +224,14 @@ cat .cursor/mcp.json  # For Cursor
 - Ensure `.claude/` is in project root
 - Check hooks permissions: `chmod +x .claude/hooks/*.py`
 
-**Cursor:**
-
-- Restart Cursor after sync
-- Check `.cursor/rules/` permissions
-
-## Platform Decision Guide
-
-Use this guide to choose the right platform:
-
-```
-Do you use Claude/Anthropic API?
-├── Yes --> Claude Code (Best SINAPSE integration)
-└── No
-    └── Do you prefer VS Code?
-        ├── Yes --> Want an extension?
-        │   ├── Yes --> GitHub Copilot (Native GitHub features)
-        │   └── No --> GitHub Copilot (Native GitHub features)
-        └── No --> Want a dedicated AI IDE?
-            ├── Yes --> Which model do you prefer?
-            │   ├── Claude/GPT --> Cursor (Most popular AI IDE)
-            └── No --> Use Google Cloud?
-                ├── Yes --> AntiGravity (Google integration)
-                └── No --> Gemini CLI (Specialized)
-```
-
----
-
-## Migration Between IDEs
-
-### From Cursor to Claude Code
-
-```bash
-# Export current rules
-cp -r .cursor/rules/ ./rules-backup/
-
-# Initialize Claude Code
-npm run sync:ide
-
-# Verify migration
-diff -r ./rules-backup/ .claude/commands/SINAPSE/agents/
-```
-
-### From Claude Code to Cursor
-
-```bash
-# Sync to Cursor
-npm run sync:ide:cursor
-
-# Configure MCP (if needed)
-# Copy MCP config to .cursor/mcp.json
-```
-
 ---
 
 ## Related Documentation
 
 - [Claude Code Guide](./pt/platforms/claude-code.md)
-- [Cursor Guide](./pt/platforms/cursor.md)
 - [Agent Selection Guide](./guides/agent-selection-guide.md)
 - [MCP Global Setup](./guides/mcp-global-setup.md)
 
 ---
 
-_SINAPSE IDE Integration Guide v4.2.11_
+_SINAPSE IDE Integration Guide v7.0.5_

package/docs/installation/README.md

@@ -76,12 +76,10 @@ npx sinapse-ai install --force-upgrade
 
 ## Supported IDEs
 
-| IDE            | Agent Activation    |
-| -------------- | ------------------- |
-| Claude Code    | `/dev`, `/qa`, etc. |
-| Cursor         | `@dev`, `@qa`, etc. |
-| Gemini CLI     | Mention in prompt   |
-| GitHub Copilot | Chat modes          |
+| IDE         | Agent Activation    |
+| ----------- | ------------------- |
+| Claude Code | `/dev`, `/qa`, etc. |
+| Codex CLI   | `/skills` flow      |
 
 ---
 

package/docs/installation/faq.md

@@ -75,11 +75,11 @@ npx sinapse-ai install
 The installer will:
 
 - Create `.sinapse-ai/` directory (framework files)
-- Create IDE configuration (`.claude/`, `.cursor/`, etc.)
+- Create IDE configuration (`.claude/`, etc.)
 - NOT modify your existing source code
 - NOT overwrite existing documentation unless you choose to
 
-**Important:** If you have an existing `.claude/` or `.cursor/` directory, the installer will ask before modifying.
+**Important:** If you have an existing `.claude/` directory, the installer will ask before modifying.
 
 ---
 
@@ -119,9 +119,6 @@ your-project/
 ├── .claude/                    # Claude Code (if selected)
 │   └── commands/SINAPSE/agents/   # Agent slash commands
 │
-├── .cursor/                    # Cursor (if selected)
-│   └── rules/                  # Agent rules
-│
 ├── docs/                       # Documentation structure
 │   ├── stories/                # Development stories
 │   ├── architecture/           # Architecture docs
@@ -223,7 +220,7 @@ mv .sinapse-ai.backup .sinapse-ai
 npx sinapse-ai install
 
 # Package for offline use
-tar -czvf sinapse-offline.tar.gz .sinapse-ai/ .claude/ .cursor/
+tar -czvf sinapse-offline.tar.gz .sinapse-ai/ .claude/
 ```
 
 **On air-gapped machine:**
@@ -254,7 +251,7 @@ tar -xzvf sinapse-offline.tar.gz
    # Install and package
    npx sinapse-ai install
    cd your-project
-   tar -czvf sinapse-transfer.tar.gz .sinapse-ai/ .claude/ .cursor/ docs/
+   tar -czvf sinapse-transfer.tar.gz .sinapse-ai/ .claude/ docs/
    ```
 
 2. **Transfer the archive** via USB, secure transfer, etc.
@@ -276,14 +273,10 @@ tar -xzvf sinapse-offline.tar.gz
 
 **Answer:**
 
-| IDE                | Status       | Agent Activation    |
-| ------------------ | ------------ | ------------------- |
-| **Claude Code**    | Full Support | `/dev`, `/qa`, etc. |
-| **Cursor**         | Full Support | `@dev`, `@qa`, etc. |
-| **Gemini CLI**     | Full Support | Mention in prompt   |
-| **GitHub Copilot** | Full Support | Chat modes          |
-
-**Adding support for a new IDE:** Open a GitHub issue with the IDE's agent/rules specification.
+| IDE             | Status       | Agent Activation    |
+| --------------- | ------------ | ------------------- |
+| **Claude Code** | Full Support | `/dev`, `/qa`, etc. |
+| **Codex CLI**   | Limited      | `/skills` flow      |
 
 ---
 
@@ -291,23 +284,7 @@ tar -xzvf sinapse-offline.tar.gz
 
 **Answer:** Yes! Select multiple IDEs during installation:
 
-**Interactive:**
-
-```
-? Which IDE(s) do you want to configure?
-❯ ◉ Cursor
-  ◉ Claude Code
-```
-
-**Command line:**
-
-```bash
-```
-
-Each IDE gets its own configuration directory:
-
-- `.cursor/rules/` for Cursor
-- `.claude/commands/` for Claude Code
+The installer configures supported IDEs automatically. Claude Code uses `.claude/commands/` for agent configuration.
 
 ---
 
@@ -323,7 +300,7 @@ git clone your-repo
 cd your-repo
 
 # Optionally configure their preferred IDE
-npx sinapse-ai install --ide cursor
+npx sinapse-ai install
 ```
 
 If `.sinapse-ai/` is not committed:

package/docs/installation/linux.md

@@ -181,7 +181,6 @@ The installer automatically:
 - ✅ Detects your Linux distribution and applies optimizations
 - ✅ Creates necessary directories with proper Unix permissions (755/644)
 - ✅ Configures IDE paths for Linux:
-  - Cursor: `~/.config/Cursor/`
   - Claude: `~/.claude/`
 - ✅ Sets up shell scripts with Unix line endings (LF)
 - ✅ Respects XDG Base Directory specification
@@ -191,20 +190,6 @@ The installer automatically:
 
 ## IDE-Specific Setup
 
-### Cursor
-
-1. Install Cursor: Download from [cursor.sh](https://cursor.sh/)
-
-   ```bash
-   # AppImage method
-   chmod +x cursor-*.AppImage
-   ./cursor-*.AppImage
-   ```
-
-2. IDE rules are installed to `.cursor/rules/`
-3. Keyboard shortcut: `Ctrl+L` to open chat
-4. Use `@agent-name` to activate agents
-
 ### Claude Code (CLI)
 
 1. Install Claude Code:
@@ -216,14 +201,6 @@ The installer automatically:
 2. Commands are installed to `.claude/commands/SINAPSE/`
 3. Use `/agent-name` to activate agents
 
-
-3. Use `@agent-name` to activate agents
-
-### VS Code (with Continue extension)
-
-1. Install Continue extension
-2. Configure SINAPSE rules in `.continue/`
-
 ---
 
 ## Troubleshooting

package/docs/installation/macos.md

@@ -74,27 +74,17 @@ The installer automatically:
 - ✅ Detects macOS and applies platform-specific configurations
 - ✅ Creates necessary directories with proper permissions
 - ✅ Configures IDE paths for macOS locations:
-  - Cursor: `~/Library/Application Support/Cursor/`
   - Claude: `~/.claude/`
 - ✅ Sets up shell scripts with Unix line endings
 - ✅ Handles case-sensitive filesystems properly
 
 ## IDE-Specific Setup
 
-### Cursor
-
-1. IDE rules are installed to `.cursor/rules/`
-2. Keyboard shortcut: `Cmd+L` to open chat
-3. Use `@agent-name` to activate agents
-
 ### Claude Code
 
 1. Commands are installed to `.claude/commands/SINAPSE/`
 2. Use `/agent-name` to activate agents
 
-
-2. Use `@agent-name` to activate agents
-
 ## Troubleshooting
 
 ### Permission Issues

package/docs/installation/troubleshooting.md

@@ -547,15 +547,12 @@ nvm use 16
    ```bash
    # Claude Code
    ls .claude/commands/SINAPSE/agents/
-
-   # Cursor
-   ls .cursor/rules/
    ```
 
 3. Check IDE settings allow custom commands
-4. Re-run installation for specific IDE:
+4. Re-run installation:
    ```bash
-   npx sinapse-ai install --ide claude-code
+   npx sinapse-ai install
    ```
 
 ---
@@ -567,9 +564,8 @@ nvm use 16
 **Solution:**
 
 1. Check IDE version is compatible
-2. For Cursor: Ensure files have `.mdc` extension
-3. For Claude Code: Files should be in `.claude/commands/`
-4. Restart IDE after installation
+2. For Claude Code: Files should be in `.claude/commands/`
+3. Restart IDE after installation
 
 ---
 
@@ -690,7 +686,7 @@ ls -la .sinapse-ai/
 - OS: [Windows 11 / macOS 14 / Ubuntu 22.04]
 - Node.js version: [output of `node --version`]
 - npm version: [output of `npm --version`]
-- IDE: [Claude Code / Cursor / etc.]
+- IDE: [Claude Code / Codex CLI]
 
 **Steps to Reproduce:**
 1. [First step]

package/docs/installation/v4-quick-start.md

@@ -230,7 +230,7 @@ npm cache clean --force
 
 ### Agent not responding
 
-1. Ensure you're in an AI-powered IDE (Cursor, VS Code with Claude, etc.) or Claude Code CLI
+1. Ensure you're in Claude Code CLI or Codex CLI
 2. Check you're using correct activation syntax: `@agent-name`
 3. Verify agent file exists: `ls .sinapse-ai/development/agents/`
 

package/docs/installation/windows.md

@@ -156,7 +156,6 @@ The installer automatically:
 - ✅ Detects Windows and applies platform-specific configurations
 - ✅ Creates necessary directories with proper permissions
 - ✅ Configures IDE paths for Windows locations:
-  - Cursor: `%APPDATA%\Cursor\`
   - Claude: `%USERPROFILE%\.claude\`
 - ✅ Handles Windows path separators (backslashes)
 - ✅ Configures line endings correctly (CRLF for batch, LF for scripts)
@@ -166,14 +165,6 @@ The installer automatically:
 
 ## IDE-Specific Setup
 
-### Cursor
-
-1. Download from [cursor.sh](https://cursor.sh/)
-2. Run the installer
-3. IDE rules are installed to `.cursor\rules\`
-4. Keyboard shortcut: `Ctrl+L` to open chat
-5. Use `@agent-name` to activate agents
-
 ### Claude Code (CLI)
 
 1. Install Claude Code:
@@ -185,15 +176,6 @@ The installer automatically:
 2. Commands are installed to `.claude\commands\SINAPSE\`
 3. Use `/agent-name` to activate agents
 
-
-2. Run the installer
-4. Use `@agent-name` to activate agents
-
-### VS Code
-
-1. Install Continue extension from marketplace
-2. SINAPSE can integrate via `.continue\` configuration
-
 ---
 
 ## Troubleshooting