AI 코딩을 사용하면 개인 개발 속도는 상당히 올라갑니다.

Claude Code, Cursor, Windsurf, Codex, ChatGPT 등을 사용하면 아이디어에서 동작하는 결과물까지 단번에 진행할 수 있는 경우도 많아졌습니다.

다만, 공개 직전이 되면 다른 불안감이 생겨납니다.

• 이대로 GitHub에 올려도 괜찮은가
• .env나 API 키를 섞어 넣지는 않았는가
• README에 구현하지 않은 기능을 적지는 않았는가
• AI가 만든 문장이 조금 과장되어 있지는 않은가
• BOOTH나 note에서 판매할 때, 주의사항은 충분한가
• 완벽하지는 않지만, 오늘 공개해도 되는 상태인가

이 기사에서는 AI로 개발한 개인 개발 프로덕트를 공개하기 전에 확인해야 할 체크 항목을 정리합니다.

먼저 확인해야 할 5가지 항목

1. 주요 동선이 끝까지 이어지는가

가장 먼저 확인해야 할 것은 세세한 완성도보다 주요 동선(Main Flow)입니다.

• 최초 접속이 가능하다
• 가장 중요한 조작이 완료된다
• 입력, 전송, 저장, 출력 등의 흐름이 끊기지 않는다
• 에러 발생 시 화면이 백지로 변하지 않는다
• 스마트폰 폭에서도 최소한으로 사용할 수 있다

AI로 만든 앱은 겉모습은 그럴싸하게 정돈되어 있어도, 끝부분의 입력이나 예외 처리(Exception Handling)가 약한 경우가 있습니다.

최소한 빈 문자열, 일본어, 장문, 기호를 넣었을 때 망가지지 않는지는 확인해 두는 것이 안심됩니다.

2. README나 상품 설명과 실제 기능이 일치하는가

AI에게 README나 판매 문구를 쓰게 하면 자연스러운 문장이 나옵니다.

하지만 구현하지 않은 기능까지 「할 수 있다」고 써버리는 경우가 있습니다.

• 아직 없는 기능을 설명하고 있지는 않은가
• 허구의 도입 사례를 적고 있지는 않은가
• 「완전히」, 「반드시」, 「자동으로 전부」 등 과도한 단정이 없는가
• 주의사항보다 기대치만 커져 있지는 않은가

공개 후의 트러블은 버그뿐만 아니라 기대치의 차이에서도 발생합니다.

3. 비밀 정보가 섞여 있지 않은가

이것은 정말 중요합니다.

GitHub나 BOOTH에 올리기 전에 최소한 다음을 확인합니다.

• API 키
• 토큰 (Token)
• 비밀번호
• .env
• Cookie나 세션 정보
• 개인 정보
• 실제 사용자의 샘플 데이터
• 관리자 화면 URL이나 내부 URL

AI 개발에서는 디버깅 중에 붙여넣은 정보나 샘플로 넣은 값이 그대로 남아 있는 경우가 있습니다.

공개 전에 git status나 git diff를 보고 예상치 못한 파일이 포함되어 있지 않은지 확인합시다.

4. 할 수 없는 것을 적고 있는가

공개 페이지에서는 할 수 있는 것뿐만 아니라, 할 수 없는 것도 적는 것이 친절합니다.

예를 들어 BOOTH에서 판매한다면 다음과 같은 항목입니다.

• 동작 환경
• 지원 범위
• 개별 커스터마이징 여부
• 환불에 대하여
• 고위험 용도로는 사용할 수 없다는 점
• 알려진 제한 사항

제한 사항을 적으면 잘 안 팔릴 것처럼 보이지만, 실제로는 구매 전의 불안을 줄여줍니다.

5. 「오늘 공개해도 되는가」를 나누어 생각하기

공개 전에 모든 것을 완벽하게 하려고 하면 언제까지나 내보낼 수 없습니다.

따라서 문제를 세 가지로 나눕니다.

• 공개 전에 반드시 고친다
• 주의사항이 있다면 공개할 수 있다
• 공개 후에 고치면 된다

비밀 정보의 혼입, 주요 기능이 작동하지 않음, 설명과 구현이 크게 다른 것은 공개 전에 고쳐야 합니다.

반면, UI의 세세한 개선이나 추가 기능은 공개 후의 피드백을 보고 나서 해도 괜찮은 경우가 있습니다.

10분 체크리스트

최소한 이것만이라도 확인해 두면 차이가 큽니다.

• 최초 접속 시 주요 화면이 표시된다
• 가장 중요한 조작을 끝까지 실행할 수 있다
• 빈 문자열, 일본어, 장문을 입력해도 망가지지 않는다
• 에러 발생 시 화면이 백지로 변하지 않는다
• README나 상품 설명과 실제 기능이 일치한다
• 구현하지 않은 기능을 적지 않았다
• API 키, 토큰, 비밀번호를 공개하지 않았다
• .env나 비밀 정보 파일을 공개하지 않았다
• 소재나 라이브러리의 이용 조건을 확인했다
• 주의사항, 면책, 지원 범위를 최소한으로 적었다

요약

AI 개발에서는 만드는 속도가 올라간 만큼, 공개 전의 확인을 시스템화해 두면 안심할 수 있습니다.

확인해야 할 것은 완벽한지 여부가 아닙니다.

• 첫 사용자가 목적을 이해할 수 있는가
• 주요 동선이 망가져 있지 않은가
• 비밀 정보나 중대한 오해가 섞여 있지 않은가
• 할 수 없는 것을 할 수 있는 것처럼 보여주고 있지는 않은가
• 공개 후에 고칠 수 있는 문제와 공개 전에 고쳐야 하는 문제를 나누었는가

이 정도를 확인할 수 있다면, 작게 공개하여 피드백을 받을 준비는 충분히 갖춰진 것입니다.

보충

이 기사의 내용을 조금 더 실무용으로 정리한 AI 개발 공개 전 셀프 체크 키트도 만들었습니다.

유료 버전에는 공개 전 30분 체크, Web App / GitHub / BOOTH / Zenn용 심층 체크, AI 리뷰용 프롬프트 모음, 공개 판정 시트를 포함하고 있습니다.

무료 버전도 준비되어 있으니, 우선 10분 체크만 시도해보고 싶은 분은 그쪽을 이용해 주세요.