ProCode Documentation

Overview

This directory contains all product, engineering, design, AI, infrastructure, business, and process documentation for ProCode IDE.

Structure

docs/
├── product/          — Product requirements, user research, roadmap
├── engineering/      — Architecture, data models, APIs, testing
├── design/           — Design system, UI layout, components, themes
├── ai/               — RAG, agents, knowledge graph, models
├── infra/            — Build system, CI/CD, packaging, native modules
├── business/         — Go-to-market, competition, pricing, risks
├── process/          — Development workflow, code review, releases
├── adr/              — Architecture Decision Records
└── product_specifications/  — Original PRD (reference)

Quick Links

Product

• User Personas
• User Journeys
• Feature Requirements
• Roadmap Phases

Engineering

• System Architecture
• Monorepo Structure
• Data Models
• API Contracts
• Performance Budgets
• Testing Strategy

Design

• Design System
• UI Layout
• Theme System
• Component Library

AI

• RAG Pipeline
• Agent Orchestration
• Knowledge Graph
• Embedding Strategy
• Model Strategy

Infrastructure

• Build System
• CI/CD Pipeline
• Packaging & Distribution
• Native Modules

Business

• Go-to-Market
• Competitive Analysis
• Pricing Strategy
• Risk Analysis

Process

• Development Workflow
• Code Review Guidelines
• Release Process
• Incident Response

Architecture Decision Records

• ADR-001 — Use Electron for cross-platform shell
• ADR-002 — Hybrid TypeScript + Rust architecture
• ADR-003 — Use Monaco Editor as editor engine
• ADR-004 — Use SurrealDB for knowledge graph
• ADR-005 — Use SQLite for workspace state
• ADR-006 — Custom HNSW in Rust for vector search
• ADR-007 — Use Ollama for local AI inference
• ADR-008 — Use NAPI-RS for Rust ↔ Node.js bindings
• ADR-009 — Use Turborepo for monorepo build orchestration
• ADR-010 — Use Zustand for state management
• ADR-011 — Local-first architecture
• ADR-012 — Multi-agent orchestration with state machine
• ADR-013 — VS Code Extension API compatibility
• ADR-014 — Code-aware chunking for RAG
• ADR-015 — Hybrid search (Vector + BM25) with RRF
• ADR-016 — HITL approval for agent file writes
• ADR-017 — Process isolation security model
• ADR-018 — tRPC for type-safe IPC
• ADR-019 — Tree-sitter for AST parsing
• ADR-020 — React 18 + Vite + Tailwind CSS for UI

Reference

• Original PRD — Complete product specification and architecture document