Skip to main content

Repository Migration Manifest - Option B

Date: December 26, 2025 Decision: Simplify rollout-master - approved by user Execution: 4-phase migration

Phase 1: Documentation Audit - ✅ COMPLETE​

Total Files Audited: 552 markdown files

Summary​

  • FRAMEWORK (→ coditect-core): 49 files
  • ROLLOUT (stays here): 59 files
  • PRODUCT (→ product submodules): 66 files
  • UNCLEAR (needs review): 378 files

Phase 2: Migration - ✅ COMPLETE​

2.1 FRAMEWORK Content → coditect-core (49 files) - ✅ COMPLETE​

ADRs (Project Intelligence) → coditect-core/internal/architecture/adrs/project-intelligence/ - ✅​

  • ADR-001-git-as-source-of-truth.md
  • ADR-002-postgresql-as-primary-database.md
  • ADR-003-chromadb-for-semantic-search.md
  • ADR-004-multi-tenant-strategy.md
  • ADR-005-fastapi-over-flask-django.md
  • ADR-006-react-nextjs-frontend.md
  • ADR-007-gcp-cloud-run-deployment.md
  • ADR-008-role-based-access-control.md
  • ADR-COMPLIANCE-REPORT.md
  • README.md

ADRs (Cloud Platform) → coditect-core/internal/architecture/adrs/cloud-platform/ - ✅​

  • ADR-009-multi-tenant-saas-architecture.md
  • ADR-010-cloud-workstations-architecture.md
  • ADR-011-authentication-strategy.md (bonus - discovered during migration)
  • ADR-012-data-isolation-strategy.md (bonus - discovered during migration)
  • ADR-013-event-driven-architecture.md

Architecture Docs → coditect-core/internal/architecture/ - ✅​

  • SDD-CODITECT-MULTI-TENANT-SAAS.md
  • TDD-CODITECT-MULTI-TENANT-SAAS.md
  • CODITECT-WORKFLOW-DIAGRAMS.md
  • 2025-12-04-CODITECT-DISTRIBUTED-INTELLIGENCE-VERIFICATION.md
  • diagrams/ (entire directory - 150+ files)

Workflows → coditect-core/docs/workflows/ - ✅​

  • COMPREHENSIVE-WORKFLOW-INVENTORY.md
  • DIAGRAM-LINKS-FIX-REPORT.md
  • FINAL-VERIFICATION-REPORT.md
  • IMPLEMENTATION-COMPLETE-SUMMARY.md
  • P0-IMPLEMENTATION-PLAN.md
  • P0-WORKFLOWS-SUMMARY.md
  • WORKFLOW-EXPANSION-ANALYSIS.md
  • n8n/ (23 workflow JSON files)
  • narratives/ (23 workflow narrative MD files)

Migration Summary:

  • 254 files migrated to coditect-core submodule
  • Commit: 165803ac in coditect-core
  • All framework content now centralized in portable framework repo

2.2 PRODUCT Content → Product Submodules (66 files)​

Dashboard 2.0 → coditect-dashboard/docs/ (or stay for now if no submodule exists)​

  • dashboard-2.0/ (66 files - entire directory)

Business Plan → coditect-core/docs/business/​

  • business/CODITECT-BUSINESS-PLAN.md

2.3 ROLLOUT Content (STAYS in rollout-master) - 59 files ✅​

  • ✅ docs/project-management/ - All rollout planning
  • ✅ docs/security/ - GCP deployment security
  • ✅ docs/reorganization-plan/ - Submodule organization

2.4 UNCLEAR Content (378 files) - Manual Review Needed​

Recommendation: Review top-level categories first:

  • 99-archive/ - Can likely be deleted or moved to rollout-master archive
  • analysis-reports/ - Rollout-specific analysis, keep in rollout-master
  • deployment/ - Rollout deployment docs, keep in rollout-master
  • DOCUMENT-INDEX.md - Update and keep in rollout-master (points to coditect-core)

Phase 3: Update References - ✅ COMPLETE​

Files Updated​

  • rollout-master/README.md - Added framework migration notice and navigation
  • rollout-master/CLAUDE.md - Added repository scope section
  • rollout-master/docs/MIGRATION-MANIFEST.md - Complete migration tracking
  • rollout-master/docs/DOCUMENT-INDEX.md - Navigation index (created)

Git Commit: 74924fc - docs: Update documentation references for Phase 3 migration

Phase 4: Verification - ✅ COMPLETE​

Checklist​

  • rollout-master/docs/ contains ONLY rollout content
  • coditect-core/internal/architecture/adrs/ contains all framework ADRs (15 files)
  • coditect-core/internal/architecture/ contains SDD/TDD/diagrams (150+ files)
  • coditect-core/docs/workflows/ contains complete workflow library (54 files)
  • All symlinks working (.coditect → submodules/core/coditect-core)
  • All documentation references updated

Verification Report: MIGRATION-VERIFICATION-REPORT.md

Rollback Plan​

If migration fails:

git reset --hard HEAD  # In both repos
git submodule update --init --recursive  # Reset submodule pointers

Status: ✅ ALL PHASES COMPLETE - Migration successful

See MIGRATION-VERIFICATION-REPORT.md for complete verification details.