Add comprehensive migration plan for bet-check → tiltcheck-monorepo

[Copilot]

Provides production-ready migration documentation for moving bet-check into the tiltcheck-monorepo without service disruption.

Documentation Delivered (4,378 lines, 120 KB)

⭐ COPILOT_MIGRATION_PROMPT.md - Ready-to-use GitHub Copilot prompt for automated migration execution
MIGRATION_INDEX.md - Central navigation hub with role-based routing
MIGRATION_SUMMARY.md - Executive brief with risk assessment and approval workflows
MIGRATION_PLAN.md - 60-page technical guide with 8-phase process, troubleshooting, and rollback procedures
MIGRATION_QUICK_START.md - 30-minute execution path for experienced teams
MIGRATION_CHECKLIST.md - Task tracker with time estimates
MIGRATION_VISUAL_GUIDE.md - Architecture diagrams and file mappings

Migration Approach

Copy-based with original repo preserved. No database changes (Supabase remains external).

Target structure:

tiltcheck-monorepo/
├── apps/
│   ├── bet-check-backend/     # FastAPI service
│   └── bet-check-frontend/    # Next.js app
├── infrastructure/docker/bet-check/
└── docs/bet-check/

Estimated execution: 3-4 hours manually, or 30-60 minutes with GitHub Copilot
Risk level: Low (fully reversible, <15min rollback)
Breaking changes: None (API contracts and database unchanged)

Key Safeguards

• Original repository untouched until archive
• Docker Compose paths updated for monorepo context
• Environment variables centralized with namespace guidance
• Port conflict resolution documented (frontend 3000→9000)
• Rollback procedures for pre-merge, post-merge, and production scenarios

Entry Points by Role

GitHub Copilot users (Recommended): COPILOT_MIGRATION_PROMPT.md - Copy/paste into Copilot for automated execution
Decision makers: MIGRATION_SUMMARY.md
Implementation: MIGRATION_PLAN.md or MIGRATION_QUICK_START.md
Execution tracking: MIGRATION_CHECKLIST.md
Architecture reference: MIGRATION_VISUAL_GUIDE.md

Using the Copilot Prompt

1. Open tiltcheck-monorepo repository in your IDE
2. Start GitHub Copilot chat
3. Copy the prompt from COPILOT_MIGRATION_PROMPT.md
4. Paste into Copilot and let it guide you through the migration step-by-step

Original prompt

On bet-check, provide plan to migrate this project into the repo tiltcheck-monorepo without breaking anything

---

💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.

[jmenichole]

@copilot provide copilot prompt to migrate this to the tiltcheck-monorepo repo

[jmenichole]

@copilot try again

[Copilot]

@copilot try again

Added comprehensive GitHub Copilot migration prompt in commit b4049eb.

To execute the migration:

1. Open the tiltcheck-monorepo repository in your IDE
2. Start GitHub Copilot chat
3. View the prompt: bet-check/COPILOT_MIGRATION_PROMPT.md
4. Copy the main prompt section and paste into Copilot
5. Copilot will guide you through the complete migration step-by-step

The prompt includes:

• Complete file migration instructions
• Configuration updates (paths, ports, package.json)
• Validation steps for each phase
• Troubleshooting guidance
• Success criteria checklist

Alternative: Use MIGRATION_PLAN.md for detailed manual execution or MIGRATION_QUICK_START.md for a 30-minute fast track.

[jmenichole]

@copilot migrate it for me

[Copilot]

@copilot migrate it for me

I'm currently working in the bet-check repository and don't have access to the tiltcheck-monorepo repository. To execute the migration, you'll need to:

Option 1: Use the Copilot prompt in tiltcheck-monorepo

1. Open the tiltcheck-monorepo repository in your IDE
2. Use GitHub Copilot with the prompt from COPILOT_MIGRATION_PROMPT.md
3. Copilot will execute the migration in that repository

Option 2: I can help if you create a Copilot workspace
If you create a GitHub Copilot workspace that includes both repositories, I can perform the migration. Otherwise, I'd need direct access to tiltcheck-monorepo to make changes there.

The migration documentation I created provides everything needed to execute the migration - it just needs to be run in the target repository.

[Copilot]

Pull request overview

This PR provides comprehensive production-ready migration documentation for moving the bet-check sports prediction application from its standalone repository into the tiltcheck-monorepo. The documentation suite consists of 7 files totaling 4,378 lines and approximately 120 KB, offering multiple entry points tailored to different audiences and use cases.

Key Changes

• GitHub Copilot prompt for automated migration execution (recommended approach)
• Executive summary with risk assessment, timeline estimates (3-4 hours), and approval workflows
• Comprehensive technical guide with 8-phase migration process, troubleshooting, and rollback procedures
• Visual guide containing ASCII diagrams, file mappings, and decision trees
• Task checklist for execution tracking with time estimates

Reviewed changes

Copilot reviewed 8 out of 8 changed files in this pull request and generated no comments.

Show a summary per file

File	Description
bet-check/COPILOT_MIGRATION_PROMPT.md	Ready-to-use prompt for GitHub Copilot to automate the migration with validation steps
bet-check/MIGRATION_INDEX.md	Central navigation hub with role-based routing to appropriate documentation
bet-check/MIGRATION_SUMMARY.md	Executive brief with business justification, risk assessment, and sign-off sections
bet-check/MIGRATION_PLAN.md	60-page technical guide with step-by-step instructions, troubleshooting, and rollback procedures
bet-check/MIGRATION_QUICK_START.md	30-minute fast-track guide for experienced developers with condensed commands
bet-check/MIGRATION_CHECKLIST.md	Print-friendly task tracker with checkboxes and time estimates for each phase
bet-check/MIGRATION_VISUAL_GUIDE.md	Visual reference with ASCII diagrams showing structure mappings and migration flows
README.md	Updated to highlight migration documentation as primary purpose with quick links

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.