migrate-framework

name	migrate-framework
description	Execute framework or API migrations in Codex through dependency-ordered batches, validating each batch before moving on to keep the codebase continuously working.
compatibility	Codex CLI with terminal access, git, tokenlean CLI (npm i -g tokenlean)

Migrate Framework (Codex)

Migrate in small verified batches.

Workflow

Survey -> Plan batches -> Migrate batch -> Verify batch -> Clean up

1. Survey

tl parallel "structure=tl structure" "deps=tl deps <file>"

Collect official migration steps and breaking changes before editing.

2. Plan batches

tl impact <file>          # Understand blast radius of each module

Batch by risk:

• Leaf modules first
• Shared/public modules last
• Keep each batch reviewable and testable

3. Migrate one batch

tl parallel "symbols=tl symbols <file>" "snippet=tl snippet <function> <file>"

4. Verify each batch

tl parallel "test=tl run 'npm test'" "guard=tl guard"

Do not proceed if current batch fails.

5. Clean up

tl unused                 # Find dead code left behind

Remove temporary shims and dead compatibility code.

Tips

• For large migrations, commit after each passing batch.
• Keep behavior stable unless explicitly changing it.
• Use tl impact to track remaining usage count of old API after each batch.