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.
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 | 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 |
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 |
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 |
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 | ❌ |
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 | ❌ |
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 errorsuseCurrentUser 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)
- 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.
