apps-in-toss-harness는 Toss 미니앱 개발 생태계를 위한 AI 에이전트 전용 오케스트레이션 도구 모음(Monorepo)입니다. 이 저장소는 개발자가 빈 디렉토리 상태에서 미니앱을 설계, 개발, 디버깅, 테스트, 출시 점검에 이르는 전 과정을 에이전트 환경(Claude Code, Codex, Cursor)을 떠나지 않고 완주할 수 있도록 돕는 Scaffold, Skills, 그리고 MCP(Model Context Protocol) 서버를 제공합니다.

핵심 방법론 및 기술 구조

1. 에이전트 오케스트레이션 및 통합(Plugin/Skills):
   • ait 플러그인: 에이전트 내에서 동작하는 오케스트레이터로, 총 11종의 개발 관련 Skill을 제공합니다. 사용자는 $/ait:<verb>$ 슬래시 명령 혹은 자연어 발화를 통해 각 단계의 워크플로우를 실행합니다.
   • 다중 에이전트 지원: Claude Code, Codex, Cursor 등 각기 다른 에이전트의 플러그인 manifest와 인터페이스 차이를 추상화하여 일관된 개발 경험을 제공합니다.

2. MCP(Model Context Protocol) 서버:
   • apps-in-toss-docs: Toss 미니앱 개발 문서를 에이전트가 실시간으로 조회하고 질의할 수 있게 하는 인증 불필요 MCP 서버입니다.
   • ait-console: OAuth 2.0 (RFC 9728) 기반의 콘솔 연동 MCP 서버입니다. 미니앱 생성, 번들 업로드(bundle_upload), 심사 제출, 상태 조회(miniapp_get_status) 등 운영 단계의 필수적인 도구들을 에이전트에게 노출합니다.

3. 개발 및 디버깅 파이프라인:
   • Scaffolding: create-ait-app을 기반으로 디자인 가이드, 토큰 시스템, Tossface 서체, mock SDK가 포함된 표준 프로젝트 구조를 생성합니다.
   • On-device Debugging: 프로젝트 내 .mcp.json에 디버그 MCP를 배선(setup-debugger)하고, 프로덕션 번들에 포함 가능한 debug-console 런타임을 통해 실제 토스 앱 환경에서의 상태를 분석(debug)합니다.
   • 테스트 및 검수: /ait:test-on-device를 통해 로컬 번들을 빌드하여 콘솔에 업로드하고, 실제 토스 앱에서 구동 여부를 확인합니다. /ait:launch는 공식 출시 체크리스트와 코드를 대조하여 반려 사유 분석 및 대응을 수행합니다.

4. 기술적 제약 및 설계:
   • 서버 구현: 서버 측 코드는 사용자의 호스팅 선택을 따르며, 사용자 식별, mTLS, CORS 등 보안 기준을 맞추는 데 초점을 둡니다.
   • 데이터 정합성: ait build 단계에서 brand.icon과 같은 필수 자산을 확인하며, 미니앱 레이아웃 검증을 위해 모바일 뷰포트 환경에서 확인하도록 유도합니다.
   • 플러그인 업데이트: 각 에이전트 환경별로 최적화된 마켓플레이스 갱신 및 재설치 로직을 통해 릴리즈 관리 체계를 유지합니다.

본 harness는 개발자의 개입을 최소화하면서도, 검수 요청 시 사용자의 명시적인 승인 절차를 포함하는 등 안전한 출시 프로세스를 준수하며, 개발 효율성(Developer Experience)과 시스템 안정성을 동시에 고려한 AI 기반 개발 도구입니다.