ORCHESTRATE Marketing Platform이 Sprint 1에서 925개의 테스트로 달성한 기반 위에 5가지 기술 부채 해결 결정으로 Sprint 2 로드맵 수립

Context

Sprint 0-1을 거치며 102개 MCP 도구와 102개 API 엔드포인트를 구축했으나, 복제된 테스트 피처, 일관되지 않은 에러 핸들링 패턴, 데이터베이스 마이그레이션 프레임워크 부재, 블랙박스 스타트업 검증기, 경로 문자열 연결로 인한 Windows 호환성 문제 등 5가지 기술 부채가 축적되었다.

Technical Solution

• 복제된 테스트 피처 통합: 3개 이상 파일에 산재된 V2 테스트 데이터(pages, posts, activity lines, API key patterns)를 단일 pixter로 일원화
• 에러 핸들링 표준화: try-catch 패턴과 Result<T,E> 타입의 경계를 명시적으로 정의하고 린트 규칙으로 강제
• 데이터베이스 마이그레이션 프레임워크 도입: 스키마 버전 추적, forward-only 마이그레이션 체인, 현재 데이터베이스 버전 추적 메커니즘 구현
• 스타트업 검증기 구조화: 로그된 pass/fail 이벤트를 Health.tsx 대시보드에서 소비 가능한 구조화된 이벤트로 변환하고 auto-refresh, 마지막 검사 시간 표시, pause/resume 기능 추가
• 경로 문자열 연결 표준화: 'data/' + filename 방식을 path.join('data', filename)으로 통일하고 린트 규칙으로 신규 위반 방지

Impact

Sprint 1에서 468개 테스트 → 925개 이상의 테스트로 증가 달성, 0개 blocked items 유지

Key Takeaway

AI 에이전트 기반 개발에서 Documentation-Driven Test-Driven Development(DD TDD)와 MCP 서버의 기계적 강제가 정책 위반을 사전 차단하는 수단이 되며, 기술 부채는 구체적 마이그레이션 프레임워크와 린트 규칙으로만 해결 가능하다.