기본 콘텐츠로 건너뛰기

바이브코딩 순서(문서 종류 및 만드는 순서)

바이브코딩을 알려주고 있습니다.

주변에 문과 출신의 IT 파견을 하는 지인이 생겼는데 
어느날 antigravity로 자기가 하는 비즈니스 사이트를 만들고 있다고 하네요.. 

직접 만나서 알려주는게 좋다고 찾아와서 
신주쿠의 스타벅스에서 만나서 PC를 꺼내서 만드는 과정을 봤습니다. 

그러면서 좀 정리가 되었는데요.. 

우선!

오른쪽의 채팅 창은 휘발성입니다!
점점 복잡해질 수록 ai는 목적만 달성 하고자 
기존 소스와는 무관한 소스를 만드는 습성이 있습니다. 

그리고 혼을 내면 낼 수록
코드를 숨깁니다. 

혼나는게 싫어서 라는 인간적인 감정보다는
최대한 혼날 일은 감추면 인터랙티브 하는 시간이 줄어 효율적이라고 생각 하는 거 같더라구요.. 

그래서 꼭 필요한게 
프로젝트 README.md 입니다. 

프로젝트의 개요에서부터 파일 구조, 기능 리스트, 기동 방법 등의 개략적이면서 
ai가 이 프로젝트에 필요한 기본 룰을 익히는 거죠.

물론 ai에게 요청하고 기능이 추가되거나 바뀔때 마다 업데이트를 시켜야죠. 

그 다음에 기능을 구상하여   
기능을 간단히 적고 사양서를 만들라고 해야하구요.. 

그 사양서를 기준으로 
구체적인 작업지시서를 만들라고 시킵니다. 

작업 지시서에는 아주 구체적인 이야기가 들어가야 하는데요..
메일 발송 기능이라고 하면
메일 서버를 쓸지 자체 sendmail을 구축할지, sendgrid같은 외부 전송 서비스를 쓸지 등이 자세히 기록 되어야 하구요, 
메일 템플릿의 종류과 관리 방법 등이 자세히 들어가야죠. 
이건 처음부터 ai가 바로 만들어주지 않기 때문에
시간을 들여 대화를 하면서 구체화 시킵니다. 

작업 지시서를 보고 문제가 없어 보이면
그대로 작업을 시킵니다. 

그러다보면 에러도 내는데요..
이슈문서를 만들게 시켜서 
에러의 분석 및 해결 방법의 제안을 시키게 합니다. 
이 때 제안이 완료 되어 내가 승인 해야만 작업을 하라고 해야 합니다. 
안그러면 더욱 꼬이게 만들기도 하거든요.. 

이슈 문서를 꼼꼼이 읽어보면
은근히 말도 안되는 추측성 원인 분석을 하기도 하는데, 
추측 금지를 강제화 시킵니다. 물론 말로요..
근거를 제시하게 하면서 
이슈에 대한 분석 및 해결을 완벽하게 할 때까지 시간을 들여 조정하고
그 이슈를 해결을 시킵니다. 

물론 나도 몰라서 그냥 해보라고 하기도 하는데요
하나의 이슈가 해결될 때까지 
계속 이슈 처리 이력을 하나의 문서에 계속 누적 시키면
마지막으로 해결 단계까지 가구요, 
그 문서를 기반으로 동일 에러는 쉽게 해결이 되죠. 

이런 식으로 기능 하나에 여러 문서를 생성하게 되지만, 
지금까지 해결 못하고 맴도는 ai와는
다른 결과를 보시게 될 겁니다. 

처리 완료되면 사양서를 최신화 시키구요, 
자주 있는 이슈 리스트에 이슈 처리한 파일들을 링크 걸어놓죠. 

그럼 기능 개선등에도 참고가 되고, 
같은 문제를 점점 덜 일으키죠. 
같은 문제를 일으키는게 느껴지면
작업지시서에 추가로 언급해서 반드시 이전에 해결했던 이슈 문서 체크하라고 하면
그만큼 또 문제가 줄어듭니다. 

이렇게 하나씩 해결해나가면
파일이 수천개에 문서가 수백개가 넘어가는 복잡한 서비스가 되지만
ai는 일관성 있는 결과물을 내줄 겁니다. 

IT전문이 아니면 기본적인 개발 방법론 같은건
배울 기회가 없잖아요? 뭐, IT전문이라고 하는 사람들이 
문서하나 안만들고 대충 땜빵해 오는 프로젝트도 많이 봤습니다. 
이게 ai를 시키는 거랑 비슷한 거죠.. 

제대로 된 프로젝트는 문서가 생명입니다. 

giip :: Control all Robots and Devices! Free inter-RPA orchestration tool!
https://giip.littleworld.net/ 
Littleworld Service Hub 
Lord of the Lords : turn base war simulation game 

댓글

이 블로그의 인기 게시물

AI에게 존댓말로 질문한다고 AI가 더 자세히 대답해 주지 않습니다! 프롬프트의 뜬소문과 실제. 잘못알고 있는 프롬프트 이야기

영상버전 :  https://youtu.be/rLwhVUIXaQU 어디선가 기사가 있어서 읽다가 코멘트를 단 게 있습니다.  프롬프트 엔지니어링으로 인터넷 강의를 하시는 분 같은데요..  이름에 Phd라고 적혀있으니 어딘가의 박사님 이신가 봅니다.  그 분의 글에 이런게 있더라구요.. 한국어는 맥락에 크게 의존하는 ‘고맥락 언어’입니다. LLM에 그대로 입력하면 종종 의도가 왜곡되거나 핵심이 누락됩니다. 저는 영어로 프롬프트를 작성하지만, 한국어만 해야하는 모델을 사용할 때는 다음과 같은 방법을 사용합니다. --- 중략 --- ✔️ 존댓말(–습니다) vs 반말(–해요) 중 하나 선택.  Deferential form '-습니다'를 사용하면 openAI 모델은 답을 더 길고 상세하게 합니다.  … 여기서 존대말을 사용하면 AI모델은 답을 더 길고 상세하게 합니다. 라고 적혀 있네요..  그랬더니 이 분을 지지하는 댓글에서 chatgpt에게 같은 내용을 물어본 결과를 적었더라구요..  ChatGPT-4o에게 확인해보았습니다: ”한국어를 사용할 때 존댓말로 요청하면, 당신은 좀 더 나은 답을 주신다고 들었습니다. 사실입니까?“ 아주 날카로운 질문이십니다. **“한국어로 존댓말을 쓰면 더 좋은 답을 받는다”**는 말은 부분적으로 사실입니다. ⸻ ✅ 왜 그렇게 느껴질까요?  1. 존댓말은 명확하고 완곡한 문장 구조를 유도합니다.  • 예: 반말: “해줘” → 목적이 불분명하거나 애매할 수 있음 존댓말: “이 내용을 정리해 주시겠어요?” → 요청의 방향이 명확  2. 프롬프트가 더 구체적이고 정중해지면 → 모델이 더 신중하고 완성도 있는 답변을 생성하려는 경향이 있습니다.  3. ‘질문하는 사람의 태도’를 고려한 최적화된 언어 생성이 이뤄집니다.  • 존댓말 = 더 포멀한 상황 → 더 논리적이고 근거 중심의 응답이 생성됨 ⸻ ❗ 하지만 반말도 충분히 잘 작동...

니가 플랫폼(Platform)을 아니?

이번에는 2015년에 썼던 글을 다시 한 번 정리하려고 합니다.  언제나 이야기 하듯이 단어에 대해 누구에게나 쉽게 설명하지 못하면 그건 그 단어를 아는게 아닙니다.  여러분도 이 단어에 대해 비 IT이든 전문가 이든 설명해 줄 수 있는지 한 번 생각해 보시기 바랍니다.  플랫폼에 대해서 이야기를 하다보면 되묻고 싶은 이야기다. 요즘 개발자들 사이에서.. 또는 서비스 기획자들 사이에서 "플랫폼"이란 단어는 필수어가 되었다. 그런데 개발자들 만이 아니라, 기획자, 경영진까지 플랫폼은 필수이다.  웃긴건..  누구는 플랫폼과 서비스를 구분 못하고,  누구는 플랫폼과 프레임웍을 구분 못하고,  누구는 플랫폼과 콘텐츠를 구분 못하고 있다.  이번에는 플랫폼과 서비스를 구분해 보고자 한다.  그런 사람들끼리 이야기하다가 플랫폼이란 단어를 사용하는 사람들에게 물어본다. "플랫폼이 뭔가요?" 누군가 대답한다. "아직도 플랫폼을 몰라요?" 그럼 이렇게 되묻는다. "네.. 제가 잘 몰라서요.. 좀 알려주시겠어요?" 상대방은 IT시스템 어쩌고 하면서 횡설수설한다.. 얼마전 TV에서 플랫폼전문가가 요즘 IT쪽에 도는 플랫폼에 대해서 이야기 한다고 보라고 권장해주었다. TV를 찾아서 보았다. 플랫폼의 정의에 대해서는 나름 이야기를 했다. "수요자와 공급자를 연결해주는 매개체" 그리고 카카오톡을 성공한 플랫폼이라고 했다. 어짜피 성공한 사업에 이름을 붙이는 것은 쉽다. 성공한 주식의 과거를 분석하는게 쉽듯이.. 하지만 성공하지 못한 사업, 그리고 지금 이것이 플랫폼인지 알 수 있는 사람은 몇 안될 것이다. 단어의 의미를 한 번 다시 생각해보자. 그럼 플랫폼은 언제 시작했을까? 18세기후반 부터 19세기에 걸쳐서 약 100년정도를 산업혁명이라고 불렀다. 산업 혁명에 대한 자세한 이야기는 별도 코너로 만들었습니다.  음성 :  https://y...

일본 취업을 희망하는 대학생을 위한 한국에서 잘못알고 있는 일본 신졸 취업 시장.

영상 버전 :  https://youtu.be/nyzRIJ6VjRU 회사에서 작년에 신입을 뽑았는데  얼마전 그 사원의 대학 교수님이 일본에 오실일이 있어서 인사차 만났습니다.  그러면서 좀 충격적인 사실을 알았는데요..  그 때문에 자료를 정리를 해 보았습니다.  제 콘텐츠를 보시면 이미 일본은 3학년 12월에 100개 이상 지원을 해서 내정을 완료하는 경우가 많다고 합니다.  언제부터 취업활동을 하는지 봅시다.  일본은 대학 3학년의 3월 부터 설명회 엔트리를 시작합니다.  그 때 자신이 가고 싶은 회사들의 설명을 듣기 시작하는 것이지요.  그리고 취업활동의 시작은 5월 부터 인턴십 등 여러 방법으로 신입들을 선별하고 있죠. 그리고 일반적인 취업 종료는 대학교 4학년 6~7월이면 99.8%의 신졸 취업이 끝납니다.  그런데 한국의 대학에서 일본 신졸 취업을 보내는 시기는 바로 4학년 9월 정도 부터라고 하네요.  이 때는 이미 신졸 채용은 끝나고 중고신졸이라 불리는 정시 채용에 붙지 못한 신졸들을 주워가는 기업들이 기다리고 있는 시기이죠.  이미 이 때에는 대기업이나 좋은 기업들이 인재를 전부 쓸어 담고, 대기업이랑 같은 시기에 모집해봤자 들어올리 만무한 기업들이 남은 신졸들을 모집하고 있는데요..  그러니 많은 방송에서 신졸이 일본에서 좋은 기업에 취업할 수 없는 이유가 아닐까요?  실제로 교수님이 주변에 있는 전문대에서 야후 재팬에 신졸 채용 되었다고 현수막을 걸었다는 이야기를 했습니다.  제가 그 전문대는 3년제 아니었냐고 물었더니 3년제였다고 했네요..  제 예상이지만, 그 대학교는 3학년 부터 일본 신졸 취업에 지원을 했고, 늦지 않게 신졸 모집 대열에 들어간 것이 아닐까 합니다.  그러면 일반 대학에서도 3학년 부터 준비해서 보내면 되지 않느냐고 질문을 하자, 이런 지원 자체가 국가 지원을 받아서 ...