Coding-Agent Capstone: A Small End-to-End Migration
Migrate a small module end-to-end with the agent.
What You Will Learn
- Plan a small migration.
- Delegate to agent.
- Review thoroughly.
- Merge safely.
- Document lessons.
Why This Matters
This capstone applies PR-15 to PR-19 into a real migration: pick a small module, delegate to agent, review, merge. End-to-end agent workflow.
Concept Explained
Pick a small migration (e.g., convert callbacks to async/await in one module). Plan the issue. Delegate to agent. Review with 15-item checklist. Merge. Document lessons.
How It Works
Identify a small migration. Write detailed issue. Delegate to agent. Review PR. Iterate if needed. Merge. Document time, quality, lessons learned.
Step-by-Step Tutorial
1. Pick migration
Small module (1-5 files). Clear transformation (callbacks → async/await, class → functional, etc.).2. Write issue
Detailed: files, transformation, acceptance criteria, tests required.3. Delegate
Add 'agent-ok' label. Assign to agent.4. Monitor
Check progress every 30 min.5. Review
Apply 15-item checklist (PR-18).6. Iterate
If issues, reject, refine issue, re-delegate.7. Merge
After review passes and CI green.8. Document
Time, credits, quality, lessons.Real-World Example
A team migrated a 3-file module from callbacks to async/await via agent. Issue was detailed. Agent completed in 25 minutes. PR passed 15-item review (caught one missed callback). Merged. Total dev time: 15 minutes (vs 2 hours manually).
Example Prompts / Commands / Code
Title: Convert auth module from callbacks to async/await
Description:
The auth module (src/auth/) uses callback-style async. Convert to async/await for readability and consistency with the rest of the codebase.
Files to modify:
- src/auth/service.ts
- src/auth/middleware.ts
- src/auth/types.ts (only if type changes needed)
Transformation:
- Replace callback-based functions with async/await
- Update callers if signatures change
- Preserve behavior exactly
Acceptance criteria:
- [ ] All functions in service.ts use async/await
- [ ] All functions in middleware.ts use async/await
- [ ] Existing tests pass unchanged (behavior preserved)
- [ ] No new dependencies
- [ ] No changes outside src/auth/
Tests required:
- Existing tests must pass
- No new tests needed (behavior preserved)
Out of scope:
- Other modules
- Type definition changes (unless required)
- Documentation (separate issue)
Labels: agent-ok, refactor
Migration: auth module callbacks → async/await
Date: 2026-08-30
Issue: #142
PR: #143
Agent metrics:
- Time: 25 min
- Credits: 150
- Files changed: 3
- Lines changed: +45 -38
Review:
- 15-item checklist: all pass (after 1 iteration)
- 1 missed callback caught in review
- CI: green
Total dev time: 15 min (review + iterate)
Manual estimate: 2 hours
Time saved: ~1h45m
Lessons:
- Issue was specific enough; agent succeeded first try.
- Review caught one missed callback (good).
- Re-delegation not needed (clean PR).
Next migrations:
- Convert user module (similar size)
- Convert order module (larger, may need to split)
Common Mistakes
- Picking too large a migration — agent flails.
- Vague issue — agent produces wrong transformation.
- Not reviewing thoroughly — subtle behavior changes slip in.
- Not documenting lessons — can't improve future delegations.
Best Practices
- Pick small migrations (1-5 files).
- Write detailed issue with acceptance criteria.
- Review with 15-item checklist.
- Iterate if needed.
- Document time, credits, quality, lessons.
Troubleshooting
| Problem | How to Fix |
|---|---|
| Agent produces wrong transformation | Issue was ambiguous. Reject, refine, re-delegate. |
| Tests fail | Behavior changed. Review diff carefully. May need to adjust tests OR fix agent's bug. |
Practical Exercise
Your Turn
This IS the exercise. Pick a small migration. Delegate to agent. Review. Merge. Document.
Professional Challenge
Run 5 small migrations via agent over a month. Track: time, credits, success rate, common failure modes. Identify patterns for future delegations.
Key Takeaways
- Migration capstone: pick small, delegate, review, merge.
- 1-5 files is sweet spot.
- Detailed issue with acceptance criteria.
- 15-item review.
- Document time, credits, quality, lessons.
Frequently Asked Questions
Should every refactor go through agent?
How to decide size?
Further Reading
Official References
SEO Metadata
SEO title: Coding-Agent Capstone: A Small End-to-End Migration
Meta description: Migrate a small module end-to-end with the agent.
Primary keyword: coding-agent capstone
Secondary keywords: coding-agent capstone: a small end-to-end migration
Search intent: Informational
URL slug: /coding-agent-capstone-small-end-to-end-migration
Categories: AI Tools, GitHub Copilot
Tags: GitHub Copilot, Professional, Capstone, Coding Agent, Migration, IMCSEIAN, Tutorial, IMCSEIAN
Featured image concept: IMCSEIAN lesson card for Coding-Agent Capstone: A Small End-to-End Migration
Comments
Comments
Post a Comment