Axioma Monorepo

Axioma is an MVP between-session intelligence layer. It turns patient reflection into structured summaries that therapists can retrieve before or around sessions.

Purpose

This repository exists to prove one product claim: structured summaries plus grounded retrieval can improve therapist understanding between sessions.

Current Truth

• Axioma is not an EHR, telehealth platform, or therapist replacement.
• Summaries are the core therapist-facing memory unit.
• Retrieval happens before therapist-facing generation.
• AI is a stateless processor, not system memory.
• Current implementation status:
  • apps/web contains early placeholder patient and therapist surfaces.
  • apps/api currently provides Fastify app setup, CORS, Swagger, and a health route.
  • Prisma models a simplified MVP slice with User, Organization, Membership, TherapistPatientAssignment, ReflectionEntry, and AiSummary.
  • packages/shared contains the current shared schemas and types for reflection input, roles, and summaries.

Workspace Layout

• apps/web - Next.js frontend
• apps/api - Fastify backend
• packages/shared - shared contracts and schemas
• docs - repo-facing source of truth
• ai/skills - project-specific agent guidance

Stack

Frontend

• Next.js 15
• React 19
• TypeScript
• Tailwind CSS 4
• lucide-react

Backend

• Node.js
• Fastify 5
• TypeScript
• Zod
• Swagger via Fastify plugins

Data

• PostgreSQL
• Prisma

Tooling

• pnpm workspaces
• Prettier
• ESLint
• Docker Compose
• GitHub Actions CI

Commands

pnpm install
pnpm dev
pnpm build
pnpm lint
pnpm test
pnpm format

Documentation Rules

• If product truth, architecture, models, or workflow boundaries change, update docs in the same change.
• Use the Google Drive Coding folder as the broader product source of truth.
• Reconcile Drive docs against checked-in code before claiming something is implemented.
• Keep summaries and retrieval-first architecture central in docs and code.

Immediate Focus

• Expand the backend from health/docs scaffolding into the MVP request flow.
• Keep schema and API contracts aligned with the summary-centric model.
• Add the first grounded therapist retrieval flow without expanding beyond MVP.