실제 대학교 프로젝트 사양(spec)으로 AI 코딩 에이전트를 테스트했습니다 — 토큰 하나하나까지 어떤 일이 일어났는지 정확히 알려드립니다.

인공지능 (Artificial Intelligence)은 우리가 소프트웨어를 구축하는 방식을 빠르게 변화시키고 있습니다. 프로젝트의 스캐폴딩 (scaffolding)을 하거나 반복적인 보일러플레이트 (boilerplate) 코드를 작성하는 데 수 시간을 소비하는 대신, 이제 AI 코딩 에이전트는 최소한의 입력만으로 애플리케이션을 계획하고, 생성하며, 심지어 개선하는 것까지 가능합니다.

최근에 저는 친구의 졸업 대학교 프로젝트를 도와주면서 Omniroute를 테스트할 기회를 가졌습니다. 그녀는 이미 상세한 프로젝트 사양을 가지고 있었고, 개발을 시작하기 위해 작동하는 PHP 템플릿이 필요했습니다. 저는 이전에 Twig 템플릿 엔진을 사용해 본 적이 없었기에, 이번 기회가 AI 지원 개발 워크플로우 (AI-assisted development workflow)가 어디까지 갈 수 있는지 확인해 볼 완벽한 기회라고 생각했습니다.

이 글은 Omniroute 설정부터 전체 프로젝트 생성 및 결과 평가에 이르기까지 저의 경험을 공유합니다.

🛠️ Omniroute 설정하기

저는 이미 약 $0.20의 크레딧이 남아 있는 오래된 Claude API 키를 가지고 있었기에, 이번 실험에 이를 사용하기로 결정했습니다.

Omniroute를 설치하고 구성하기 위해, 저는 다음 설정 튜토리얼을 따랐습니다:

설치 단계를 따른 후, 저의 디렉토리 구조는 다음과 같았습니다:

⚙️ AI의 코딩 표준 개선하기

제가 특히 마음에 들었던 기능 중 하나는 .agent 설정 파일을 통해 AI의 동작을 커스텀할 수 있는 Omniroute의 능력이었습니다.

저는 Claude가 오래된 프로그래밍 패턴에 의존하는 대신 최신 베스트 프랙티스 (best practices)를 따라 코드를 생성할 수 있도록 현대적인 개발 가이드를 적용하여 구성했습니다.

저는 다음 가이드를 영감의 원천으로 사용했습니다:

🔗 How to Stop Your AI Coding Agent from Writing Outdated Code with Modern Web Guidance

Tip: 이 단계는 선택 사항이지만, 저는 강력히 권장합니다. 에이전트의 지침 (instructions)을 조금만 개선해도 생성된 코드의 품질과 일관성을 크게 향상시킬 수 있습니다.

📋 프로젝트 준비 (Preparing the Project)

제 친구는 기능적 요구사항 (functional specifications)과 비기능적 요구사항 (non-functional specifications)을 모두 포함하여 프로젝트의 모든 요구사항을 이미 작성해 두었습니다.

저는 XAMPP의 htdocs 디렉토리 안에 wedmauritius라는 이름의 새 프로젝트 폴더를 만들고, 그녀의 요구사항을 다음 파일에 복사했습니다:

newProjectRequirement.txt

모든 준비가 끝나자, 저는 Claude에게 요구사항 문서를 읽고 이해할 수 있는지 단순히 물어보았습니다.

Omniroute는 즉시 코드를 생성하는 대신, 프로젝트를 분석하고 구현을 실행하기 전에 개발 계획 (development plan)을 생성하기를 원하는지 물었습니다.

저는 이 점이 특히 인상 깊었는데, 코드를 작성하기 전에 요구사항을 먼저 파악하는 숙련된 소프트웨어 개발자(software developer)와 매우 유사한 방식으로 프로젝트에 접근했기 때문입니다.

🚀 애플리케이션 생성 (Generating the Application)

실행 계획을 확인한 후, Omniroute는 자동으로 프로젝트 구축을 시작했습니다.

개발 과정에는 수동 개입 (manual intervention)이 거의 필요하지 않았습니다. Omniroute는 프로젝트 구조를 생성하고, 파일을 적절하게 구성하며, 명세서 (specification document)를 기반으로 요청된 기능을 구현했습니다.

최종 프로젝트 디렉토리는 다음과 같은 모습이었습니다:

📊 Omniroute 대시보드 (Omniroute Dashboard)

Omniroute가 시작되면 웹 대시보드 (web dashboard)가 자동으로 실행됩니다. 여기에서 다음과 같은 작업을 수행할 수 있습니다:

• 개발 세션 (development sessions) 모니터링
• 할당량 (quotas) 설정
• 사용 통계 (usage statistics) 검토
• 기타 애플리케이션 설정 관리

⚠️ 보안 주의 사항 (Security note): 기본 로그인 비밀번호는 CHANGEME입니다. Omniroute를 처음 설치하는 경우, 정기적으로 사용하기 전에 반드시 이 비밀번호를 변경해야 함을 기억하세요.

✅ 결과 (The Results)

전반적으로, 생성된 애플리케이션의 품질에 기분 좋게 놀랐습니다.

Omniroute는 거친 프로토타입을 만드는 대신, 제 친구가 즉시 개발을 이어갈 수 있는 **견고한 시작점 (solid starting point)**을 생성해 주었습니다. 대학 프로젝트를 시작하거나 내부 프로토타입을 구축하려는 누구에게나, 이는 초기 설정 작업의 많은 시간을 절약해 줄 수 있습니다.

🔢 토큰 사용량 (Token Usage)

이 실험에서 가장 흥미로운 부분 중 하나는 토큰 사용량 (Token Usage)이었습니다.

제 Claude 계정의 잔여 크레딧이 사실상 거의 남아있지 않았음에도 불구하고, Omniroute는 프로젝트를 완료하기 위해 사용 가능한 프리 티어 (free-tier) 엔드포인트를 사용하여 개발을 계속 진행했습니다.

진행 과정에서 추가로 $0.50 상당의 토큰이 소비되었는데, 생성된 결과물에 비해 놀라울 정도로 비용 효율적이었습니다.

🧪 생성된 웹사이트 테스트

프로젝트가 생성된 후, 저는 애플리케이션을 수동으로 테스트했습니다. 전반적으로 모든 것이 놀라울 정도로 잘 작동했습니다.

제가 발견한 유일한 문제는 작은 CSS 문제였습니다 — 스크롤할 때 내비게이션 바 (navigation bar)가 고정 (sticky)되지 않는 현상이었습니다.

이를 수동으로 수정하는 대신, 저는 단순히 다른 Omniroute 세션을 열고 Claude에게 해당 문제를 수정해 달라고 요청했습니다. Claude는 아무런 문제 없이 이를 수행했으며, 이는 AI 보조 개발 (AI-assisted development)의 가장 큰 장점 중 하나인 **빠른 반복 (rapid iteration)**을 보여줍니다.

💭 최종 소감

이번 프로젝트는 Omniroute를 사용한 저의 첫 번째 실제 프로젝트였으며, 진심으로 깊은 인상을 받았습니다.

가장 눈에 띄었던 점은 단순히 코드를 생성하는 능력이 아니라, 바로 **워크플로우 (workflow)**였습니다. Omniroute는 요구 사항을 분석하고, 개발 계획을 제안한 다음, 아주 적은 가이드만으로 그 계획을 실행했습니다. 이는 Omniroute가 단순한 자동 완성 도구라기보다, 애플리케이션의 스캐폴딩 (scaffolding)을 빠르게 수행할 수 있는 주니어 개발자와 협업하는 듯한 느낌을 줍니다.

물론, AI가 생성한 애플리케이션은 여전히 테스트, 코드 리뷰 (code review), 그리고 정교화 (refinement) 과정이 필요합니다. 제가 겪었던 CSS 버그와 같은 사소한 문제들은 예상 가능한 범위 내에 있습니다. 하지만 초기 개발 단계에서 절약된 시간을 고려하면, 이는 충분히 감수할 만한 작은 트레이드오프 (trade-off)입니다.

만약 소규모 PHP 애플리케이션, 대학 프로젝트, 개념 증명 (proof-of-concepts), 또는 내부 도구 (internal tools)를 부트스트랩 (bootstrap) 할 방법을 찾고 있다면, Omniroute를 탐색해 볼 가치가 있습니다.

저는 이것이 조만간 소프트웨어 개발자를 대체할 것이라고 보지는 않습니다. 하지만 개발자의 생산성을 확실히 대폭 향상시켜 줍니다.

Omniroute나 유사한 AI 코딩 에이전트 (AI coding agent)를 사용해 보셨나요? 아래 댓글을 통해 여러분의 경험을 들려주세요.