피드로 돌아가기
Dev.toAI/ML
원문 읽기
CLAUDE.md와 Jira MCP 기반 Legacy Modernization 워크플로우 구축
How I Use Claude Code and Jira MCP to Modernize Legacy Codebases
AI 요약
Context
문서 부재 및 암묵적 비즈니스 로직이 산재한 Legacy Java codebase의 유지보수 비용 증가. 정적 분석만으로는 파악 불가능한 도메인 제약 사항과 테스트 코드 부족으로 인한 개발 속도 저하 및 회귀 버그 발생 위험 상존.
Technical Solution
- CLAUDE.md를 통한 Institutional Knowledge의 명문화로 AI Agent의 Context Window 최적화 및 추론 정확도 향상
- Jira MCPS 연동을 통한 Ticket 기반 Acceptance Criteria의 자동 컨텍스트 주입 및 요구사항 분석 자동화
- Playwright 테스트와 Jira 티켓을 매핑하는
/test-ticket커스텀 스킬 설계를 통한 검증 루프 단축 - Read-only Oracle ERP 및 Non-idempotent Service 등 시스템적 제약 사항을 'Known Landmines' 섹션으로 정의하여 AI의 잘못된 코드 생성 방지
- Terminal 기반의 Agentic Workflow를 구축하여 코드 분석, 수정, 테스트, 오류 수정을 단일 루프 내에서 처리하는 구조 설계
실천 포인트
- 프로젝트 루트에 CLAUDE.md를 생성하여 빌드 명령, 아키텍처 구조, 주의사항을 명문화할 것 - AI Agent가 범하기 쉬운 도메인 특유의 제약 사항을 'Landmines' 리스트로 관리하여 Regression 방지 - Jira 등 티켓 시스템과 AI를 MCP로 연결하여 요구사항 정의서와 구현 코드를 실시간으로 동기화 - 자동화 루프의 Token 비용을 고려하여 고비용 작업의 실행 주기와 범위를 정의할 것