Skip to main content
Last Updated: 2026-06-19 Recent updates (2026-06-19): CLAUDE.md advanced to v1.10.1 — freshness pass against the live codebase: src/platform/ module count ~101 → ~103, package.json script count ~496 → ~535, and Node runtime note clarified (.nvmrc 24; engines pins >=24 <25); registry row below synced. Recent updates (2026-06-15): Constitution v1.18.0 — §13 Definition of Done trimmed to its non-negotiable security guardrails (RLS + RLS tests, organization_id on mutations, no PHI/PII, SECURITY DEFINER, WITH CHECK) plus a pointer to DEFINITION_OF_DONE.md, now the operational DoD source of truth. The operational checklists (quality/tests/docs/process) moved to the spine so they evolve without a constitutional amendment; resolves the prior triple-definition DoD drift. Canonical mirror re-synced. Recent updates (2026-06-13): docs/DOCUMENTATION_STANDARDS.md advanced to v2.3.0 — Editorial Rules gained the description SEO-summary rule (a human ~150–160-char summary, no document-header metadata cruft; enforced by docs:check-frontmatter) and the single Planned convention (tag: "Planned" frontmatter + the reusable /snippets/planned.mdx badge linking the changelog), replacing ad-hoc “Coming Soon” prose. Recent updates (2026-06-13): CLAUDE.md advanced to v1.10.0 — freshness pass: Platform Version → 0.1.0-beta (matches package.json, was 0.9.0-alpha), package.json script count ~375 → ~496, lint:ci warning ceiling 1600 → 480, and the validate pipeline expanded to include typecheck:evals, typecheck:eos-spec, and test:eos-spec; registry row below synced. Recent updates (2026-06-11): docs/DOCUMENTATION_STANDARDS.md advanced to v2.2.0 — new “Editorial Rules for Published Pages” section: de-numbering rule (no spec IDs in title/sidebarTitle/description/H1 on Product/Guides/Trust-tab pages; traceability via new spec: frontmatter field), duplicate-title pattern (short sidebarTitle, module-qualified title), module nav skeleton. docs/development/MINTLIFY_SETUP.md §3 frontmatter contract gained spec: and noindex: fields plus the “redirects are born permanent” policy. Enforced by docs:check-frontmatter + the new denumber curator sweep. Recent updates (2026-06-04): Constitution v1.17.2 — §6 trim pass (ADR-023 extraction): §6.3.1 Breadcrumb code patterns → breadcrumb-implementation-guide.md; §6.8 wizard help-component table + checklist → WIZARD_UX_STANDARD.md + WIZARD_DEVELOPMENT_GUIDE.md. Guardrails (when-to-show, mobile-CRITICAL, prohibited patterns, REQUIRED wizard/help standards) kept. ~69 lines out. Recent updates (2026-06-04): Constitution v1.17.1 — §5.2 trim pass (ADR-023 extraction, continuing the v1.14/v1.15 pattern): §5.2.3/§5.2.4/§5.2.5/§5.2.6 reduced to guardrail + existing target links (settings-pattern-guide.md, DATABASE_DEVELOPMENT_GUIDE.md, PF-15/16/17 specs); ~125 lines moved out, all guardrails kept. Canonical mirror re-synced. Recent updates (2026-06-11): Product-version governance: package.json.version is now the single source of truth for the platform version (currently 0.1.0-beta); new validate-product-version-sync gate (in validate:governance) enforces parity across README.md and CLAUDE.md, and the running app now surfaces the product version separately from the per-deploy build ID. Corrected stale 0.9.0-alpha references. See docs/development/RELEASING.md. Recent updates (2026-05-31): CLAUDE.md advanced to v1.9.1 — freshness pass correcting the src/platform/ module count (~98 → ~101) and the package.json script count (~480 → ~375); registry row below synced. Recent updates (2026-05-27): docs/development/supabase/2026-05-26-prod-forward-alignment-plan.md extended with a live read-only MCP dev↔prod catalog comparison: a “Convergent prod-only hotfixes (regression risk)” section (verified — only the pf_has_permission admin-bypass reorder is release-blocking, added as Phase A.0 + a hard precondition), a “prod-only objects that are renames (do not recreate)” section (e.g. prod fpl_thresholds ↔ dev pm_fpl_thresholds), repo-tooling reconciliation (db:catalog:remote:*, db:check:promotion-lineage, db:check:prod-collision, validate-migration, db:check:migration-lane), and a read-only verification-queries appendix. Recent updates (2026-05-25): Dual-axis spec status convention propagation: AGENTS.md v1.26.0 → v1.26.1 (spec checklist notes status: + pipeline_status: are orthogonal), .claude/rules/governance.md Status-taxonomy section and specs/_templates/SPEC_FRONTMATTER_REFERENCE.md clarify the two axes, and docs/development/SPEC_STATUS_TAXONOMY.md gained the canonical “Two orthogonal axes” section. Recent updates (2026-05-25): MCP onboarding alignment pass: docs/development/MCP_USAGE.md advanced from v1.1.0 to v1.3.0 (minor version bumped for breaking onboarding changes) with encore-api-surface setup/troubleshooting, .cursor/mcp.json.example now includes encore-api-surface, and related Cursor/cloud guidance updated in SETUP_QUICK_START.md, AGENTS.md, TSDOC_JSDOC_COVERAGE_STANDARD.md, CURSOR_CLOUD_WORKFLOW.md, and .agents/skills/cloud-runbook/SKILL.md. Recent updates (2026-05-25): docs/DOCUMENTATION_STANDARDS.md advanced to v2.1.0 — added Structure Allowlist & Guards section documenting specs/{core}/ sanctioned subfolders, docs/ top-level rules, .scratch/ and docs/_working/ transient analysis homes, and the four structure-guard scripts wired into pre-commit. 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 aximlomrwfuhctxjhrsf + 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

​
Compliance Documentation

​
Guide Documents

​
Platform Integration Layers

​
Specification Documents

​
Integration Guides

​
Debugging & Troubleshooting

​
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:
    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:
    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.