| name | migrate-research |
| type | user-invocable, agent-invocable |
| description | Autonomous research loop that improves citum-migrate converter fidelity by iterating on Rust code in crates/citum_migrate/src/. Measures fidelity across a corpus of priority styles, clusters failure patterns, attempts targeted Rust fixes, validates with cargo nextest, keeps improvements, reverts failures. Does NOT modify style YAML. |
| model | sonnet |
Migrate Research
Use This Skill When
- Systematic converter improvement is the goal.
- Multiple styles share the same migration failure pattern.
- You want to close the gap between
citum-migrate output and reference fidelity.
- A style-fidelity follow-up needs bounded rich-input evidence to determine whether the next pass belongs in migration, style, processor, or adjudication.
Do Not Use When
- Fixing a single style's YAML.
- The failure is an engine rendering bug, not a converter bug.
- The failure requires new schema fields.
- The only new signal is a full supplemental corpus rerun with no bounded cluster, hypothesis, or classification.
Entry Points
/migrate-research
/migrate-research --top 20
/migrate-research --styles "apa,nature"
/migrate-research --resume
Setup (read first)
Before doing anything else, read:
docs/policies/STYLE_WORKFLOW_DECISION_RULES.md — failure classification and stop conditions
docs/guides/STYLE_WORKFLOW_EXECUTION.md — evidence ladder, cluster reduction, session loop
Autonomous Operation
Run the full research loop without pausing for approval. Only interrupt for Cargo.toml/Cargo.lock changes or git push origin main.
Workflow
- Use the shared execution guide for the evidence ladder, cluster reduction, and stop conditions.
- Keep the file focused on the converter-specific loop and migration session state.
Session State
Keep the existing lab/ scratch structure under .claude/skills/migrate-research/.
Output Contract
Report the chosen cluster, classification, before/after evidence, exact change made if any, and the final verdict on whether the pass should continue, stop, or escalate.