​

LostMind AI Monorepo

📌 Source of truth: refer to _archived/projects/lostmindai-turborepo/docs/project/CURRENT_PROJECT_STATE.md for the canonical status. Update it first whenever scope or implementation changes.

​

Tech Stack

• Frontend: Next.js 15 (App Router), React 19 Stable, TypeScript
• Backend: FastAPI (Python) for compute-intensive tasks
• Database: PostgreSQL with Prisma ORM and Row Level Security
• Authentication: Auth.js v5 with Google OAuth
• Payments: Stripe
• AI: Google Generative AI (Gemini)
• Deployment: Vercel (Next.js), Google Cloud Run (FastAPI)
• Monorepo: Turborepo with pnpm workspaces

​

🛠️ Development Tools & Enhancements

​

Task Management System

• Automated task lifecycle management with status tracking (🟢 Active, ✅ Completed, 🔄 Blocked)
• Task cleanup automation prevents accumulation of completed work
• Smart task auditing with pnpm run tasks:audit
• Format validation ensures consistent task file structure

​

TypeScript Configuration Standards

• Inheritance-aware configuration prevents duplicate lib entries
• Monorepo-specific patterns for package organization
• Automated validation catches common configuration issues
• Clear inheritance guidelines for all package configurations

​

File Organization Automation

• Standardized directory structures for apps, packages, and services
• Naming convention enforcement for components, tests, and documentation
• Location validation prevents files in incorrect directories
• Automated cleanup maintains project structure integrity

# Task management commands
pnpm run tasks:audit      # Analyze all task files
pnpm run tasks:cleanup    # Remove completed tasks
pnpm run tasks:status     # Show statistics
pnpm run tasks:validate   # Check format compliance

​

AI Development Memory System

• CLAUDE.md serves as comprehensive project memory file
• Context preservation across development sessions
• Pattern recognition for consistent code organization
• Standards enforcement for TypeScript and file structure

​

Project Structure Overview

​

Implemented foundations

• apps/ask — Orb experience scaffold (UI locked to current production experience, security upgrades in flight)
• apps/marketing — Marketing shell prepared for redesign
• packages/* — Shared libraries (config, ui, db, auth, ai-clients, billing)
• services/ai-compute — FastAPI service with IAM hooks and Redis rate limiting (needs production hardening)
• docker-compose.yml — Local stack for Postgres, Redis, Next.js apps, FastAPI

​

Planned (not yet shipped)

• Additional apps: private-docs, chatcrawler, justdropit, admin
• Additional packages: security, rag, utils
• Additional services: document-processor, crawler-engine, security-monitor

​

📖 Directory Documentation

• apps/ask/README.md - AI query interface documentation
• apps/marketing/README.md - Marketing website documentation
• packages/README.md - Shared packages overview
• services/README.md - Microservices documentation
• infrastructure/README.md - Infrastructure setup

​

Quick Start

# Install dependencies
pnpm install

# Environment
# Keep secrets out of git. See `_archived/projects/lostmindai-turborepo/docs/secrets-policy.md`
# Configure Vercel/GCP Secret Manager for production/staging.
# For local dev, copy and edit if needed (untracked):
# cp .env.example .env.local

# Push database schema
pnpm run db:push

# Start development
pnpm run dev

​

Development

# Run specific app
pnpm run dev --filter=marketing

# Run tests
pnpm run test

# Build all
pnpm run build

# Type checking
pnpm run type-check

​

📚 Documentation

​

Getting Started

• 📖 Documentation Index — _archived/projects/lostmindai-turborepo/docs/README.md
• 🔰 Beginner’s Quick Start — _archived/projects/lostmindai-turborepo/docs/guides/beginner/QUICK_START.md
• 🔐 Environment Setup — _archived/projects/lostmindai-turborepo/docs/setup/ENVIRONMENT_SETUP.md
• 📋 Session Templates — _archived/projects/lostmindai-turborepo/docs/CLAUDE_CODE_SESSION_TEMPLATES.md

​

Architecture & Planning

• 🎯 Master Plan — _archived/projects/lostmindai-turborepo/docs/architecture/lostmind-master-plan.md
• 🗓️ Implementation Roadmap — _archived/projects/lostmindai-turborepo/docs/architecture/implementation-roadmap.md
• 📋 Architecture Decision Records — _archived/projects/lostmindai-turborepo/docs/architecture/lostmind-adrs.md

​

Integration & Operations

• 🤖 Ask App Integration — _archived/projects/lostmindai-turborepo/docs/guides/INTEGRATION_GUIDE_FOR_ASK_APP.md
• 🌐 Marketing Website — _archived/projects/lostmindai-turborepo/docs/guides/MARKETING_WEBSITE_INTEGRATION_GUIDE.md
• 🧠 RAG & Embeddings — _archived/projects/lostmindai-turborepo/docs/guides/RAG_EMBEDDINGS_INTEGRATION_GUIDE.md
• 🕷️ Web Scraper Service — _archived/projects/lostmindai-turborepo/docs/guides/WEB_SCRAPER_SERVICE_INTEGRATION_GUIDE.md
• 📦 Dependency Management — _archived/projects/lostmindai-turborepo/docs/DEPENDENCY_MANAGEMENT.md
• 🔒 Environment Secrets Audit — _archived/projects/lostmindai-turborepo/docs/ENVIRONMENT_SECRETS_AUDIT.md
• 🖥️ Auto Environment Setup — _archived/projects/lostmindai-turborepo/docs/AUTO_ENVIRONMENT_SETUP.md

​

Production Readiness

• 🛡️ Security Architecture Audit Report — _archived/projects/lostmindai-turborepo/docs/security/SECURITY_ARCHITECTURE_AUDIT_REPORT.md
• ⚠️ Production Technical Analysis — _archived/projects/lostmindai-turborepo/docs/PRODUCTION_TECHNICAL_ANALYSIS.md
• 🤖 Google GenAI Developer Guide — _archived/projects/lostmindai-turborepo/docs/GOOGLE_GENAI_DEVELOPER_GUIDE.md
• 🚀 SaaS Launch Pathway — _archived/projects/lostmindai-turborepo/docs/SAAS_LAUNCH_PATHWAY.md
• 📊 TurboRepo Migration Analysis — _archived/projects/lostmindai-turborepo/docs/TURBOREPO_MIGRATION_ANALYSIS.md

​

Project Management

• ✅ Claude Code Tasks — _archived/projects/lostmindai-turborepo/docs/project/CLAUDE_CODE_TASKS.md
• 🗺️ Project Map — _archived/projects/lostmindai-turborepo/docs/project/PROJECT_MAP.md
• 📈 Current Project State — _archived/projects/lostmindai-turborepo/docs/project/CURRENT_PROJECT_STATE.md

• New contributor? Start with the quick start, then environment setup.
• Planning launch? Review the SaaS launch pathway and production analysis.
• Integrating services? Use the guides collection above.
• Need status? Open the current project state snapshot.

​

Current Status (Snapshot)

• ✅ Completed: Professional infrastructure restoration, task management system, TypeScript standards, file organization automation, AI development memory system
• ✅ Operational: Development tools (task-audit, cleanup, standards-check), automated task lifecycle management, comprehensive CLAUDE.md guidelines
• 🔄 In Progress: Frontend integration and user experience development
• 📋 Next Phase: Complete SaaS application with production-ready features
• 📈 Current Focus: Professional development standards and automated tooling

​

License