> ## Documentation Index
> Fetch the complete documentation index at: https://docs.encoreos.io/llms.txt
> Use this file to discover all available pages before exploring further.

# AI Platform Capability Parity Matrix

> Version: 1.0.0 Last Updated: 2026-04-12

**Version:** 1.0.0\
**Last Updated:** 2026-04-12

This document tracks which AI development capabilities exist on each platform (Cursor IDE, Claude Code, GitHub Copilot) and whether the gaps are intentional (platform-specific) or represent work to close.

**Canonical quick reference:** [AGENTS.md](../../AGENTS.md)\
**Hierarchy:** `constitution.md` → `AI_GUIDE.md` → `AGENTS.md` → `.cursor/rules/` → core-specific `AGENTS.md`

***

## Platform Overview

| Platform           | Entry Point                                                              | Primary Use                  | Config Location         |
| ------------------ | ------------------------------------------------------------------------ | ---------------------------- | ----------------------- |
| **Cursor IDE**     | .cursor/README.md                                                        | Primary IDE; full automation | `.cursor/`              |
| **Claude Code**    | [CLAUDE.md](../../CLAUDE.md) / .claude/README.md                         | Alternative IDE; code review | `.claude/`              |
| **GitHub Copilot** | [.github/copilot-instructions.md](../../.github/copilot-instructions.md) | Browser/VS Code extension    | `.github/instructions/` |

***

## Capability Matrix

### Agents / Specialists

| Capability                  | Cursor IDE                      | Claude Code                                    | GitHub Copilot | Gap Type                                 |
| --------------------------- | ------------------------------- | ---------------------------------------------- | -------------- | ---------------------------------------- |
| Spec reviewer               | ✅ `spec-reviewer`               | ✅ `.claude/agents/spec-review`                 | ❌              | Intentional (Copilot is extension-based) |
| Code reviewer               | ✅ `code-reviewer`               | ✅ `.claude/agents/code-reviewer`               | ❌              | Intentional                              |
| Security auditor            | ✅ `security-auditor`            | ❌                                              | ❌              | Gap — consider porting                   |
| Compliance reviewer         | ✅ `compliance-reviewer`         | ✅ `.claude/agents/compliance-reviewer`         | ❌              | Intentional                              |
| Debugger                    | ✅ `debugger`                    | ❌                                              | ❌              | Gap — consider porting                   |
| Migration helper            | ✅ `migration-helper`            | ❌                                              | ❌              | Gap — consider porting                   |
| Test generator              | ✅ `test-generator`              | ✅ `.claude/agents/test-generator`              | ❌              | Intentional                              |
| Documentation updater       | ✅ `documentation-updater`       | ✅ `.claude/agents/documentation-expert`        | ❌              | Intentional                              |
| Architecture validator      | ✅ `architecture-validator`      | ❌                                              | ❌              | Gap — consider porting                   |
| Technical researcher        | ✅ `technical-researcher`        | ❌                                              | ❌              | Gap                                      |
| Dead code auditor           | ✅ `dead-code-auditor`           | ❌                                              | ❌              | Gap                                      |
| Module strategic reviewer   | ✅ `module-strategic-reviewer`   | ❌                                              | ❌              | Cursor-specific (full agent context)     |
| Verifier                    | ✅ `verifier`                    | ❌                                              | ❌              | Gap — consider porting                   |
| Supabase schema architect   | ✅ `supabase-schema-architect`   | ❌                                              | ❌              | Gap                                      |
| EHR/PM research planner     | ✅ `ehr-pm-research-planner`     | ❌                                              | ❌              | Cursor-specific                          |
| Document structure analyzer | ✅ `document-structure-analyzer` | ✅ `.claude/agents/document-structure-analyzer` | ❌              | Intentional                              |
| Technical writer            | ✅ `technical-writer`            | ✅ `.claude/agents/technical-writer`            | ❌              | Intentional                              |

**Cursor total:** 24 agents | **Claude total:** 6 agents | **Copilot:** 0 (path-scoped instructions only)

### Skills / Workflows

| Skill                          | Cursor IDE                | Claude Code           | GitHub Copilot | Gap Type    |
| ------------------------------ | ------------------------- | --------------------- | -------------- | ----------- |
| Module spec authoring          | ✅                         | ❌                     | ❌              | Gap         |
| Module implementation workflow | ✅                         | ❌                     | ❌              | Gap         |
| Module testing strategy        | ✅                         | ❌                     | ❌              | Gap         |
| Module regulatory compliance   | ✅                         | ❌                     | ❌              | Gap         |
| Module database design         | ✅                         | ❌                     | ❌              | Gap         |
| Module integration patterns    | ✅                         | ❌                     | ❌              | Gap         |
| Module task management         | ✅                         | ❌                     | ❌              | Gap         |
| Module planning                | ✅                         | ❌                     | ❌              | Gap         |
| Systematic debugging           | ✅                         | ❌                     | ❌              | Gap         |
| Verification before completion | ✅                         | ❌                     | ❌              | Gap         |
| TDD workflow                   | ✅                         | ❌                     | ❌              | Gap         |
| Playwright testing             | ✅                         | ❌                     | ❌              | Gap         |
| HR E2E browser testing         | ✅                         | ❌                     | ❌              | Gap         |
| API integration specialist     | ✅                         | ✅                     | ❌              | Intentional |
| Code review                    | ✅                         | ✅                     | ❌              | Intentional |
| Doc update                     | ✅ (documentation-updater) | ✅                     | ❌              | Intentional |
| Spec review                    | ✅                         | ✅                     | ❌              | Intentional |
| Supabase security audit        | ✅                         | ✅ `.claude/commands/` | ❌              | Intentional |
| Dead code audit                | ✅                         | ❌                     | ❌              | Gap         |
| AI slop audit                  | ✅                         | ❌                     | ❌              | Gap         |

**Cursor total:** 23 skills | **Claude total:** 5 skills | **Copilot:** 0

### Rules / Pattern Files

| Pattern Coverage      | Cursor IDE                                   | Claude Code                            | GitHub Copilot                                     | Notes                          |
| --------------------- | -------------------------------------------- | -------------------------------------- | -------------------------------------------------- | ------------------------------ |
| Database patterns     | ✅ `.cursor/rules/database-patterns.mdc`      | ✅ `.claude/rules/database-patterns.md` | ✅ `.github/instructions/database.instructions.md`  | Full parity                    |
| RLS tests             | ✅ `.cursor/rules/testing.md`                 | ✅ `.claude/rules/rls-tests.md`         | ✅ `.github/instructions/rls-tests.instructions.md` | Full parity                    |
| Clinical patterns     | ✅ `.cursor/rules/cl-patterns.md`             | ✅ `.claude/rules/clinical.md`          | ✅ `.github/instructions/clinical.instructions.md`  | Full parity                    |
| Security patterns     | ✅ `.cursor/rules/security-patterns.md`       | ✅ `.claude/rules/security.md`          | ❌                                                  | Copilot gap                    |
| Quick reference       | ✅ `.cursor/rules/quick-reference.mdc`        | ❌                                      | ❌                                                  | Cursor-specific (always-apply) |
| Form libraries        | ✅ `.cursor/rules/form-libraries.md`          | ❌                                      | ❌                                                  | Gap                            |
| Performance patterns  | ✅ `.cursor/rules/performance-patterns.md`    | ❌                                      | ❌                                                  | Gap                            |
| Error handling        | ✅ `.cursor/rules/error-handling-patterns.md` | ❌                                      | ❌                                                  | Gap                            |
| HR patterns           | ✅ `.cursor/rules/hr-patterns.md`             | ❌                                      | ❌                                                  | Gap                            |
| FA patterns           | ✅ `.cursor/rules/fa-patterns.md`             | ❌                                      | ❌                                                  | Gap                            |
| Dialog size standards | ✅ `.cursor/rules/dialog-size-standards.md`   | ❌                                      | ❌                                                  | Gap                            |
| Shared UI             | ❌                                            | ❌                                      | ✅ `.github/instructions/shared-ui.instructions.md` | Copilot-native                 |

**Cursor total:** 36 rules | **Claude total:** 4 path-scoped | **Copilot:** 5 path-scoped

### Commands / Workflows

| Command Category          | Cursor IDE    | Claude Code | GitHub Copilot |
| ------------------------- | ------------- | ----------- | -------------- |
| Database (migrations)     | ✅ 12 commands | ❌           | ❌              |
| Development (build, test) | ✅ 15 commands | ❌           | ❌              |
| Documentation             | ✅ 8 commands  | ❌           | ❌              |
| Specs workflow            | ✅ 20 commands | ❌           | ❌              |
| PR / review               | ✅ 8 commands  | ❌           | ❌              |
| Fix issue                 | ✅ 8 commands  | ❌           | ❌              |
| Supabase security audit   | ❌             | ✅ 1 command | ❌              |

**Cursor total:** 73 commands | **Claude total:** 1 command | **Copilot:** 0

### Hooks & Automation

| Hook                     | Cursor IDE                                | Claude Code                 | GitHub Copilot |
| ------------------------ | ----------------------------------------- | --------------------------- | -------------- |
| PHI scanner (pre-edit)   | ✅ `.cursor/hooks/phi-scanner.js`          | ✅ PreToolUse edit guard     | ❌              |
| Sensitive file guard     | ✅ `.cursor/hooks/sensitive-file-guard.js` | ✅ PreToolUse file guard     | ❌              |
| Risky command guard      | ✅ `.cursor/hooks/risky-command-guard.js`  | ❌                           | ❌              |
| Auto-format on edit      | ✅ PostToolUse Biome                       | ✅ PostToolUse Biome         | ❌              |
| Session context reinject | ✅ *(implicit via always-apply rules)*     | ✅ SessionStart hook         | ❌              |
| Notification             | ❌                                         | ✅ `notify-send`/`osascript` | ❌              |

***

## Policy: Shared vs Platform-Specific

### Shared (All Platforms Must Have)

All platforms must convey these policies to AI (via rules, instructions, or agent prompts):

* Tenant isolation: `organization_id` on all mutations
* No PHI in prompts, logs, or error messages
* No direct core-to-core imports — use `@/platform/*`
* RLS on all new tables
* `sanitizeErrorMessage` for user-facing errors
* `useCurrentUser` for auth (not ad-hoc `supabase.auth.getUser()`)
* `staleTime: 5m` and `gcTime: 10m` on all `useQuery` calls
* No hardcoded state Medicaid rules — use PF-96 jurisdiction profiles
* No inline `pf_user_role_assignments` in edge functions — use `verifyOrgAccess()`

**Status:** Cursor (✅ quick-reference.mdc always-apply) | Claude (✅ `.claude/rules/` path-scoped) | Copilot (⚠️ partial — AGENTS.md + some instructions)

### Intentionally Platform-Specific

* **Cursor only:** Full agent fleet (24 agents), 73 commands, skills, MCP servers, IDE hooks
* **Claude only:** SessionStart reinject hook, file organizer skill, notification hook
* **Copilot only:** Shared-UI path-scoped instructions (`.github/instructions/shared-ui.instructions.md`)

***

## Known Gaps to Address

| Gap                                           | Priority | Effort | Action                                              |
| --------------------------------------------- | -------- | ------ | --------------------------------------------------- |
| Copilot missing security patterns instruction | High     | Low    | Add `.github/instructions/security.instructions.md` |
| Claude missing debugger / verifier agents     | Medium   | Medium | Port Cursor `debugger.md` and `verifier.md` agents  |
| Claude missing module workflow skills         | Medium   | Medium | Port key Cursor skills to `.claude/skills/`         |
| Copilot missing pre-flight checklist          | High     | Low    | Add to `copilot-instructions.md`                    |
| Performance patterns only in Cursor           | Medium   | Low    | Add to Claude rules + Copilot instructions          |

***

## Maintenance

**Monthly governance check:** Reconcile this matrix when any AI config changes. See [AGENTS.md §AI Configuration Governance Cadence](../../AGENTS.md).

**When a new agent/skill/rule is added to Cursor:** Update this table and determine if it should be ported to Claude or Copilot.
