​

Development Guide

​

Prerequisites

• Node.js: Version 18+ with pnpm package manager
• Database: PostgreSQL (local or hosted)
• Redis: For caching and rate limiting
• Google Cloud: Account for AI services and deployment
• Environment: Unix-based system (macOS, Linux, WSL)

​

Quick Start

# Install dependencies
pnpm install

# Environment setup (copy and edit as needed)
# cp .env.example .env.local

# Push database schema
pnpm run db:push

# Start development servers
pnpm run dev

​

Development Commands

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

# Build all packages
pnpm run build

# Type checking
pnpm run type-check

# Run tests
pnpm run test

# Task management
pnpm run tasks:audit      # Analyze task files
pnpm run tasks:cleanup    # Remove completed tasks
pnpm run tasks:status     # Show statistics

​

Development Tools

​

Task Management System

• Automated task lifecycle management with status tracking
• Smart task auditing and cleanup automation
• Format validation for consistent task structure

​

TypeScript Standards

• Inheritance-aware configuration
• Monorepo-specific patterns
• Automated validation for configuration issues

​

File Organization

• Standardized directory structures
• Naming convention enforcement
• Automated cleanup for project integrity