Built a real offline app from scratch with OpenSpec + AI agents. Keeping decisions in specs, not the chat, let me pause, switch models, and stay in control; Including where it fell short. #genai #p...

개요

OpenSpec과 AI 에이전트를 활용하여 실제 오프라인 애플리케이션을 처음부터 구축하는 과정과, 의사결정을 채팅이 아닌 Spec에 기록함으로써 모델 전환 및 제어의 유연성을 확보하는 방법, 그리고 이 과정의 단점을 공유합니다.

주요 내용

• OpenSpec과 AI 에이전트 기반 개발: AI 에이전트를 사용하여 애플리케이션의 기능, UI, 데이터 구조 등을 정의하는 Spec을 생성하고, 이를 기반으로 코드를 개발하는 방식을 적용했습니다.
• Spec 중심의 의사결정: 모든 설계 및 기능 관련 의사결정을 AI와의 대화 기록이 아닌, Version Control System(VCS)에서 관리되는 Spec 파일에 명시적으로 기록했습니다.
• 모델 전환 및 제어의 유연성: Spec에 기반하여 개발을 진행했기 때문에, 필요에 따라 AI 모델을 쉽게 변경하거나 이전 상태로 되돌리는 것이 가능했습니다. 이는 개발 과정에서 더 큰 통제력을 제공합니다.
• 구체적인 개발 단계: Prompt 엔지니어링, Spec 초안 생성, 코드 생성, 반복적인 테스트 및 수정 과정을 거쳤습니다.
• 실제 개발 및 검증: 개발된 애플리케이션은 실제 오프라인 환경에서 기능하는 것을 목표로 했으며, Spec의 정확성과 코드의 구현도를 검증했습니다.
• 구현의 단점 및 한계: Spec에 모든 것을 명시하는 것이 예상보다 더 많은 시간과 노력을 요구했으며, AI 모델의 이해력이나 해석 능력의 한계로 인해 Spec과 실제 생성된 코드 간의 불일치가 발생하기도 했습니다. 특히, 복잡하거나 미묘한 요구사항을 Spec으로 명확히 정의하는 데 어려움이 있었습니다.

시사점

OpenSpec과 AI 에이전트의 결합은 AI 기반 개발에서 통제력을 유지하고 유연성을 확보하는 효과적인 방법을 제시하지만, Spec의 상세함과 AI의 이해도 사이의 균형을 맞추는 것이 중요한 과제로 남습니다.