Encore OS — Documentation

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
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/README.md	Alternative IDE; code review	`.claude/`
GitHub Copilot	.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. When a new agent/skill/rule is added to Cursor: Update this table and determine if it should be ported to Claude or Copilot.

Start Here

Module Engineering Snapshots

Canonical AI Governance

Architecture

Integrations

Development

Decision Guides

Database

Module Reference

Testing

Migration

Operations

Governance & Security

Platform Internals

AI Platform Capability Parity Matrix

Platform Overview

Capability Matrix

Agents / Specialists

Skills / Workflows

Rules / Pattern Files

Commands / Workflows

Hooks & Automation

Policy: Shared vs Platform-Specific

Shared (All Platforms Must Have)

Intentionally Platform-Specific

Known Gaps to Address

Maintenance

​Platform Overview

​Capability Matrix

​Agents / Specialists

​Skills / Workflows

​Rules / Pattern Files

​Commands / Workflows

​Hooks & Automation

​Policy: Shared vs Platform-Specific

​Shared (All Platforms Must Have)

​Intentionally Platform-Specific

​Known Gaps to Address

​Maintenance

Platform Overview

Capability Matrix

Agents / Specialists

Skills / Workflows

Rules / Pattern Files

Commands / Workflows

Hooks & Automation

Policy: Shared vs Platform-Specific

Shared (All Platforms Must Have)

Intentionally Platform-Specific

Known Gaps to Address

Maintenance