This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
Sign in to like and favorite skills
This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
Ki's startup command center - a comprehensive development environment for building the world's first Human-AI-Human relationship intelligence platform. This is a lean 3-person startup focused on transforming how couples navigate relationships through AI.
# Development Commands make setup # Complete setup (submodules + Ki platform + automation) make dev # Start complete development environment make ki-setup # Setup Ki platform specifically make stop # Stop all services make n8n # Open n8n automation dashboard (admin/ki2024) make backup # Backup everything make clean # Clean up everything # Git Automation Commands (⭐ Claude Code Compatible) make git-status # Check status of all submodules and main repository make git-push # Push changes in all submodules + main repository make git-pull # Pull latest changes from all repositories
Ki includes comprehensive git automation that handles all submodule repositories automatically. This system is fully compatible with Claude Code and eliminates the need for manual submodule management.
Key Benefits:
This project includes comprehensive MCP (Model Context Protocol) server configuration in
.mcp.json# View all configured MCP servers for this project claude mcp list # Project-scoped MCP servers include: # - puppeteer: Web automation for competitive analysis and testing # - filesystem: Enhanced file operations for data room management # - github: Repository management across ki-platform, ki-business, ki-automation # - postgres: Database operations for user analytics and metrics # - gdrive: Cloud storage integration for investor documents # - slack: Team communication automation # - calendar: Meeting scheduling and milestone tracking # - analytics: Business intelligence and user behavior analysis
MCP servers are automatically available when working in this project directory and provide:
make dev# Navigate to Ki platform (Next Forge monorepo) cd submodules/product/ki-platform # Core development commands pnpm dev # Start all Next.js apps in development mode pnpm build # Build all applications for production pnpm test # Run Vitest tests across all packages pnpm lint # Ultracite linting (Biome-based, faster than ESLint) pnpm format # Format code with Ultracite pnpm typecheck # TypeScript checking across monorepo pnpm analyze # Bundle analysis for optimization pnpm translate # Internationalization workflow pnpm boundaries # Enforce package boundary rules # Database operations pnpm migrate # Prisma format + generate + push to database # Package management pnpm install # Install dependencies (preferred package manager) pnpm bump-deps # Update all dependencies pnpm bump-ui # Update shadcn/ui components pnpm clean # Clean node_modules across workspace # Backend (LangGraph AI Engine) cd apps/langgraph-backend pytest tests/ python -m pytest tests/ -v
# 1. Start development environment make dev # Starts all services including Next.js apps # 2. Work on specific applications cd submodules/product/ki-platform pnpm dev # Development mode for all apps # Apps run on: # - Web (marketing): http://localhost:3000 # - App (platform): http://localhost:3001 # - Docs: http://localhost:3002 # - Storybook: http://localhost:6006 # 3. Add new features following Next Forge patterns # - Use workspace packages (@repo/*) for shared logic # - Follow environment variable patterns with keys.ts # - Implement UI with design-system components # - Add comprehensive tests with Vitest # 4. Quality assurance pnpm lint # Fast linting with Ultracite pnpm typecheck # Ensure type safety pnpm test # Run test suite pnpm analyze # Check bundle sizes # 5. Database changes pnpm migrate # Handle schema updates safely
Ki's breakthrough architecture processes both partners simultaneously while maintaining privacy:
Partner A → Private Channel → Ki AI Core ← Private Channel ← Partner B ↓ Empathy AI Layer ↓ Personalized Dual Responses
Core relationship intelligence workflow in
submodules/product/ki-platform/apps/langgraph-backend/src/graphs/ki_relationship_graph.py# Processing flow intake → safety_check → emotional_analysis → conflict_detection → anxiety_detection → empathy_processing → pattern_recognition → response_generation → memory_update
Key Components:
Core Framework: Built on Next Forge - A production-ready Next.js boilerplate with enterprise-grade tooling
Main Repository: ki-startup-command-center
Submodule Repositories:
# Check status across all repositories make git-status # Push all changes (submodules + main repo) make git-push # Pull latest from all repositories make git-pull
# Clone with all submodules git clone --recurse-submodules https://github.com/sinhadanish/ki-startup-command-center.git # Initialize submodules in existing clone git submodule update --init --recursive # Update all submodules to latest git submodule update --remote # Push changes to main repository git add . && git commit -m "Update description" && git push origin main
# For Claude Code or direct execution ./scripts/git-submodule-status.sh # Check all repository status ./scripts/git-submodule-push.sh # Push all changes ./scripts/git-submodule-pull.sh # Pull all updates
✅ Comprehensive Automation:
✅ Claude Code Integration: Claude Code can execute these commands directly:
cd "/path/to/startup-command-center" && make git-push cd "/path/to/startup-command-center" && ./scripts/git-submodule-push.sh
✅ Eliminates Manual Submodule Management:
make git-push✅ Smart Status Checking:
submodules/ ├── product/ki-platform/ # Main Ki platform (Next.js Turborepo monorepo) │ ├── apps/web/ # Marketing website (Next.js 15) │ ├── apps/app/ # Ki relationship app (Next.js 15) │ ├── apps/docs/ # Documentation site (Next.js 15) │ ├── apps/langgraph-backend/ # LangGraph AI engine (Python + FastAPI) │ ├── packages/ui/ # Shared React component library │ ├── packages/eslint-config/ # Shared ESLint configurations │ └── packages/typescript-config/ # Shared TypeScript configurations ├── business/ # Complete business operations │ ├── data-room/ # Investor documentation for $1.5M pre-seed │ ├── planning/ # MVP roadmap and weekly goals │ ├── operations/ # Team sync, metrics, automation │ ├── growth/ # Customer development, market research │ ├── customer-research/ # User interviews and validation │ └── fundraising-prep/ # Investment materials and prep └── automation/n8n-workflows/ # Business automation workflows
submodules/business/data-room/submodules/business/planning/submodules/business/operations/submodules/business/growth/config/scripts/keys.ts.env.localkeys.ts// Example: packages/auth/keys.ts export const keys = () => createEnv({ server: { CLERK_SECRET_KEY: z.string().min(1), }, client: { NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY: z.string().min(1), }, runtimeEnv: process.env, });
@repo/auth@repo/database@repo/*@repo/design-systempnpm migrate@repo/securitysubmodules/product/ki-platform/apps/langgraph-backend/src/graphs/ki_relationship_graph.pysubmodules/product/ki-platform/apps/langgraph-backend/src/main.pydocker-compose.ymlsubmodules/business/data-room/01-product-intelligence/submodules/business/data-room/01-product-intelligence/human-ai-human-framework.mdsubmodules/business/data-room/01-product-intelligence/ki-conversational-system.mdsubmodules/business/data-room/00-executive-summary/ki-executive-summary.mdsubmodules/business/planning/mvp-roadmap.mdsubmodules/business/operations/Ki uses n8n extensively for business process automation:
Access n8n at http://localhost:5678 (admin/ki2024) after running
make devClaude Code can execute these commands directly in any conversation:
# Check status of all repositories cd "/Users/snapsprint/Documents/Ki Master Folder/startup-command-center" && make git-status # Push all changes across repositories cd "/Users/snapsprint/Documents/Ki Master Folder/startup-command-center" && make git-push # Pull latest updates from all repositories cd "/Users/snapsprint/Documents/Ki Master Folder/startup-command-center" && make git-pull
# 1. Start development work make dev # 2. Make changes across multiple repositories # ... development work ... # 3. Check what's changed across all repos make git-status # 4. Push all changes with one command make git-push # 5. Pull latest team updates make git-pull
The automation provides detailed, colorized output:
Always use the composable environment system:
# When adding new environment variables: # 1. Add to relevant .env.local files # 2. Update corresponding keys.ts file with Zod validation # 3. Import and extend in app's env.ts file
@repo/*packages/// Use design system components import { Button } from '@repo/design-system/button' import { Card } from '@repo/design-system/card' // Follow variant patterns with class-variance-authority const buttonVariants = cva('base-styles', { variants: { variant: { default: '...', destructive: '...' }, size: { default: '...', sm: '...' }, } })
// Use Prisma with type safety import { db } from '@repo/database' import { z } from 'zod' // Define schemas with Zod const userSchema = z.object({ email: z.string().email(), name: z.string().min(1), }) // Type-safe database operations const users = await db.user.findMany({ where: { active: true } })
pnpm analyzeThis command center enables rapid iteration by a small team through extensive automation, sophisticated AI capabilities, comprehensive git management, complete business documentation for fundraising, and enterprise-grade Next Forge architecture patterns.