Skip to main content

Project Structure

Complete directory tree for the Coditect AI IDE project.

Full Directory layout​

/workspace/PROJECTS/t2/
├── .claude/                      # 🤖 CLAUDE CODE CONFIGURATION (READ THIS!)
│   ├── CLAUDE.md                 # Autonomous mode, context engineering, project config
│   ├── README.md                 # Directory structure and quick start
│   ├── settings.local.json       # Auto-approved commands, MCP servers
│   ├── agents/                   # Custom project-specific agents
│   ├── commands/                 # Custom project-specific commands
│   ├── hooks/                    # Pre/post execution hooks
│   ├── agents-reference/         # Git submodule: 84 specialized agents
│   │   ├── agents/               # backend-architect, rust-pro, typescript-pro, etc.
│   │   ├── workflows/            # Multi-agent orchestration (15 workflows)
│   │   └── tools/                # Development utilities
│   └── commands-reference/       # Git submodule: 42 development tools
│       ├── tools/                # security-scan, api-scaffold, db-migrate, etc.
│       ├── workflows/            # Command coordination patterns
│       └── examples/             # Usage examples
│
├── docs/                         # 📚 Documentation (REORGANIZED 2025-10-08)
│   ├── 01-getting-started/       # Quick Start, Deployment, Multi-llm
│   ├── 02-architecture/          # SDD, TDD, Architecture docs
│   ├── 03-infrastructure/        # GCP, FoundationDB, Infrastructure
│   ├── 04-security/              # Security hardening plans
│   ├── 05-api/                   # API testing, summaries
│   ├── 06-backend/               # Backend deployment, integration
│   ├── 07-adr/                   # Architecture Decision Records (ADR-001 to ADR-024)
│   ├── 08-v4-reference/          # V4 reference materials (88 ADRs)
│   ├── 09-sessions/              # Session exports, summaries
│   ├── 10-execution-plans/       # Deployment trackers, execution orders
│   ├── 11-analysis/              # V5 analysis, FDB schema
│   ├── 99-archive/               # Old file-monitor, build logs, status reports
│   ├── DEFINITIVE-V5-architecture.md          # ⭐ COMPLETE V5 DESIGN
│   ├── apple-quality-design-system.md         # ⭐ DESIGN PRINCIPLES
│   ├── v5-frontend-build-verification.md      # ⭐ BUILD STATUS
│   ├── mobile-first-design-system.md          # Touch-friendly patterns
│   ├── theia-ai-research-findings.md          # theia 1.65 capabilities
│   ├── V5-THEIA-WRAPPER-architecture.md       # React-theia bridge
│   └── DOCUMENTATION-index.md                 # Master index
│
├── src/                          # 💻 V5 FRONTEND SOURCE CODE
│   ├── components/               # ⭐ V5 REACT COMPONENTS
│   │   ├── theia/                # theia widget wrappers (NEW)
│   │   │   ├── theia-chat-widget.tsx           # AI chat wrapper
│   │   │   ├── theia-terminal-widget.tsx       # terminal wrapper
│   │   │   ├── theia-monaco-widget.tsx         # editor wrapper
│   │   │   └── theia-file-explorer-widget.tsx   # File tree wrapper
│   │   ├── ai-studio/             # AI Studio Tab components
│   │   │   ├── ai-studio-tab.tsx               # Main tab (Loveable-style)
│   │   │   ├── chat-panel.tsx                 # Chat interface
│   │   │   ├── model-selector.tsx             # Model dropdown
│   │   │   └── preview-panel.tsx              # Code preview
│   │   ├── workspace/            # workspace Tab components
│   │   │   ├── workspace-tab.tsx              # 3-panel layout
│   │   │   ├── file-explorer.tsx              # (legacy)
│   │   │   └── Monacoeditor.tsx              # (legacy)
│   │   ├── header.tsx            # Top navigation
│   │   ├── footer.tsx            # Bottom footer
│   │   ├── layout.tsx            # Tab modality router
│   │   ├── touch-friendly-card.tsx # Mobile-first accordion
│   │   └── theia-embed.tsx        # theia iframe wrapper
│   │
│   ├── pages/                    # ⭐ V5 PAGES (27 PAGES)
│   │   ├── login-page.tsx         # Authentication
│   │   ├── register-page.tsx      # User registration
│   │   ├── profile-page.tsx       # User profile
│   │   ├── settings-page.tsx      # 8-section settings (TouchFriendlyCard)
│   │   ├── documentation-page.tsx # Docs hub + 18 sub-pages
│   │   ├── support-page.tsx       # Support
│   │   ├── faq-page.tsx           # FAQ
│   │   └── status-page.tsx        # System status
│   │
│   ├── services/                 # ⭐ V5 SERVICES
│   │   ├── theia-container.ts    # Inversify DI bridge (NEW)
│   │   ├── session-service.ts    # V5 backend API integration
│   │   ├── user-service.ts       # Profile, password management
│   │   ├── llm-service.ts        # LM Studio API integration
│   │   └── file-service.ts       # File operations
│   │
│   ├── stores/                   # Zustand state stores
│   │   ├── auth-store.ts          # JWT, authentication
│   │   ├── session-store.ts       # Active sessions
│   │   └── ai-studio-store.ts      # AI Studio state
│   │
│   ├── theme/                    # ⭐ APPLE-QUALITY DESIGN SYSTEM
│   │   ├── unified-theme.ts      # Complete design tokens (~500 lines)
│   │   ├── global.css            # Seamless theia integration (~400 lines)
│   │   └── index.ts              # Theme exports
│   │
│   ├── agents/                   # ⭐ V5 CUSTOM AGENTS (NEW)
│   │   └── v5-agents.ts          # 3 custom agents (code gen, UI design, review)
│   │
│   ├── hooks/                    # React hooks
│   │   └── use-theia-theme.ts      # Theme sync hook
│   │
│   ├── types/                    # TypeScript types
│   │   └── ai-studio.ts          # AI Studio types
│   │
│   ├── app.tsx                   # ⭐ MAIN APP (28 ROUTES)
│   ├── main.tsx                  # Entry point
│   └── index.css                 # Global styles
│
├── .theia/                       # ⭐ THEIA CONFIGURATION (NEW)
│   ├── settings.json             # LM Studio + Claude config (16+ models)
│   ├── mcp-servers.json          # 4 MCP servers (lmstudio, filesystem, git, thinking)
│   ├── agents.json               # 3 custom agents
│   └── prompts/                  # Prompt templates
│       ├── code-review.prompttemplate
│       ├── generate-component.prompttemplate
│       └── ui-design.prompttemplate
│
├── backend/                      # ⭐ RUST BACKEND (DEPLOYED TO GCP)
│   ├── src/
│   │   ├── main.rs               # Actix-web server
│   │   ├── handlers/             # Auth, sessions, health
│   │   ├── db/                   # FoundationDB integration
│   │   └── middleware/           # JWT authentication
│   ├── Dockerfile                # Production Docker image
│   └── cloudbuild.yaml           # GCP Cloud Build config
│
├── archive/                      # 📦 ARCHIVED CODE (NOT ACTIVE - REFERENCE ONLY)
│   └── v4-reference/             # V4 reference materials
│       ├── README.md             # ⚠️ V4 is archived - explains when to use
│       ├── backend-services/     # V4 backend microservices (Rust/Python/TypeScript)
│       │   ├── v4-api-v2/        # Main REST API (Rust/Axum)
│       │   ├── v4-websocket-gateway/  # WebSocket gateway
│       │   ├── v4-terminal/      # terminal service (TypeScript)
│       │   ├── v4-terminal-core/ # terminal core (Rust)
│       │   ├── v4-workspace-pod/ # Kubernetes pod manager
│       │   ├── v4-graph-rag/     # Graph RAG service (Python)
│       │   ├── v4-dspy-service/  # DSPy integration (Python)
│       │   ├── v4-ai-prompt-refiner-server-client/  # Prompt refinement (Rust)
│       │   ├── v4-feedback-service/  # User feedback (Rust)
│       │   ├── v4-sdk/           # Client SDK (TypeScript)
│       │   └── v4-coditect-server/  # WebSocket server (Rust)
│       └── frontend/             # V4 React SPA
│           └── frontend-original/  # Original V4 React frontend
│
├── public/                       # Static assets
├── index.html                    # HTML template
├── vite.config.ts                # Vite build config
├── tsconfig.json                 # TypeScript config (MUST stay in root)
├── tsconfig.node.json            # TypeScript node config
├── package.json                  # NPM dependencies (MUST stay in root)
└── README.md                     # Project README

Directory Categories​

Active Development Directories​

Frontend (V5):

  • src/ - All V5 React/TypeScript code with theia integration
  • .theia/ - theia IDE configuration (models, agents, MCP servers)

Backend (V5):

  • backend/ - Rust/Actix-web API deployed to GCP

Configuration:

  • .claude/ - Claude Code configuration (agents, commands, settings)
  • Root config files - package.json, tsconfig.json, vite.config.ts

Documentation:

  • docs/ - All project documentation (organized into 12 categories)

Reference-Only Directories​

Archive:

  • archive/v4-reference/ - V4 reference materials (patterns only, NOT used in production)
  • archive/coditect-v4/ - Git submodule with V4 FDB models and ADRs
  • archive/agents-research-plan-code/ - Git submodule with multi-llm research

⚠️ CRITICAL: V4 materials are REFERENCE ONLY. Do NOT copy v4 patterns directly - t2 uses Eclipse theia architecture which already provides most features.

Important Notes​

JSON Configuration Files​

MUST remain in project root:

  • package.json, package-lock.json - NPM dependencies
  • tsconfig.json, tsconfig.node.json - TypeScript configuration
  • vite.config.ts - Build configuration

These are required by npm/yarn and TypeScript tooling. Don't move or reorganize them.

Git Submodules​

The project includes 4 git submodules:

  1. .claude/agents-reference/ - 84 specialized agents
  2. .claude/commands-reference/ - 42 development tools
  3. archive/coditect-v4/ - V4 reference (19 FDB models, 88 ADRs)
  4. archive/agents-research-plan-code/ - Multi-llm research

Initialize after cloning:

git submodule update --init --recursive

Quick Navigation​

Most Important Files:

Development:

Back to: CLAUDE.md | DOCUMENTATION-index.md