이 글은 Hacktoberfest Open-Source AI Challenge Week 2: Side Hustle에 제출하는 내용입니다.
제가 만든 것 (What I Built)
모든 프리랜서 개발자는 이 Slack 메시지를 받을 때의 공포를 알고 있습니다:
"안녕하세요! 사이트는 정말 멋지네요. 간단한 질문인데요—금요일에 출시하기 전에 사용자 인증, 고객 관리자 포털, Stripe 결제 기능을 추가할 수 있을까요?"
프리랜서들은 이를 **범위 확장(scope creep)**이라고 부릅니다. 하지만 실제로는 청구되지 않은 시간, 무너진 마감일, 그리고 미지급 초과 근무 시간을 의미합니다. 프리랜서 설문조사에 따르면, 독립 계약자 중 70% 이상이 거절하는 것이 대립적이거나 고객 관계에 위험을 초래한다고 느끼기 때문에 청구되지 않은 클라이언트 업무를 수용합니다.
더 심각한 문제는 다음과 같습니다: 프리랜서는 엄격한 NDA(비밀유지협약) 및 기밀 유지 계약 하에서 일합니다. 클라이언트의 독점적인 작업 명세서(SOW)나 기밀 이메일을 ChatGPT 또는 폐쇄형 클라우드 API에 단순히 업로드하는 것은 고객 신뢰와 계약 조건을 위반할 수 있습니다.
ScopeGuard 소개 🛡️
당신의 시간을 보호하세요. 모든 추가 노력에 대해 대가를 받으세요.
ScopeGuard는 100% 로컬 기반의 개인정보 보호 중심 AI 애플리케이션으로, 객관적인 계약적 방패 역할을 합니다. 이 도구는 수신되는 클라이언트 메시지를 원래 서명된 계약서와 자동으로 분석하고, 정확한 조항 인용과 함께 범위 확장을 플래그 지정하며, 여러 톤으로 경계를 설정하는 답변 초안을 작성하고, 미지급 요청을 클릭 한 번으로 PDF 내보내기가 가능한 청구 가능한 **변경 주문 견적(Change Order Quotations)**으로 변환합니다.
누가 돈을 지불할까요?
- 프리랜서 웹 및 모바일 개발자: '작은 호의'로 인해 연간 평균 $2,000~$8,000를 잃는 사람들.
- 디자인 및 디지털 에이전시: 객관적인 변경 주문 강제가 필요한 여러 동시 클라이언트 계약을 관리하는 곳.
- 독립 컨설턴트 및 계약자: 공손하고 계약에 근거한 거절 의사를 작성해 줄 중립적이고 객관적인 제3자를 원하는 사람들.
만약 ScopeGuard가 단 하나의 추가 변경 주문(750달러)을 포착한다면, 월 15달러의 구독료는 첫날부터 4년 동안 본전을 회수합니다.
ScopeGuard 🛡️
시간을 보호하세요. 추가적인 모든 노력에 대해 보상을 받으세요.
ScopeGuard는 프리랜서, 에이전시 및 독립 계약자를 위해 특별히 설계된 오픈 소스, 개인정보 보호 중심의 AI 애플리케이션으로, **범위 확장(scope creep)**을 감지하고 방지합니다. ScopeGuard는 들어오는 고객 요청을 서명된 프로젝트 계약 및 작업 명세서(Statement-of-Work, SOW) 문서와 자동으로 비교하여 범위를 벗어난 작업을 식별하고, 여러 톤의 경계 설정형 고객 답변을 생성하며, 즉시 PDF 내보내기가 가능한 결정론적 변경 주문 견적서를 작성합니다.
Side Hustle 테마 아래 Hacktoberfest 오픈 소스 AI 챌린지를 위해 개발되었습니다.
💡 문제점과 해결책
- 문제점: 프리랜서는 종종 고정된 범위의 프로젝트에 동의하지만, 고객들은 사소한 추가 사항(예: 인증 기능, 다크 모드, 블로그 CMS, 결제 게이트웨이)으로 위장한
┌────────────────────────────────────────────────────────────────────────┐
│ SCOPEGUARD 아키텍처 │
└────────────────────────────────────────────────────────────────────────┘
...
오픈 AI 구성 요소 (The Open AI Components)
- Ollama를 통한 로컬 LLM 추론: 모든 심층 추론 및 계약서 추출은
llama3:8b, qwen3:8b 또는 gemma2:9b와 같은 오픈 웨이트 모델을 사용하여 Ollama를 통해 로컬에서 실행됩니다. 어떠한 요청도 컴퓨터 외부로 나가지 않습니다.
- ChromaDB를 사용한 로컬 벡터 검색: 계약서(PDF, DOCX 또는 TXT)가 업로드되면, 청크로 분할되어 코사인 유사도 검색을 사용하는 온디바이스 ChromaDB 벡터 데이터베이스에 인덱싱됩니다.
- SentenceTransformers를 사용한 로컬 임베딩: 의미론적 청킹은 PyTorch를 통해
all-MiniLM-L6-v2로 로컬에서 사용되며, 클라우드 의존성 없이 밀리초 단위의 의미론적 검색을 제공합니다.
- 복원력 있는 로컬 NLP 폴백 엔진: 프리랜서가 배터리로 작동하거나 Ollama가 오프라인인 경우, ScopeGuard는 내부 결정론적 정규 표현식(regex) 및 의미론 규칙 엔진으로 자동 전환됩니다. 이 앱은 절대 충돌하지 않으며 100% 기능적으로 오프라인 상태를 유지합니다.
- 결정론적 가격 책정 엔진: 재무 계산(시간당 요율, 항목별 내역, 총액)은 엄격하게 결정론적인 수학 계산이며, 금융 계약서에서 LLM의 환각 현상을 방지합니다.
오픈 혁신이 중요한 이유 (Why Does Open Innovation Matter?)
오픈 혁신은 ScopeGuard를 위한 단순한 구현 세부 사항이 아닙니다. 이것이야말로 이 제품이 존재할 수 있는 전체적인 이유입니다.
- 클라이언트 기밀성 및 NDA 준수: 프리랜서는 클라이언트 계약서, 영업 비밀 또는 미공개 기능 로드맵을 OpenAI나 클라우드 LLM 엔드포인트에 붙여넣을 수 없습니다. 폐쇄형 API는 데이터 유출 위험과 서비스 약관 감시를 초래합니다. 온디바이스에서 실행되는 오픈 웨이트 모델은 100%의 데이터 프라이버시와 NDA 준수를 보장합니다.
- 제로 한계 추론 비용: 부업이나 자체 자본으로 시작하는 솔로 제품의 경우, 폐쇄형 API의 속도 제한과 토큰 수수료가 마진을 심각하게 갉아먹습니다. 오픈 웨이트 모델을 활용함으로써 ScopeGuard는 반복적인 추론 비용이 $0입니다.
- 벤더 종속성 및 임의 플랫폼 퇴출 방지: 폐쇄형 AI 제공업체들은 모델 엔드포인트를 자주 사용 중단하거나, 정렬 규칙(alignment rules)을 변경하거나, 예고 없이 가격을 인상합니다. 오픈 웨이트 모델은 영구적인 재현성과 신뢰성을 제공합니다.
- 표적 의미론적 정밀도: 로컬 벡터 검색과 오픈 임베딩을 결합함으로써, 전체 50페이지짜리 계약서를 거대한 클라우드 컨텍스트 창에 입력하는 비용을 지불하지 않고도 높은 정밀도의 조항 검색을 달성합니다.
나의 에이전트 세션
ScopeGuard는 DevRelay와 Antigravity 에이전틱 워크플로우를 사용하여 Django REST 아키텍처를 구축하고, 로컬 ChromaDB 파이프라인을 만들고, React 19 UI 시스템을 구현하며 페어 프로그래밍되었습니다.
나의 첫 사용자
ScopeGuard를 실제 환경에서 테스트하기 위해, 저는 현지 비즈니스를 위한 맞춤형 Next.js 웹 애플리케이션을 제작하는 프리랜서 프론트엔드 개발자인 친구 Sarah에게 이 도구를 맡겼습니다.
그녀는 클라이언트가 다음과 같은 정확한 메시지를 보낸 프로젝트를 진행하고 있었습니다:
"저희 고객들이 계정을 만들고, 로그인하고, 과거 주문 내역을 볼 수 있는 회원 전용 포털도 설정해 주시겠어요?"
- 결과: ScopeGuard는 해당 요청을 92%의 신뢰도로
범위 외(OUT_OF_SCOPE)로 표시했습니다.
- 인용 조항:
범위에서 제외됨: 사용자 인증, 고객 로그인 시스템 또는 백엔드 데이터베이스.
- 조치: ScopeGuard는 아이디어를 인정하는 전문적(Professional) 답변을 생성했으며, 이 아이디어가 초기 마일스톤 밖에 있음을 설명하고 $1,350 변경 주문 견적서(18시간 @ 시간당 $75)를 생성했습니다.
Sarah가 그 답변을 클라이언트에게 직접 보냈습니다. 두 시간 만에 클라이언트로부터 다음과 같은 답장이 왔습니다: “알겠습니다! 다음 단계로 진행할 수 있도록 변경 주문을 승인하겠습니다.”
그녀의 피드백:
“프리랜서로서 가장 어려운 부분은 고객에게 '아니요'라고 말하면서도 까다롭게 들리지 않게 하는 것입니다. ScopeGuard는 이를 완전히 객관적으로 만들어 주었습니다. 저 자신이 거절하는 것이 아니라, 우리 둘 다 서명한 계약이 그렇게 만든 것이었죠. 저는 이 마음의 평화에 대해 월 $20을 기꺼이 지불할 것입니다.”
상품 부문 (Prize Categories)
- Hacktoberfest 오픈 소스 AI 챌린지: 2주차 — 사이드 허슬 (메인 트랙)
- Gemma 활용 최우수 모델 (오픈 가중치 모델 카테고리): 효율적인 온디바이스 계약 추론을 위해 Ollama에서
gemma2:9b 및 gemma2:2b와 테스트되었으며 완벽하게 호환됩니다.
시간을 보호하세요. 모든 추가 노력에 대해 보상을 받으세요. GitHub의 오픈 소스 레포지토리를 확인하고 프로젝트를 스타(star)해주세요! 🛡️