0. Build Order

Recommended build sequence for rebuilding Sasha Studio from scratch, based on dependency analysis of the current codebase.

Phase Overview

Phase	Name	Depends On	Parallel?	Estimated Effort
1	Foundation & Database	--	No	1 week
2	Authentication & Users	Phase 1	No	3 days
3	Project & File System	Phase 1	Yes (with 2)	1 week
4	Claude CLI Integration	Phase 2, 3	No	1 week
5	Chat Interface & Streaming	Phase 4	No	2 weeks
6	Knowledge Base & Docs	Phase 3	Yes (with 5)	1 week
7	Onboarding Flow	Phase 2, 3	Yes (with 5)	3 days
8	Skills & Workflows	Phase 4	Yes (with 5)	1 week
9	Scheduling & Automation	Phase 8	No	1 week
10	Git Integration	Phase 3	Yes	3 days
11	Cloud Drive Integration	Phase 3	Yes	1 week
12	MCP Integration Framework	Phase 4	Yes	1 week
13	Admin Portal & Analytics	Phase 2	Yes (with 5+)	1 week
14	Meeting & Transcription	Phase 4, 5	No	1 week
15	AI Provider Management	Phase 4	Yes (with 13)	1 week
16	Report Publisher & Exports	Phase 6	Yes	1 week
17	Polish, Theming & Deployment	All	No	1 week

Dependency Graph

Phase 1 (Foundation)
├── Phase 2 (Auth)
│   ├── Phase 7 (Onboarding)
│   └── Phase 13 (Admin)
├── Phase 3 (Files)
│   ├── Phase 6 (Knowledge Base)
│   ├── Phase 10 (Git)
│   └── Phase 11 (Cloud Drives)
└── Phase 4 (Claude CLI) ← requires 2 + 3
    ├── Phase 5 (Chat) ← CRITICAL PATH
    │   └── Phase 14 (Meetings)
    ├── Phase 8 (Skills)
    │   └── Phase 9 (Scheduling)
    ├── Phase 12 (MCP Framework)
    └── Phase 15 (AI Providers)

Critical Path

Phase 1 → 2 → 3 → 4 → 5 is the critical path. Chat with Claude CLI is the core product value. Everything else extends it.

Phase Details

Phase 1: Foundation & Database

• Express server with static file serving
• SQLite database with better-sqlite3
• Schema initialization from init.sql
• Migration system (column additions, table creates)
• Path resolution utilities (SHARED_ROOT, DOCS_ROOT, etc.)
• Environment variable loading
• Health check endpoint
• Rate limiting and security headers (Helmet)

Phase 2: Authentication & Users

• User registration (first user = admin, single-tenant)
• bcrypt password hashing
• JWT token generation (no expiry)
• Authentication middleware (authenticateToken)
• Admin authorization middleware (requireAdmin)
• Localhost bypass for Claude CLI integration
• Password reset flow (Postmark email + token)

Phase 3: Project & File System

• Project directory management
• File upload (multer) with size limits
• File download, move, delete operations
• File type detection and classification
• Document conversion (Word → HTML → Markdown)
• safePath() for path traversal prevention
• File tree caching

Phase 4: Claude CLI Integration

• Claude CLI process spawning via node-pty
• Session management (filesystem-based)
• --append-system-prompt injection pipeline
• Permission mode configuration
• Model selection and provider routing
• Environment variable passthrough to CLI

Phase 5: Chat Interface & Streaming

• WebSocket server for real-time streaming
• React chat interface with message rendering
• Tool call visualization
• Markdown rendering with syntax highlighting
• Mermaid diagram support
• Session history and auto-titling
• Message grouping and normalization
• Terminal/shell component (xterm.js)

Phase 6: Knowledge Base & Documentation

• Markdown file serving and preview
• Doc-builder integration for HTML generation
• PDF/DOCX/Markdown download endpoints
• SPA generation for knowledge base
• Live reload for doc changes

Phase 7: Onboarding Flow

• 3-step employee metaphor onboarding
• Company profile creation
• Organization research (Claude-powered)
• Document upload during onboarding
• Skip/complete flow management

Phase 8: Skills & Workflows

• Skill CRUD (markdown-based, .claude/skills/)
• Skill parser/serializer (frontmatter + body)
• Workflow parser/serializer (multi-step flows)
• React Flow visual editor
• Step types: transform, skill, tool, decision, gate, parallel
• Layer inference (0-3 complexity)
• Skill execution via Claude CLI

Phase 9: Scheduling & Automation

• Cron expression parsing and scheduling
• Scheduled prompt execution
• Execution history logging
• Enable/disable/run-now controls
• Timezone support
• JSONL-based execution logs

Phase 10: Git Integration

• Git status, diff, log, branch operations
• Commit with message generation
• Push/pull/fetch to remote
• Branch creation and checkout
• Conflict detection

Phase 11: Cloud Drive Integration

• OAuth flow for Google Drive, OneDrive, SharePoint
• rclone-based virtual filesystem
• Cloud file browsing, download, upload
• Mount point management
• VFS caching with TTL
• Credential encryption and refresh

Phase 12: MCP Integration Framework

• MCP server registration and configuration
• 21 MCP service adapters
• Claude CLI MCP listing endpoint
• Per-service configure/test/register/deregister
• Config directory management per service

Phase 13: Admin Portal & Analytics

• User CRUD (create, update, delete, welcome email)
• Hook event analytics (usage, sessions, commands, timeseries)
• Stats refresh worker (forked process)
• Execution log viewing
• Output style management
• System configuration

Phase 14: Meeting & Transcription

• Meeting start/stop/status
• Transcript capture and display
• Meeting analysis (Claude-powered)
• Advisor orchestration
• Quick links management

Phase 15: AI Provider Management

• Anthropic direct API configuration
• AWS Bedrock configuration and testing
• Model selection and switching
• Extended context (1M tokens) management
• Provider status and health checks
• Encrypted credential storage

Phase 16: Report Publisher & Exports

• Design pack system (JSON layouts)
• Chart rendering
• PPTX/PDF generation
• Template management

Phase 17: Polish, Theming & Deployment

• Dark/light theme support
• Responsive mobile layout
• Docker multi-stage build
• Sliplane deployment configuration
• AWS ECS Fargate deployment
• GitHub Actions CI/CD
• Security scanning (CodeQL, Semgrep, OSV)