https://roboco.io/tags/documentation/ Recent content in Documentation on ROBOCO Hugo ko-kr Thu, 10 Sep 2026 10:00:00 +0900 https://roboco.io/posts/vibe-coding-documentation/ Thu, 10 Sep 2026 10:00:00 +0900 https://roboco.io/posts/vibe-coding-documentation/ <blockquote> <p>문서의 목적은 커뮤니케이션이다. 바이브 코딩은 그 대화에 참여하는 주체를 늘린다.</p> </blockquote> <figure><img src="https://roboco.io/posts/images/Dohyun.png"><figcaption> <h4>정도현 - 로보코 수석 컨설턴트</h4> </figcaption> </figure> <hr> <h2 id="tldr">TL;DR</h2> <ul> <li>바이브 코딩에도 기존 문서화 원칙이 적용된다. 에이전트에게 작성과 정리를 맡기면 적은 수고로 모범 사례의 혜택을 누릴 수 있다.</li> <li>계속 갱신할 기준 문서와 목적을 달성하면 역할을 마치는 일회성 문서를 구분하라. 모든 문서를 현행화할 필요는 없다.</li> <li>문서는 짧은 마크다운으로 나누고 폴더별 인덱스와 규칙, 스킬로 연결하라. 필요한 작업에서 찾아 읽을 수 있어야 한다.</li> <li>자주 빠르게 확인할 내용은 열거형으로, 맥락을 이해하고 깊이 검토할 내용은 서술형으로 작성하라.</li> <li>문서는 사람과 사람, 사람과 AI, AI와 AI가 의도와 판단 기준을 공유하는 수단이다. 사람은 목적을 정하고 결과를 판단하는 데 집중하라.</li> </ul> <hr> <p>여러 차례 밝혔듯이 바이브 코딩에도 기존 소프트웨어 개발의 원칙이 그대로 적용된다. 문제를 정의하고 설계한다. 구현하고 검증한다. 결과를 검토하고 개선한다. 사람이 하든 에이전트가 하든 이 과정은 필요하다. 달라지는 것은 각 단계를 수행하는 주체와 비용이다.</p>