Migration Sweep

TODO(migration)

Triggers

• User executes

  /migration-sweep

• Mentions of "migration code", "migration TODO", "expired TODO"

Execution Steps

1. Collect TODO(migration) entries

# Search for TODO(migration) across the entire repo
grep -rn "TODO(migration)" --include="*.ts" --include="*.tsx" --include="*.py" src/ tests/ e2e/ python_backend/ 2>/dev/null || echo "No matches"

2. Metadata parsing

[ISSUE-XXX]

[#XXX]

[expires=YYYY-MM-DD]

3. Judgment Rules

expires

4. Report Output

## Migration Sweep Report (YYYY-MM-DD)

### P0: Immediate Action Required (X entries)

| File:Line | Status | Expiration Date | Issue | Content |
|------------|------|------|-------|------|
| `src/foo.ts:42` | EXPIRED | 2026-01-15 | #123 | Remove old admin check |
| `src/bar.ts:88` | MISSING_META | - | - | TODO(migration) but no metadata |

### P1: Planned Action (X entries)

| File:Line | Expiration Date | Days Remaining | Issue | Content |
|------------|------|--------|-------|------|
| `src/baz.ts:15` | 2026-03-15 | 21 days | #456 | Deprecate legacy API |

### OK (X entries)
(Can be omitted)

### Summary
- Total: X entries
- P0 (Immediate Action Required): X entries
- P1 (Planned Action): X entries
- OK: X entries

5. Additional Action Suggestions

• EXPIRED: Confirm "Is it acceptable to delete this code?" and propose deletion
• MISSING_META: Propose metadata completion using the template format
  typescript

  // TODO(migration)[ISSUE-XXX][expires=YYYY-MM-DD]:
  // <Describe deletion conditions>

• WARNING: Prompt to check the status of the associated Issue

Template (for new migration code)

// TODO(migration)[ISSUE-1234][expires=2026-05-31]:
// Remove after role-based admin check is fully deployed
// and logs show 0 hits for 14 days.

AI Assistant Instructions

1. Collect all TODO(migration) entries with grep: Target directories

   src/

   ,

   tests/

   ,

   e2e/

   ,

   python_backend/

2. Metadata parsing: Extract Issue ID, expiration date, deletion conditions
3. Classify per judgment rules: EXPIRED / MISSING_META / WARNING / OK
4. Output report: Strictly follow the format specified above
5. Propose additional actions: Suggest deletion for EXPIRED entries, provide completion template for MISSING_META entries

• Report all entries (do not filter)
• Explicitly state "P0: 0 entries" even if there are no P0 items
• Deletion suggestions for EXPIRED entries must be conditional on "confirm safety after reviewing the code"

• Do not delete code automatically (only generate reports, modifications require user confirmation)
• Do not include TODO entries other than TODO(migration) (e.g. TODO(fix), TODO(refactor)) in the scope

Related Rules

• .claude/rules/dead-code-cleanup.md

  — Migration code management section

• CLAUDE.md

  — Pre-push done conditions (type-check is the final defense line)