Skip to content

multi-platform-integration-plan.md

Latest commit

 

History

History
301 lines (219 loc) · 10.7 KB

multi-platform-integration-plan.md

File metadata and controls

301 lines (219 loc) · 10.7 KB
Raw

Multi-Platform Integration Plan: Agentic QE v3

Created: 2026-02-27 Status: In Progress Scope: Add support for 8 coding agent platforms

Executive Summary

Add support for 8 major coding agent platforms to the existing AQE MCP server. The core MCP server already works. The work is primarily about config generation, behavioral instruction files, setup automation, and testing for each platform.

MCP has become the universal standard — nearly all major platforms support it natively. A single well-built AQE MCP server covers ~90% of the market.

Current State

Platform Status Config Location Installer
Claude Code Native (home platform) .claude/mcp.json Built-in to init wizard
OpenCode Integrated opencode.json (root) v3/src/init/opencode-installer.ts
Kiro Integrated .kiro/settings/mcp.json v3/src/init/kiro-installer.ts

Platforms to Add

Priority 1 (JSON-based MCP, highest market reach)

Platform Users Config Path Config Key Rules File
GitHub Copilot 20M .vscode/mcp.json servers .github/copilot-instructions.md
Cursor 360K paid .cursor/mcp.json mcpServers .cursorrules
Cline 5M installs .vscode/cline_mcp_settings.json mcpServers Custom modes (JSON)
Kilo Code 1.5M .kilocode/mcp.json mcpServers Custom modes (JSON)
Roo Code Growing .roo/mcp.json mcpServers Custom modes (JSON)

Priority 2 (Different config formats)

Platform Users Config Path Format Rules File
OpenAI Codex CLI 1M+ .codex/config.toml [mcp_servers] TOML AGENTS.md
Windsurf Large .windsurf/mcp_config.json JSON .windsurfrules
Continue.dev Enterprise .continue/config.yaml YAML .continue/rules/aqe-qe-standards.yaml

Phase 1: Universal Config Generator + Priority 1 Platforms

Timeline: 2-3 weeks Status: [x] Complete

Milestone 1.1: Universal Config Generator

File: v3/src/init/platform-config-generator.ts

  • PlatformConfigGenerator class with generateMcpConfig() and generateBehavioralRules()
  • Platform registry mapping all 8 platforms to their config paths, keys, and formats
  • Unit tests for all platform config formats (22 tests in platform-config-generator.test.ts)

Milestone 1.2: GitHub Copilot Integration

Files: v3/src/init/copilot-installer.ts, .github/copilot-instructions.md template

  • Installer class following OpenCode/Kiro pattern
  • MCP config generation (.vscode/mcp.json with servers key)
  • Behavioral rules template (copilot-instructions.md)
  • Integration test: v3/tests/integration/platform-installers.test.ts (shared, 76 tests)
  • Unit test: v3/tests/unit/init/copilot-installer.test.ts (9 tests)

MCP Config format:

{
  "servers": {
    "agentic-qe": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "agentic-qe@latest", "mcp"],
      "env": {
        "AQE_MEMORY_PATH": ".agentic-qe/memory.db",
        "AQE_V3_MODE": "true"
      }
    }
  }
}

Milestone 1.3: Cursor Integration

Files: v3/src/init/cursor-installer.ts, .cursorrules template

  • Installer class
  • MCP config generation (.cursor/mcp.json with mcpServers key)
  • Behavioral rules template (.cursorrules)
  • Integration test: (shared in platform-installers.test.ts)
  • Unit test: v3/tests/unit/init/cursor-installer.test.ts (8 tests)

Milestone 1.4: Cline Integration

Files: v3/src/init/cline-installer.ts, custom mode template

  • Installer class
  • MCP config generation (cline_mcp_settings.json with mcpServers key)
  • Custom QE mode definition
  • alwaysAllow list for safe tools
  • Integration test: (shared in platform-installers.test.ts)
  • Unit test: v3/tests/unit/init/cline-installer.test.ts (11 tests)

Milestone 1.5: Kilo Code Integration

Files: v3/src/init/kilocode-installer.ts, custom mode template

  • Installer class
  • MCP config generation (.kilocode/mcp.json with mcpServers key)
  • Custom QE mode definition
  • Marketplace listing investigation
  • Integration test: (shared in platform-installers.test.ts)
  • Unit test: v3/tests/unit/init/kilocode-installer.test.ts (10 tests)

Milestone 1.6: Roo Code Integration

Files: v3/src/init/roocode-installer.ts, mode config template

  • Installer class
  • MCP config generation (.roo/mcp.json with mcpServers key)
  • Mode configuration
  • Integration test: (shared in platform-installers.test.ts)
  • Unit test: v3/tests/unit/init/roocode-installer.test.ts (11 tests)

Phase 2: Priority 2 Platforms (Different Config Formats)

Timeline: 1-2 weeks Status: [x] Core Implementation Complete

Milestone 2.1: OpenAI Codex CLI Integration

  • v3/src/init/codex-installer.ts
  • TOML config generation (config.toml under [mcp_servers])
  • AGENTS.md behavioral rules template
  • Integration test: (shared in platform-installers.test.ts)
  • Unit test: v3/tests/unit/init/codex-installer.test.ts (11 tests)

MCP Config format:

[mcp_servers.agentic-qe]
type = "stdio"
command = "npx"
args = ["-y", "agentic-qe@latest", "mcp"]

[mcp_servers.agentic-qe.env]
AQE_MEMORY_PATH = ".agentic-qe/memory.db"
AQE_V3_MODE = "true"

Milestone 2.2: Windsurf Integration

  • v3/src/init/windsurf-installer.ts
  • JSON config generation (project-level .windsurf/mcp_config.json)
  • .windsurfrules behavioral rules template
  • Integration test: (shared in platform-installers.test.ts)
  • Unit test: v3/tests/unit/init/windsurf-installer.test.ts (11 tests)

Milestone 2.3: Continue.dev Integration

  • v3/src/init/continuedev-installer.ts
  • YAML config generation (.continue/config.yaml)
  • Rules in YAML format
  • Integration test: (shared in platform-installers.test.ts)
  • Unit test: v3/tests/unit/init/continuedev-installer.test.ts (11 tests)

Phase 3: CLI Integration and Init Wizard

Timeline: 1 week Status: [x] Complete

Milestone 3.1: CLI init Command Enhancement

  • Add --with-copilot flag
  • Add --with-cursor flag
  • Add --with-cline flag
  • Add --with-kilocode flag
  • Add --with-roocode flag
  • Add --with-codex flag
  • Add --with-windsurf flag
  • Add --with-continuedev flag
  • Add --with-all-platforms flag
  • Add aqe platform setup <name> command
  • Add aqe platform list command
  • Add aqe platform verify <name> command

Milestone 3.2: Export Init Module

  • Update v3/src/init/index.ts with all new installer exports

Phase 4: Testing Strategy

Timeline: 1 week (parallel with Phase 1-2) Status: [x] Complete

Per Platform

Test Type Location What It Tests
Unit v3/tests/unit/init/<platform>-installer.test.ts Config generation, file writing
Integration v3/tests/integration/platform-installers.test.ts Real fs, format validation, merge (76 tests)
Integration v3/tests/integration/cross-platform-init.test.ts Multi-platform init, auto-detection (23 tests)

Shared

  • v3/tests/integration/platform-installers.test.ts -- all platforms integration (76 tests)
  • v3/tests/integration/cross-platform-init.test.ts -- cross-platform init + auto-detection (23 tests)

Phase 5: Marketplace and Distribution

Timeline: 1-2 weeks Status: [ ] Not Started

  • Cline MCP Marketplace listing
  • Kilo Code MCP Marketplace listing
  • VS Code Marketplace consideration (Copilot discovery)

Phase 6: Documentation

Timeline: 3-5 days (parallel) Status: [x] Complete

  • docs/platform-setup-guide.md -- per-platform setup instructions (all 11 platforms)
  • Per-platform quickstart in setup guide (automated + manual for each)
  • ADR-028: Multi-Platform Support decision record (deferred)

Files Inventory

New Files Created

File Purpose Status
v3/src/init/platform-config-generator.ts Universal config generator Done
v3/src/init/copilot-installer.ts GitHub Copilot installer Done
v3/src/init/cursor-installer.ts Cursor installer Done
v3/src/init/cline-installer.ts Cline installer Done
v3/src/init/kilocode-installer.ts Kilo Code installer Done
v3/src/init/roocode-installer.ts Roo Code installer Done
v3/src/init/codex-installer.ts OpenAI Codex CLI installer Done
v3/src/init/windsurf-installer.ts Windsurf installer Done
v3/src/init/continuedev-installer.ts Continue.dev installer Done
v3/src/cli/commands/platform.ts aqe platform list/setup/verify CLI Done
v3/tests/unit/init/*-installer.test.ts (x8) Per-platform unit tests Done
v3/tests/unit/init/platform-config-generator.test.ts Config generator tests (22) Done
v3/tests/integration/platform-installers.test.ts Real fs integration (76 tests) Done
v3/tests/integration/cross-platform-init.test.ts Cross-platform init (23 tests) Done
docs/platform-setup-guide.md Per-platform setup instructions Done

Note: Behavioral rules (copilot-instructions.md, .cursorrules, etc.) are generated inline by PlatformConfigGenerator — no separate template files needed.

Files to Modify

File Change
v3/src/init/index.ts Export new installers
v3/src/init/init-wizard.ts Add --with-<platform> flags
v3/src/cli/commands/init.ts Wire new CLI flags
package.json (files array) Include new templates

Success Metrics

Metric Target
Platforms supported 11 (Claude Code + OpenCode + Kiro + 8 new)
Config generation tests passing 100%
MCP compatibility tests passing 100% per platform
CLI flags working All 8 --with-<platform> flags
Time to setup any platform < 30 seconds
npm package size increase < 50KB

Implementation Order

  1. Universal Config Generator (foundation)
  2. GitHub Copilot (20M users)
  3. Cursor (360K paid)
  4. Cline + Kilo Code + Roo Code (parallel — near-identical JSON)
  5. CLI --with-<platform> flags
  6. Codex + Windsurf + Continue.dev
  7. Tests, marketplace, docs