Skip to main content

Complete Submodule-to-Product Mapping Matrix

Date: 2025-11-26 Total Submodules: 46 Deployed Products: 3 Purpose: Map every submodule to deployment reality

Mapping Legend​

Deployment Status:

  • ✅ DEPLOYED - Powers live product
  • 🟢 SUPPORTING - Infrastructure/framework supporting deployed products
  • 🟡 DEVELOPMENT - In-progress features
  • 🔬 RESEARCH - Experimental/POC
  • 📚 DOCUMENTATION - Content repositories
  • ❌ ARCHIVED - Historical reference only

Priority:

  • P0 - Production critical (must not break)
  • P1 - Important (affects features/operations)
  • P2 - Nice to have
  • P3 - Low priority/research

Complete Mapping (46 Submodules)​

#SubmoduleCategoryDeployment StatusDeployed ProductTech StackPriorityNotes
1coditect-cloud-backendcloud✅ DEPLOYEDDjango Multi-Tenant PlatformDjango 5.2, DRF, PostgreSQLP0User registration, licensing, payment
2coditect-cloud-idecloud✅ DEPLOYEDCODITECT IDE (coditect.ai)Theia 1.65, React 18, Rust, FDBP0PRIMARY PRODUCT - Browser IDE
3coditect-cloud-frontendcloud🟡 DEVELOPMENTAdmin DashboardReact, TypeScript, Chakra UIP1Admin interface (not user-facing IDE)
4coditect-cloud-infracloud🟢 SUPPORTINGInfrastructureTerraform, GKE, Cloud SQLP0Provisions GCP resources for all products
5labs-workflowlabs✅ DEPLOYEDWorkflow Analysis (workflow.coditect.ai)FastAPI, React 18, Anthropic ClaudeP0AI-powered workflow analysis platform
6labs-agent-standardslabs🔬 RESEARCHN/ADocumentationP3Agent development standards research
7labs-agents-researchlabs🔬 RESEARCHN/AResearchP3Multi-agent architecture research
8labs-claude-researchlabs🔬 RESEARCHN/AResearchP3Claude API research and experiments
9labs-cli-web-archlabs🔬 RESEARCHN/AResearchP3CLI + web architecture patterns
10labs-first-principleslabs🔬 RESEARCHN/ADocumentationP3First-principles design thinking
11labs-learninglabs🔬 RESEARCHN/AEducational contentP3Learning and training materials
12labs-mcp-authlabs🔬 RESEARCHN/APrototypeP2Model Context Protocol auth research
13labs-multi-agent-raglabs🔬 RESEARCHN/APrototypeP2Multi-agent RAG system exploration
14labs-screenshotlabs🔬 RESEARCHN/AToolP3Screenshot automation tool
15labs-v4-archivelabs❌ ARCHIVEDN/AHistorical referenceP3CODITECT v4 archived code
16nested-learninglabs🔬 RESEARCHN/AEducational frameworkP3Nested learning system research
17next-generationlabs🔬 RESEARCHN/AFuture architectureP2Next-gen platform research
18dev-analyticsdev🟡 DEVELOPMENTN/AAnalytics toolsP2Development analytics tooling
19dev-automationdev🟡 DEVELOPMENTN/AAutomation scriptsP2Development workflow automation
20dev-clidev🟡 DEVELOPMENTN/ACLI toolsP2Command-line development tools
21dev-audio2textdev🟡 DEVELOPMENTN/AUtilityP3Audio transcription utility
22dev-contextdev🟡 DEVELOPMENTN/AContext managementP1Development context preservation
23dev-intelligencedev🟡 DEVELOPMENTN/AAI toolsP2Development intelligence tools
24dev-pdfdev🟡 DEVELOPMENTN/APDF toolsP3PDF generation/processing
25dev-qrcodedev🟡 DEVELOPMENTN/AQR code toolsP3QR code generation
26docs-blogdocs📚 DOCUMENTATIONBlog contentMarkdown, static siteP2Company blog posts
27docs-maindocs📚 DOCUMENTATIONDocumentation siteMarkdownP1Main documentation
28docs-setupdocs📚 DOCUMENTATIONSetup guidesMarkdownP2Installation documentation
29docs-trainingdocs📚 DOCUMENTATIONTraining materialsMarkdownP2User training content
30legaldocs📚 DOCUMENTATIONLegal docsMarkdownP1Terms, privacy policy, etc.
31gtm-commsgtm📚 DOCUMENTATIONMarketing contentContentP2Communications materials
32gtm-crmgtm📚 DOCUMENTATIONCRM dataCRM configP2Customer relationship management
33gtm-customer-cliporagtm📚 DOCUMENTATIONCustomer caseDocumentationP3Clipora customer case study
34gtm-investorgtm📚 DOCUMENTATIONInvestor materialsPresentationsP2Investor presentations and data
35gtm-legitimacygtm📚 DOCUMENTATIONBusiness legitimacyDocumentationP2Company legitimacy materials
36gtm-personasgtm📚 DOCUMENTATIONUser personasMarketing researchP2Target user personas
37gtm-strategygtm📚 DOCUMENTATIONGTM strategyPlanning docsP2Go-to-market strategy
38market-activitymarket📚 DOCUMENTATIONMarket researchAnalysisP3Market activity tracking
39market-agentsmarket📚 DOCUMENTATIONMarket intelligenceResearchP3AI agent market analysis
40ops-complianceops🟡 DEVELOPMENTN/ACompliance toolsP1Regulatory compliance tooling
41ops-distributionops🟡 DEVELOPMENTN/ADistributionP2Software distribution tools
42ops-estimation-engineops🟡 DEVELOPMENTN/AEstimation toolsP2Project estimation engine
43ops-licenseops🟢 SUPPORTINGLicense ServerLicense validationP0CRITICAL - License key validation (must deploy)
44ops-projectsops🟡 DEVELOPMENTN/AProject managementP2Project management tools
45core-architecturecore📚 DOCUMENTATIONArchitecture docsMarkdownP1Architecture reference documentation
46core-frameworkcore🟢 SUPPORTINGCODITECT FrameworkPython, agents, skillsP0Distributed intelligence framework (via .coditect symlinks)

Summary Statistics​

By Deployment Status​

StatusCountPercentageSubmodules
✅ DEPLOYED36.5%cloud-backend, cloud-ide, labs-workflow
🟢 SUPPORTING36.5%cloud-infra, ops-license, core-framework
🟡 DEVELOPMENT919.6%cloud-frontend, dev-, ops- (non-license)
🔬 RESEARCH1226.1%labs-* (except workflow)
📚 DOCUMENTATION1839.1%docs-, gtm-, market-*, core-architecture
❌ ARCHIVED12.2%labs-v4-archive

By Priority​

PriorityCountPercentage
P0613.0%
P1613.0%
P21634.8%
P31839.1%

By Category​

CategoryCountDeployedDevelopmentResearchDocs
cloud42100
labs1310111
dev80800
docs50005
gtm70007
market20002
ops50400
core20001

Critical Production Infrastructure Map​

Product 1: CODITECT IDE (coditect.ai)​

Primary Submodule: cloud-ide

Dependencies:

  • cloud-infra - GKE cluster, NGINX ingress, persistent volumes
  • cloud-backend - JWT authentication (Django multi-tenant)
  • core-framework - AI agents, skills (via .coditect symlink)
  • External: FoundationDB (StatefulSet managed by cloud-infra)
  • External: Rust backend API (contained in cloud-ide)

Deployment Stack:

GKE Ingress (cloud-infra)
└─ coditect-combined-service-hybrid
   ├─ StatefulSet: coditect-combined-hybrid (3 pods)
   │  ├─ React 18 frontend
   │  ├─ Eclipse Theia 1.65
   │  ├─ NGINX proxy
   │  └─ PVCs (workspace + config)
   └─ Deployment: coditect-api-v5 (3 pods)
      ├─ Rust (Actix-web)
      └─ FoundationDB client

Product 2: Workflow Analysis Tool (workflow.coditect.ai)​

Primary Submodule: labs-workflow

Dependencies:

  • cloud-infra - GKE cluster, ingress
  • core-framework - Base patterns (via .coditect symlink)
  • External: PostgreSQL (managed by cloud-infra)
  • External: Redis (managed by cloud-infra)
  • External: Anthropic API (SaaS)

Deployment Stack:

GKE Ingress (cloud-infra)
└─ workflow.coditect.ai
   ├─ Backend Deployment (FastAPI + 8 AI agents)
   ├─ Frontend Deployment (React 18)
   ├─ PostgreSQL (Cloud SQL)
   └─ Redis (GKE deployment)

Product 3: Django Multi-Tenant Platform​

Primary Submodule: cloud-backend

Dependencies:

  • cloud-infra - GKE cluster, Cloud SQL PostgreSQL
  • ops-license - License validation server (MUST DEPLOY)
  • External: FoundationDB (session storage)

Deployment Stack:

GKE Ingress (cloud-infra)
└─ api.coditect.ai (or integrated with workflow.coditect.ai)
   ├─ Django 5.2 + DRF Deployment (3 pods)
   ├─ Cloud SQL PostgreSQL
   └─ FoundationDB (session storage)

Infrastructure Component Matrix​

Shared Infrastructure (cloud-infra manages)​

ComponentUsed ByTechnologyStatus
GKE ClusterAll productsGoogle Kubernetes Engine✅ DEPLOYED
NGINX Ingresscloud-ide, labs-workflowNGINX✅ DEPLOYED
FoundationDBcloud-ide, cloud-backendFDB 7.1+ StatefulSet✅ DEPLOYED
Cloud SQL PostgreSQLcloud-backendPostgreSQL 15+✅ DEPLOYED
PostgreSQLlabs-workflowPostgreSQL🟡 DEPENDS ON DEPLOYMENT
Redislabs-workflowRedis 7+🟡 DEPENDS ON DEPLOYMENT
GCP Secret ManagerAllGCP Secret Manager✅ DEPLOYED

Product-Specific Storage​

ProductStorage TypeSizeConfiguration
cloud-idePVC per pod10 GB workspace + 5 GB configHybrid StatefulSet
cloud-backendCloud SQLVariableManaged PostgreSQL
labs-workflowPostgreSQL + RedisVariableDeployment-specific

Deployment Order Dependencies​

Initial Platform Setup (Phase 1)​

  1. cloud-infra (provision GCP resources)

    • GKE cluster
    • Cloud SQL PostgreSQL
    • FoundationDB StatefulSet
    • NGINX ingress
    • Secret Manager

  2. cloud-backend (authentication/licensing)

    • Django multi-tenant platform
    • User registration
    • License management
    • JWT authentication

  3. ops-license (license validation)

    • License key generation
    • Activation tracking
    • Subscription management

Products (Phase 2)​

  1. cloud-ide (primary product)

    • React + Theia IDE
    • Rust backend API
    • Depends on: cloud-backend (auth), cloud-infra (GKE)

  2. labs-workflow (workflow analysis tool)

    • FastAPI + React
    • 8 AI agents
    • Depends on: cloud-infra (GKE), PostgreSQL, Redis

Admin Tools (Phase 3)​

  1. cloud-frontend (admin dashboard)
    • React admin interface
    • Depends on: cloud-backend (API)

Reorganization Implications​

Current Problem: Deployed Products Hidden​

Issue: Production systems buried in generic categories.

Examples:

  • labs/coditect-labs-workflow - Sounds experimental, but LIVE IN PRODUCTION
  • cloud/coditect-cloud-ide - Doesn't emphasize PRIMARY PRODUCT status
  • cloud/coditect-cloud-backend - README says FastAPI, actually Django

Proposed Structure (Deployment-Focused)​

coditect-rollout-master/
├── products/                        # Customer-facing deployed products
│   ├── coditect-ide/                # coditect.ai (PRIMARY PRODUCT)
│   ├── workflow-analysis/           # workflow.coditect.ai
│   └── [future products]
│
├── platform/                        # Core platform (Phase 1 deployment)
│   ├── multi-tenant/                # Django registration/licensing/payment
│   └── license-server/              # License validation
│
├── infrastructure/                  # Deployment infrastructure
│   ├── gcp-terraform/               # Terraform configs
│   ├── kubernetes/                  # K8s manifests
│   └── monitoring/                  # Observability configs
│
├── framework/                       # Distributed intelligence (coditect-core)
│   ├── agents/                      # 52 AI agents
│   ├── commands/                    # 81 slash commands
│   ├── skills/                      # 26 production skills
│   └── memory-context/              # Session preservation
│
├── services/                        # Backend microservices (future)
│   ├── auth-service/
│   ├── licensing-service/
│   └── [other services]
│
├── development/                     # In-progress features
│   ├── admin-dashboard/             # cloud-frontend
│   ├── analytics/
│   ├── automation/
│   └── [dev tools]
│
├── research/                        # Experimental/POC
│   ├── agent-standards/
│   ├── mcp-auth/
│   ├── multi-agent-rag/
│   └── [research projects]
│
├── content/                         # Documentation & marketing
│   ├── documentation/               # docs-*
│   ├── marketing/                   # gtm-*
│   ├── legal/
│   └── training/
│
└── archive/                         # Historical reference
    └── coditect-v4/                 # labs-v4-archive

Benefits of Reorganization​

  1. Clarity: Deployed products immediately obvious
  2. Safety: Production code clearly separated from dev/research
  3. Onboarding: New developers understand deployment state quickly
  4. Operations: Clear which repos affect production

Risks of Reorganization​

  1. Deployment Breakage: Moving submodules requires updating:

    • .coditect symlinks
    • Deployment scripts
    • CI/CD pipelines
    • Documentation references

  2. Git History: Need to preserve history during moves

  3. Team Disruption: Developers need to update local clones

Next Steps​

  1. ✅ Complete: Submodule mapping matrix (this document)
  2. ⏳ Next: Create practical reorganization plan
  3. ⏳ Next: Design safe migration strategy (no downtime)
  4. ⏳ Next: Update deployment documentation

Status: MAPPING COMPLETE Confidence: HIGH (verified all 46 submodules) Risk Assessment: LOW (documentation only, no changes)

Generated: 2025-11-26 Author: Claude Code (Deployment-Focused Analysis)