> ## 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.

# Documentation Versions

> Last Updated: 2026-05-15

**Last Updated:** 2026-05-15

**Recent updates (2026-05-15):** Regulatory readiness expansion pass: `AGENTS.md` updated to v1.26.0, CL/PM module AGENTS ONC constraints refreshed, ONC readiness roadmap/gap/tracker docs expanded, and new ONC/DS4P/EPCS/HITRUST/Contexture skill+spec artifacts added across `.agents/skills`, `.cursor/skills`, and `specs/`.
**Recent updates (2026-05-07):** `src/cores/it/AGENTS.md` implementation status wording refreshed during dead-code remediation audit reconciliation.
**Recent updates (2026-05-13):** Documentation freshness + Docusaurus governance alignment pass: `docs/DOCUMENTATION_STANDARDS.md` advanced to v2.0.1 (explicit source-of-truth policy for root docs vs Docusaurus), and Docusaurus docs references updated for current package/runtime versions.

> **Single Source of Truth:** This file is the authoritative source for all documentation versions.

**Recent updates (2026-04-28):** New `.agents/skills/cloud-runbook/SKILL.md` v1.0.0 — practical Cloud agent startup guide covering env vars, login, per-area test commands, MSW mocking, E2E auth, DB/migration workflow, and self-update protocol. `AGENTS.md` v1.24.3 (Document Map + Cursor Cloud section updated to reference new skill). `.cursor/skills/README.md` updated to list skill.

**Recent updates (2026-04-24):** Supabase promotion verification: `docs/development/supabase/MIGRATION_LANES.md`, `BRANCHING_CI_SPIKE.md`, `SUPABASE_MULTI_ENV_SETUP.md` (v2.2.1 — production CLI examples aligned to `srcaoozjkrughebmbvfb` + branch `production`), `VERCEL_SUPABASE_ENV_ALIGNMENT.md` (section 2.3 promotion order) — all added to version tracking below.

**Recent updates (2026-04-24, declarative schemas):** New `docs/development/supabase/DECLARATIVE_SCHEMA_GUIDE.md` v1.0.0; `SUPABASE_CLI_LOCAL_WORKFLOW.md` v1.3.0 (declarative workflow + `db diff`); `DATABASE_DEVELOPMENT_GUIDE.md` v1.2.0; `AGENTS.md` v1.24.2 / `CLAUDE.md` v1.7.3; `@supabase/pg-delta` + `@supabase/pg-topo` devDependencies; `scripts/database/pgdelta-run.ts`, `validate-schemas.ts`, `supabase-db-diff-from-schemas.ts`; non-blocking `db:schemas:lint` step in `db-migration-guard.yml`.

**Recent updates (2026-04-18, color-system follow-ups):** Token-parity drift fully reconciled — all 10 PF-95 fields show 10/10 ✅ across runtime ↔ PF-95 ↔ edge sources after PR A.1 (`DEFAULT_THEME_COLORS` aligned to runtime: `colorPrimary`, `colorSecondary`, `colorSuccess`, `colorWarning`) + PR A.2 (edge `PLATFORM_DEFAULTS` aligned). New `npm run audit:chart-palette-colorblind` script (Brettel-Viénot-Mollon simulation) surfaces 9 fail / 25 warn chart-palette pairs across 3 dichromacy profiles. `docs/development/SEMANTIC_COLORS.md` v1.4.0 → **v1.4.1** (Chart Palette § Colorblind safety updated with audit results, known problem pairs table, deferred swap action items, and a mandatory color-plus-shape/label rule for category encoding). Two new specs authored: PF-95-EN-02 (expanded tenant color palette) and PF-95-EN-03 (module identity colors in nav).

**Recent updates (2026-04-18, color-system review):** Platform-wide color design system review (see `reports/ux/ux-implementation-plan-20260418.md`). `docs/development/SEMANTIC_COLORS.md` v1.3.1 → **v1.4.0** (new Token Catalog Reference, Module Identity Tokens, expanded Chart Palette, PF-95 Mapping Table, PF-91-EN-01 Compliance Theming Mapping, regression note for the `info.full` dark-mode WCAG fix). `docs/development/UI_UX_STANDARDS.md` v1.6.0 → **v1.6.1** (link-outs to expanded SEMANTIC\_COLORS catalog; new Module Identity Colors and Chart Palette subsections; info-foreground guidance). `docs/development/DESIGN_TOKEN_SYNC_POLICY.md` v1.0.0 → **v1.1.0** (Tri-Source Parity Contract, Deprecated/Reserved Tokens table, Audit Scripts section). `AGENTS.md` v1.24.0 → **v1.24.1** (Quick Reference items 12+13 for charts + tenant-rebrandable surfaces; Top 10 Common Mistakes color-system row). Code: `info.full` semantic class fixed (`bg-info text-info-foreground`); last 3 `bg-black/via-white` escapes replaced with `--overlay-scrim` and new `--shimmer-highlight` token.

**Recent updates (2026-04-18):** Platform-wide UI/UX deep review + tab consistency audit (`reports/ux/`). `docs/development/UI_UX_STANDARDS.md` v1.5.0 → **v1.6.0** (new Tabs section + variant decision table; reconciliation note for Button sizes; SEMANTIC\_COLORS link drift fixed). `docs/development/SEMANTIC_COLORS.md` row corrected to **v1.3.1** (header was v1.3.1 since 2026-04-10; VERSIONS.md was stale at v1.3.0). New canonical implementation plan at `reports/ux/ux-implementation-plan-20260418.md`.

**Recent updates (2026-04-17):** New strategic-review command `recommend-module-specs` (`.cursor/commands/specs/recommend-module-specs.md`) — full single-module review + cross-module comparative scan + external research → prioritized **New Spec Proposals** and **Enhancement Recommendations** tables. The existing **module-strategic-reviewer** agent now implements both `deep-module-review` (single-module) and `recommend-module-specs` (cross-module + research). Module spec-authoring skill gains a "Step 0: Where did this spec idea come from?" section pointing to recommendations reports as the upstream source. `.cursor/README.md` inventory synced to **74** command files; `AGENTS.md` v1.23.2; `SPEC_WORKFLOW.md` and `SPEC_COMMAND_CHEATSHEET.md` updated.
**Recent updates (2026-04-13):** Tenant configurability workflow: new Cursor command `audit-tenant-configurability`, rule `.cursor/rules/tenant-configurability.md`, optional Bugbot check for business literals (`.cursor/BUGBOT.md` v1.1.0); `SPEC_TEMPLATE.md` Settings Considerations cross-ref fixed to constitution §5.2.3; `.cursor/README.md` inventory synced to **73** command files and **36** rule files; `AGENTS.md` v1.23.1 pre-flight; skills index links command to **module-database-design**.
**Recent updates (2026-04-12):** Documentation hierarchy cleanup pass: deleted `plan.md` and `.pr-body-dependabot.md` (stale root files); deleted `LOVABLE_KNOWLEDGE.md` (redirect-only; all \~100 references updated to point directly to `AGENTS.md`); archived 5 deprecated docs (`ENTRA_ID_GAP_ANALYSIS.md`, `HR-20-checkr-background-check-INTEGRATION.md`, `CORE-MODULES-DEFERRED-PHASES-PRIORITIZED.md`, `CORE-MODULES-DEFERRED-PHASES-MASTER-SUMMARY.md`, `STORYBOOK_QUICK_START.md`); moved `docs/testing/uat/lovable-prompts/` to `docs/archive/testing/uat/lovable-prompts/`; archived historical docs in `docs/architecture/analysis/`, `docs/architecture/reviews/`, `docs/architecture/recommendations/`; renamed `.cursor/skills/vercel-react-best-practices/AGENTS.md` to `REFERENCE.md`; added tier annotations to `docs/README.md`; inventoried and archived cursorignored directories. Governance enhancement pass: `AI_GUIDE.md` corrected to **v2.11.0** (was v2.10.0 — version drift fix); ADR index at `docs/architecture/decisions/README.md`; governance entry point at `docs/governance/README.md`; compliance evidence workflow at `docs/compliance/evidence/README.md`; `.claude/settings.json` SessionStart hook path fixed; PR template expanded; `scripts/audit/audit-compliance-evidence.ts` added; `scripts/governance/governance-report.ts` added; HIPAA compliance tests scaffolded at `tests/compliance/hipaa/`; AI platform parity matrix at `docs/development/AI_PLATFORM_PARITY.md`; constitution TOC added; pre-commit governance-doc version-sync check added.
**Recent updates (2026-04-11):** Governance refresh: constitution **v1.16.1** (§4.3 heading hierarchy under Data Security); `docs/development/SPEC_WORKFLOW.md` **v1.0.0** now version-tracked; `docs/VERSIONS.md` compliance table expanded to all primary compliance trackers; Platform Integration table lists **ADR-001** through **ADR-006** (ADR-004 remains **Proposed** — accept/supersede is a product decision); CodeRabbit `.coderabbit.yaml` tools/features refresh; `AGENTS.md` / Copilot MCP baseline clarification; `CLAUDE.md` Claude Code inventory sync; `CODERABBIT_GUIDE.md`, `CODE_REVIEW_PROCESS.md`, `.cursor/BUGBOT.md` doc hygiene; `.github/instructions/*` last-updated markers.
**Recent updates (2026-04-10):** Aggressive documentation consolidation: merged 7 meta-docs into 3 (DOCUMENTATION\_STANDARDS absorbs MAINTENANCE, MODULE\_GUIDE, SPECS\_AND\_DOCS, PUBLISHED\_DOCS, REFERENCE\_MAP); archived 62 Lovable prompt files and 3 obsolete Cursor workflow guides; merged UAT\_QUICK\_REFERENCE + UAT\_TEST\_DATA\_GUIDE into UAT\_GUIDE; deleted 3 redirect stubs; fixed broken Supabase CLI link; added cursor.md to version tracking; moved AI\_DOC\_MANIFEST.yaml from \_inventory/ to docs/.
**Recent updates (2026-04-01):** Docs hub refresh: taxonomy table and `docs/audits/` clarification in `docs/README.md`; `docs/_inventory/INVENTORY.md` and new `REFERENCE_MAP.md`; EHR/PM ingest corpus under `docs/ehr_pm/_artifacts/`; symlinks `docs/ehr_pm/ehr_research*.md` → `docs/archive/ehr_pm/`; archived stale architecture analysis and duplicate navigation checklist; new `docs/development/CI_PIPELINE.md`; `docs/testing/README.md` E2E section aligned with Playwright; Lovable rules point to `.cursor/rules`.
**Recent updates (2026-04-08):** Docs streamline pass: fixed broken testing links, reduced duplicated AI review guidance, refreshed setup command guidance to `npm ci --legacy-peer-deps`, and tightened version/index consistency.

**Recent updates (2026-03-29):** Constitution v1.16.0 adds jurisdiction scope language for multi-state Medicaid compliance (PF-96): §1.1, §4.3.7, §5.1, §5.2.2, §5.2.3, §7.2. Spec workflow commands updated with jurisdiction scope prompts (10 commands).
**Recent updates (2026-04-01):** Design system parity governance docs added. DESIGN\_TOKEN\_SYNC\_POLICY.md v1.0.0 created and linked from standards docs. SEMANTIC\_COLORS updated to v1.3.0 with canonical token-source policy. UI\_UX\_STANDARDS updated to v1.5.0 with design-token governance references.
**Recent updates (2026-04-01):** Typography contract parity update (Phase 2). `src/index.css` and `index.html` now use canonical Inter + Space Grotesk defaults with tenant override fallback (`--tenant-font-family`, `--tenant-font-heading`). `src/platform/theming/types.ts` approved fonts updated to include Space Grotesk constant.
**Recent updates (2026-04-01):** Tailwind v4 migration documentation sync. CLAUDE.md updated to v1.7.0 (Tailwind CSS 4.2.2). UI\_UX\_STANDARDS updated to v1.4.0 for Tailwind CSS v4 CSS-first token mapping. SEMANTIC\_COLORS updated to v1.2.0 for v4 token references.

**Recent updates (2026-03-19):** Constitution v1.15.0 trims §6.6 Authentication State Management code blocks to bullets + playbook links (react-patterns.md, AGENTS.md); adds DATABASE\_DEVELOPMENT\_GUIDE.md to CodeRabbit knowledge base filePatterns. Constitution v1.14.0 consolidated §5.2 SQL playbooks into `docs/development/DATABASE_DEVELOPMENT_GUIDE.md` (new "Constitution playbook: PF DDL templates" section); trimmed §6.5 in favor of AGENTS/quick-reference links; reordered §5.2.9 after §5.2.8. DATABASE\_DEVELOPMENT\_GUIDE v1.1.0.

**Recent updates (2026-03-06):** Public API documentation governance alignment. Constitution v1.13.0 adds §3.4 Public API Documentation Coverage and 100% baseline requirement for in-scope exported function-like declarations. AGENTS.md v1.21.0 adds pre-flight + rules summary requirements for `docs:comments:audit:changed`. Coverage standard updated to v1.1.0 with 100% policy.

**Recent updates (2026-03-05):** AGENTS.md v1.20.0: expanded Cursor Cloud-specific instructions with GUI testing guidance (computerUse subagent), structured environment/validation/testing/onboarding sub-sections, and references to new `pre-commit-check` and `project-setup` skills.

**Recent updates (2026-02-25):** CL-PM architecture formalization. Constitution v1.12.0: encounter entity (§1.2), cross-core FK exception and ADR requirement (§1.3), §5.2.7 Cross-Core Database References. ADR template and ADR-002 (CL-PM cross-core FKs). Platform: `@/platform/types` (clinical-billing), `@/platform/clinical` and `@/platform/scheduling` contracts. AGENTS.md v1.19.0, CLAUDE.md v1.3.0. Integration docs: encounter lifecycle diagram, FK exception reference.

**Recent updates (2026-02-20):** Navigation docs (README, mobile guide, NAVIGATION\_STANDARD, constitution §6.3, NAVIGATION\_GUIDE\_INDEX) updated for Desktop Dock/Sidebar/Taskbar, SidebarNav, NavModeContext, theme in header.

> All documents should reference this file or use versions from here.
> Use the pattern `(current: see docs/VERSIONS.md)` in cross-references instead of hardcoding version numbers.

This file tracks current versions of all documentation files. When updating versions, update this file first, then update all references.

## Core Documentation

| Document                                                      | Version | Last Updated | Status                                                                                                                                           |
| ------------------------------------------------------------- | ------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| constitution.md                                               | v1.17.0 | 2026-04-12   | Current                                                                                                                                          |
| AI\_GUIDE.md                                                  | v2.12.0 | 2026-05-13   | Current                                                                                                                                          |
| ~~LOVABLE\_KNOWLEDGE.md~~                                     | v5.0.0  | 2026-04-12   | Deleted (redirect; all refs updated to AGENTS.md)                                                                                                |
| AGENTS.md                                                     | v1.26.0 | 2026-05-15   | Current (regulatory readiness update with ONC alignment, interoperability, and compliance expansion guidance)                                    |
| CLAUDE.md                                                     | v1.8.0  | 2026-05-06   | Current (command inventory and shared policy references refreshed)                                                                               |
| cursor.md                                                     | v2.0.0  | 2026-03-19   | Current                                                                                                                                          |
| .github/copilot-instructions.md                               | v1.23.1 | 2026-04-13   | Current                                                                                                                                          |
| docs/development/UI\_UX\_STANDARDS.md                         | v1.6.1  | 2026-04-18   | Current (link-outs to expanded SEMANTIC\_COLORS catalog; module + chart subsections)                                                             |
| docs/development/SPACING\_AND\_UX\_STANDARDS.md               | v1.1.0  | 2026-04-08   | Current                                                                                                                                          |
| docs/development/SEMANTIC\_COLORS.md                          | v1.4.1  | 2026-04-18   | Current (chart palette colorblind audit results + known problem pairs + mandatory pairing rule)                                                  |
| docs/development/DESIGN\_TOKEN\_SYNC\_POLICY.md               | v1.1.0  | 2026-04-18   | Current (tri-source parity contract, deprecated/reserved tokens, audit scripts)                                                                  |
| docs/index.md                                                 | v1.1.0  | 2026-04-10   | Current                                                                                                                                          |
| docs/DOCUMENTATION\_STANDARDS.md                              | v2.0.1  | 2026-05-13   | Current (source-of-truth policy clarified; merged: MAINTENANCE, MODULE\_GUIDE, SPECS\_AND\_DOCS, PUBLISHED\_DOCS, REFERENCE\_MAP)                |
| ~~docs/DOCUMENTATION\_MAINTENANCE.md~~                        | v1.3.0  | 2026-04-10   | Deleted (merged into DOCUMENTATION\_STANDARDS.md)                                                                                                |
| docs/AI\_DOC\_MANIFEST.yaml                                   | v1.0.0  | 2026-04-10   | Current (moved from \_inventory/)                                                                                                                |
| docs/development/index.md                                     | v1.1.0  | 2026-04-01   | Current                                                                                                                                          |
| docs/development/SETUP\_QUICK\_START.md                       | v1.0.0  | 2026-04-08   | Current                                                                                                                                          |
| docs/development/DEVELOPMENT\_QUICK\_REFERENCE.md             | v1.0.0  | 2026-04-08   | Current                                                                                                                                          |
| docs/development/CODERABBIT\_CURSOR\_REVIEW\_CONTEXT.md       | v3.0.0  | 2026-04-10   | Current                                                                                                                                          |
| docs/development/CODERABBIT\_GUIDE.md                         | v3.2.0  | 2026-04-11   | Current                                                                                                                                          |
| docs/development/CODE\_REVIEW\_PROCESS.md                     | v1.0.0  | 2026-04-11   | Current                                                                                                                                          |
| .cursor/BUGBOT.md                                             | v1.1.0  | 2026-04-13   | Current                                                                                                                                          |
| docs/development/AGENTS\_MAINTENANCE\_GUIDE.md                | v1.0.1  | 2026-04-10   | Current                                                                                                                                          |
| .agents/skills/cloud-runbook/SKILL.md                         | v1.0.0  | 2026-04-28   | Current (Cloud agent startup guide: env vars, login, per-area test commands, MSW mocking, E2E auth, DB/migration workflow, self-update protocol) |
| .cursor/skills/README.md                                      | —       | 2026-04-28   | Current (skill manifest; updated to list cloud-runbook)                                                                                          |
| ~~docs/development/CURSOR\_AI\_GUIDE.md~~                     | —       | 2026-04-10   | Deleted (was redirect → CODERABBIT\_CURSOR\_REVIEW\_CONTEXT.md)                                                                                  |
| ~~docs/development/AGENTS\_QUICK\_REFERENCE.md~~              | —       | 2026-04-10   | Deleted (was redirect → AGENTS\_MAINTENANCE\_GUIDE.md)                                                                                           |
| docs/development/CI\_PIPELINE.md                              | v1.0.0  | 2026-04-01   | Current                                                                                                                                          |
| docs/development/SPEC\_WORKFLOW\.md                           | v1.0.0  | 2026-04-17   | Current                                                                                                                                          |
| docs/development/SPEC\_COMMAND\_CHEATSHEET.md                 | v1.0.0  | 2026-04-17   | Current                                                                                                                                          |
| docs/development/CURSOR\_CLOUD\_WORKFLOW\.md                  | v1.0.0  | 2026-04-08   | Current                                                                                                                                          |
| docs/development/VERCEL\_BUILD\_IMPROVEMENT\_PLAN.md          | v1.0.0  | 2026-04-01   | Current                                                                                                                                          |
| docs/ehr\_pm/\_artifacts/README.md                            | v1.0.1  | 2026-04-10   | Current                                                                                                                                          |
| docs/testing/index.md                                         | v1.1.0  | 2026-04-01   | Current                                                                                                                                          |
| docs/testing/TESTSPRITE\_SETUP.md                             | v1.0.0  | 2026-04-10   | Current                                                                                                                                          |
| ~~docs/testing/TESTSPRITE.md~~                                | —       | 2026-04-10   | Deleted (was redirect → TESTSPRITE\_SETUP.md)                                                                                                    |
| docs/development/breadcrumb-implementation-guide.md           | v1.3.0  | 2026-04-18   | Current                                                                                                                                          |
| docs/development/mobile-navigation-guide.md                   | v1.4.0  | 2025-12-31   | Current                                                                                                                                          |
| docs/development/settings-pattern-guide.md                    | v1.1.0  | 2025-12-31   | Current                                                                                                                                          |
| docs/development/dashboard-pattern-guide.md                   | v1.0.0  | 2025-12-31   | Current                                                                                                                                          |
| docs/development/mobile-gesture-guide.md                      | v1.0.0  | 2025-12-31   | Current                                                                                                                                          |
| docs/development/PAGE\_MIGRATION\_CHECKLIST.md                | v1.0.0  | 2025-12-31   | Current                                                                                                                                          |
| docs/development/DATABASE\_DEVELOPMENT\_GUIDE.md              | v1.2.0  | 2026-04-24   | Current                                                                                                                                          |
| docs/development/supabase/DECLARATIVE\_SCHEMA\_GUIDE.md       | v1.0.0  | 2026-04-24   | Current                                                                                                                                          |
| docs/development/supabase/SUPABASE\_CLI\_LOCAL\_WORKFLOW\.md  | v1.3.0  | 2026-04-24   | Current                                                                                                                                          |
| docs/development/supabase/MIGRATION\_LANES.md                 | v1.0.1  | 2026-04-24   | Current                                                                                                                                          |
| docs/development/supabase/BRANCHING\_CI\_SPIKE.md             | v1.0.1  | 2026-04-24   | Current                                                                                                                                          |
| docs/development/supabase/SUPABASE\_MULTI\_ENV\_SETUP.md      | v2.2.1  | 2026-04-24   | Current                                                                                                                                          |
| docs/development/VERCEL\_SUPABASE\_ENV\_ALIGNMENT.md          | v1.0.0  | 2026-04-24   | Current                                                                                                                                          |
| docs/development/MCP\_USAGE.md                                | v1.1.0  | 2026-03-05   | Current                                                                                                                                          |
| docs/development/TSDOC\_JSDOC\_COVERAGE\_STANDARD.md          | v1.1.0  | 2026-03-06   | Current                                                                                                                                          |
| docs/architecture/index.md                                    | v1.0.0  | 2025-12-31   | Current                                                                                                                                          |
| docs/architecture/CORE\_DEPENDENCIES.md                       | v1.0.0  | 2025-12-31   | Current                                                                                                                                          |
| docs/architecture/DATA\_FLOW\.md                              | v1.0.0  | 2025-12-31   | Current                                                                                                                                          |
| docs/architecture/ORGANIZATIONAL\_DATA.md                     | v1.0.0  | 2025-12-31   | Current                                                                                                                                          |
| docs/architecture/TERMINOLOGY.md                              | v1.0.0  | 2025-12-31   | Current                                                                                                                                          |
| docs/architecture/CUSTOM\_FIELDS\_GUIDE.md                    | v1.0.0  | 2025-12-31   | Current                                                                                                                                          |
| docs/architecture/analysis/AI\_INTEGRATION\_STRATEGY\_2026.md | v1.2.0  | 2025-12-31   | Current                                                                                                                                          |
| docs/architecture/integrations/index.md                       | v2.1.0  | 2025-12-31   | Current                                                                                                                                          |
| docs/VERSIONING\_RECOMMENDATIONS.md                           | v1.1.0  | 2025-01-22   | Current                                                                                                                                          |
| docs/tools/lovable/LOVABLE\_CUSTOM\_KNOWLEDGE.md              | v2.1.0  | 2026-04-28   | Current (project-context-first restructure; removed workflow-heavy duplication)                                                                  |

## Compliance Documentation

| Document                                                       | Version | Last Updated | Status                    |
| -------------------------------------------------------------- | ------- | ------------ | ------------------------- |
| docs/compliance/REGULATORY\_COMPLIANCE\_TRACKER.md             | v1.0.2  | 2026-03-27   | Current                   |
| docs/compliance/ONC\_CERTIFICATION\_ROADMAP.md                 | v1.0.0  | 2026-02-18   | Current                   |
| docs/compliance/PHI\_CLASSIFICATION.md                         | v1.0.0  | 2026-02-18   | Current                   |
| docs/compliance/AUTHORITATIVE\_REFERENCES.md                   | v1.0.0  | 2026-05-06   | Current                   |
| docs/compliance/HR\_WORKFORCE\_COMPLIANCE\_TRACKING.md         | v1.0.1  | 2026-03-25   | Current                   |
| docs/compliance/FCRA\_TCPA\_COMPLIANCE\_TRACKING.md            | v1.0.0  | 2026-02-10   | Current                   |
| docs/compliance/FA\_FINANCIAL\_COMPLIANCE\_TRACKING.md         | v1.1.0  | 2026-02-27   | Current                   |
| docs/compliance/GR\_GOVERNANCE\_COMPLIANCE\_TRACKING.md        | v1.0.0  | 2026-02-27   | Current                   |
| docs/compliance/RH\_RECOVERY\_HOUSING\_COMPLIANCE\_TRACKING.md | v1.0.0  | 2026-02-27   | Current                   |
| docs/compliance/IT\_SECURITY\_COMPLIANCE\_TRACKING.md          | v1.0.0  | 2026-02-27   | Current                   |
| docs/compliance/CE\_COMMUNICATIONS\_COMPLIANCE\_TRACKING.md    | v1.2.0  | 2026-03-30   | Current                   |
| docs/compliance/index.md                                       | —       | —            | Index (no version header) |
| docs/compliance/DEPENDABOT\_ALERTS\_AUDIT\_2026-03-16.md       | —       | 2026-03-16   | Audit snapshot            |

## Guide Documents

| Document                               | Version | Last Updated | Status  |
| -------------------------------------- | ------- | ------------ | ------- |
| docs/fa/general-ledger-guide.md        | v1.0.0  | 2025-11-26   | Current |
| docs/fa/accounts-payable-guide.md      | v1.0.0  | 2026-01-27   | Current |
| docs/fa/FA-MODULE-SETTINGS.md          | v1.0.0  | 2025-11-26   | Current |
| docs/fa/FA-API-REFERENCE.md            | v1.0.0  | 2025-11-26   | Current |
| docs/fa/FA-D365-MIGRATION-GUIDE.md     | v1.0.0  | 2025-11-26   | Current |
| docs/fa/FA-SECURITY-CONSIDERATIONS.md  | v1.0.0  | 2025-11-26   | Current |
| docs/gr/contract-admin-guide.md        | v1.0.0  | 2025-12-25   | Current |
| docs/gr/contract-user-guide.md         | v1.0.0  | 2025-12-25   | Current |
| docs/pf/report-visualizations-guide.md | v1.0.0  | 2025-11-29   | Current |
| docs/pf/document-approvals-guide.md    | v1.0.0  | 2025-11-29   | Current |
| docs/pf/advanced-documents-guide.md    | v1.0.0  | 2025-11-29   | Current |
| docs/pf/document-management-guide.md   | v3.0.0  | 2025-11-29   | Current |
| docs/pf/notifications-guide.md         | v3.0.0  | 2025-11-29   | Current |
| docs/pf/reporting-guide.md             | v3.0.0  | 2025-11-29   | Current |
| docs/pf/system-health-guide.md         | v1.0.0  | 2025-12-24   | Current |
| docs/pf/index.md                       | v3.0.0  | 2025-12-31   | Current |

## Platform Integration Layers

| Document                                                             | Version | Last Updated | Status                                                                                    |
| -------------------------------------------------------------------- | ------- | ------------ | ----------------------------------------------------------------------------------------- |
| docs/architecture/integrations/PLATFORM\_INTEGRATION\_LAYERS.md      | v2.3.0  | 2026-01-28   | Current                                                                                   |
| src/platform/telephony/README.md                                     | v1.1.0  | 2026-01-27   | Current                                                                                   |
| src/platform/clinical/README.md                                      | —       | 2026-02-25   | Contract (consent implemented; patient context, billing adapter, document export planned) |
| src/platform/scheduling/README.md                                    | —       | 2026-02-25   | Contract (useEncounterContext, useEncounterLifecycle, useAppointmentContext planned)      |
| .coderabbit.yaml                                                     | v2.6.0  | 2026-04-11   | Current                                                                                   |
| .github/instructions/\*.instructions.md                              | —       | 2026-04-11   | Current (path-scoped rules for cores, database, RLS, shared UI)                           |
| docs/architecture/decisions/ADR-001-form-analytics-architecture.md   | —       | 2025-12-05   | Accepted                                                                                  |
| docs/architecture/decisions/ADR-002-cl-pm-cross-core-foreign-keys.md | —       | 2026-02-25   | Accepted                                                                                  |
| docs/architecture/decisions/ADR-003-mcp-pf72-phase4.md               | —       | 2026-03-14   | Accepted                                                                                  |
| docs/architecture/decisions/ADR-004-cl-fw-event-patterns.md          | —       | 2026-03-24   | Proposed                                                                                  |
| docs/architecture/decisions/ADR-005-cross-core-fk-pm-patients.md     | —       | 2026-04-10   | Accepted                                                                                  |
| docs/architecture/decisions/ADR-006-cross-core-fk-hr-employees.md    | —       | 2026-04-10   | Accepted                                                                                  |
| specs/\_templates/ADR\_TEMPLATE.md                                   | —       | 2026-02-25   | Template                                                                                  |

## Specification Documents

| Document                                                     | Version | Last Updated | Status  |
| ------------------------------------------------------------ | ------- | ------------ | ------- |
| specs/fa/NEXT\_PRIORITIES.md                                 | v1.0.0  | 2026-01-27   | Current |
| specs/fa/ux/FA-UX-01-financial-close-setup-wizard.md         | v1.1    | 2026-01-28   | Current |
| specs/fa/ux/FA-UX-02-project-setup-wizard.md                 | v1.0    | 2026-01-28   | Current |
| specs/fa/ux/FA-UX-03-budget-creation-wizard.md               | v1.0    | 2026-01-28   | Current |
| specs/fa/ux/FA-UX-04-bank-reconciliation-wizard.md           | v1.0    | 2026-01-28   | Current |
| specs/fa/ux/FA-UX-05-purchase-order-creation-wizard.md       | v1.1    | 2026-01-28   | Current |
| specs/fa/ux/FA-UX-06-asset-from-po-wizard.md                 | v1.1    | 2026-01-28   | Current |
| specs/fa/ux/FA-UX-07-expense-report-wizard.md                | v1.0    | 2026-01-28   | Current |
| specs/fa/ux/FA-UX-08-idc-rate-calculation-wizard.md          | v1.1    | 2026-01-28   | Current |
| specs/fa/ux/FA-UX-09-consolidation-wizard.md                 | v1.0    | 2026-01-28   | Current |
| docs/architecture/integrations/FA-UX-05-FW-03-INTEGRATION.md | v1.0.0  | 2026-01-28   | Current |

## Integration Guides

| Document                                                  | Version | Last Updated | Status  |
| --------------------------------------------------------- | ------- | ------------ | ------- |
| docs/integrations/N8N\_INTEGRATION\_GUIDE.md              | v1.0.0  | 2025-11-25   | Current |
| docs/integrations/EMAIL\_SMS\_SETUP.md                    | v1.0.0  | 2025-01-07   | Current |
| docs/integrations/EDGE\_FUNCTIONS.md                      | v1.0.0  | 2025-01-07   | Current |
| docs/integrations/INTEGRATIONS\_AND\_SETTINGS\_REVIEW\.md | v1.0.0  | 2025-12-03   | Current |
| docs/integrations/SUPABASE\_SETUP.md                      | v1.0.0  | 2025-01-07   | Current |

## Debugging & Troubleshooting

| Document                                     | Version | Last Updated | Status  |
| -------------------------------------------- | ------- | ------------ | ------- |
| docs/testing/TESTING\_SETUP\_AND\_RUN.md     | v1.4.0  | 2026-04-18   | Current |
| docs/development/CURSOR\_CLOUD\_WORKFLOW\.md | v1.0.0  | 2026-04-08   | Current |
| .agents/skills/cloud-runbook/SKILL.md        | v1.0.0  | 2026-04-08   | Current |

## Related Documentation

* **[Documentation Standards & Maintenance](DOCUMENTATION_STANDARDS.md)** - Standards, maintenance, hierarchy, high-traffic paths

***

## Version Update Process

1. **Update version in source document** - Change version number and "Last Updated" date
2. **Update this file** - Update the version table above
3. **Find all references:**
   ```bash theme={null}
   npm run check-doc-versions
   ```
   This script will scan all markdown files and report any version inconsistencies.
4. **Update all references** in one PR
5. **Update "Last Updated" dates** in affected files
6. **Verify:** Run version consistency check:
   ```bash theme={null}
   npm run check-doc-versions
   ```
   The script will exit with error code 1 if inconsistencies are found, or 0 if all versions are current.

## Version Bump Guidelines

* **MAJOR:** Breaking principle changes or removed principles
* **MINOR:** New principles or materially expanded guidance
* **PATCH:** Clarifications, wording, typos, non-semantic fixes

## Version History

### 2026-01-25 (Phase 5)

* Archived deprecated AI documentation files to `docs/archive/ai-docs/`:
  * DOCUMENTATION\_SYNC\_PROCESS.md (no longer needed)
  * AGENTS\_CURSOR\_VS\_LOVABLE.md (no longer relevant)
  * AGENTS\_BEST\_PRACTICES\_LOVABLE.md (content moved to AGENTS.md)
* Updated references in AI\_GUIDE.md, AGENTS\_QUICK\_REFERENCE.md, DOCUMENTATION\_STANDARDS.md

### 2026-01-25 (Phase 4)

* Added Document Hierarchy diagram to AGENTS.md
* Added "Problem → Solution Quick Lookup" to quick-reference.mdc
* Added Commands quick reference table to .cursor/README.md

### 2026-01-25 (Phase 3)

* AI\_GUIDE.md: Slimmed duplicated sections (\~119 lines removed)
  * Replaced duplicated tables with references to AGENTS.md
  * Kept unique implementation guidance (Edge Functions, Workflow Events, Permissions)
* Final documentation sizes: AI\_GUIDE.md 1412, AGENTS.md 1128, AGENTS.md 81

### 2026-01-25 (Phase 2)

* **AGENTS.md: v4.5.0 → v5.0.0 (CONSOLIDATED)** - Reduced to redirect file (\~80 lines)
* AGENTS.md: v1.10.0 updated with new sections from AGENTS.md:
  * Added User Personas section
  * Added Decision Prioritization Framework section
  * Added Healthcare Compliance Requirements section
  * Added Lovable Cloud Integration section
* AI\_GUIDE.md: Updated references to point to AGENTS.md instead of AGENTS.md
* constitution.md: Updated AGENTS.md references
* Reduced \~900 lines of redundancy across documentation

### 2026-01-25 (Phase 1)

* AGENTS.md: v1.9.0 → v1.10.0 (Added verify-task, generate-test-suite, check-rls-coverage commands, template consolidation)
* AI\_GUIDE.md: v2.7.0 → v2.8.0 (Updated template references, new command references)
* AGENTS.md: v4.4.0 → v4.5.0 (Updated template references, test templates, version sync)
* Comprehensive version consistency fix across all documentation

### 2026-01-16

* AGENTS.md: v1.8.0 → v1.9.0 (Added Quick Reference section, Document Map, Pattern Library)
* AI\_GUIDE.md: v2.6.0 → v2.7.0 (Added AI Decision Framework, enhanced Decision Trees)
* AGENTS.md: v4.3.0 → v4.4.0 (Added Quick Reference section, enhanced Common Mistakes)

### 2026-01-15

* AGENTS.md: v1.5.0 → v1.6.0 (Added integration contract templates)
* AI\_GUIDE.md: v2.5.0 → v2.6.0 (Added integration documentation standards)
* AGENTS.md: v4.2.0 → v4.3.0 (Added contract templates references)
* Added DATA\_DICTIONARY.md, CONTRACT\_VALIDATION\_CHECKLIST.md
* Added EVENT\_CONTRACT\_TEMPLATE.md, API\_CONTRACT\_TEMPLATE.md, DATA\_MODEL\_TEMPLATE.md

### 2025-12-31

* Documentation Quality Implementation Plan completion
* Added standard headers to all development and architecture docs
* Updated all "Last Updated" dates to 2025-12-31
* Added AI agent context sections to key development guides
* Updated cross-references with version numbers
* Archived completed implementation files
* Updated VERSIONS.md with all new documentation versions

### 2025-12-29

* AGENTS.md: v3.9.0 → v4.0.0
* Added §25 Lovable Cloud Integration section
* Clarified that project files are accessible to Lovable
* Updated AGENTS.md cross-references to v4.0.0

### 2025-12-16

* Comprehensive documentation update (Phase D)
* Updated all documentation Last Updated dates
* Verified all version references are current
* Updated RH specs (RH-05, RH-06, RH-07) with full template compliance

### 2025-12-12

* constitution.md: v1.8.0 → v1.9.0
* AI\_GUIDE.md: v2.3.0 → v2.4.0
* AGENTS.md: v3.4.0 → v3.7.0
* AGENTS.md (v1.10.0)
* Updated all 22 spec files with current version references

***

**Note:** This file should be updated whenever any core documentation version changes. All contributors should reference this file to ensure version consistency.