본문으로 건너뛰기

IT 기술 창업 톺아보기 (1)

· 약 19분
조준철
HandStack 개발자

저는 2000년 IT 버블이 시작되었던 때 개발 직업으로 사회생활을 시작했습니다.

직장 생활을 하면서 언젠가 나만의 회사를 가지고 싶다는 생각으로 창업에 대한 관심을 가지게 되었고, 직장 생활 3년 차에 지인 3명과 함께 조그맣게 사업을 시작했지만, 1년도 안 되어 문을 닫게 되었습니다. 이후 한참 동안 회사 일에 집중하다 보니 어느새 결혼도 하고 아이도 생겼네요.

최근에는 창업에 대해 더 늦기 전에 다시 한번 도전해보고 싶어서 회사를 다니며 틈틈이 준비하다 보니, 창업이 나에게 너무나 어렵다는 것을 느끼고 있습니다. 현실적인 문제나 제 의지의 문제는 어떻게든 해보겠는데, 개인적으로 제 성향 자체가 창업에 적합하지 않다는 것을 작년 중순쯤 깨닫게 되었습니다.

그래서 창업을 시도하는 방법을 꼭 사업자를 내고 시작하는 것이 아닌, 개발자로서 내가 잘할 수 있으면서 꾸준히 할 수 있는 일을 만드는 방법을 찾아가는 중입니다. 이번 글에서는 저와 생각이 비슷한 개발자이면서 "창업"에 고민하시는 분들을 위해 IT 기술 창업에 대해 약간의 경험을 추가해서 세 개의 글로 톺아보고자 합니다.

창업 아이템 구분

창업은 크게 문화, 서비스, 기술 분야로 구분하면 내가 추구하고자 하는 대략적인 비즈니스를 이해하는 데 도움이 됩니다.

  • 문화: 대중문화 콘텐츠를 기반으로 한 문학, 그림, 공연, 애니메이션, 음악 등과 다양한 브랜드와 협업을 통해 사업을 확장하고 수익을 창출합니다.
  • 서비스: 기존의 낡은 서비스를 혁신하거나 새로운 서비스를 창출하는 것으로, 전화 주문 배달 서비스를 모바일 앱을 통해 주문과 배달을 하거나, 기존의 유료 서비스를 무료로 대체하며, 다양한 부가 서비스를 통해 수익을 만드는 플랫폼을 만듭니다.
  • 기술: 경쟁 제품이나 서비스를 더 저렴하게 만들거나, 더 비싸더라도 가치 있는 제품을 만들어내는 것을 목표로 합니다. 예를 들어, 전기차를 기존 내연기관차보다 더 효율적이고 안전하게 만들거나, 최근 화제가 된 우주 탐사를 더 저렴하게 만들기 위해 재사용 가능한 로켓을 개발하는 것 등이 있습니다. 고가의 프리미엄 제품을 통해 사용자들에게 높은 가치를 제공하며, 충성도 높은 고객층을 확보합니다.

국내 스타트 업에 등록된 회사가 대략 20,710개가 되는데 이중에서 IT 기술 창업 분야의 비중은 100 을 기준으로 대략 문화: 10, 서비스: 70, 기술: 20 정도로 예상하는데, 저의 사업 아이템의 경우도 서비스에 해당합니다.

창업가의 출신 배경

일반적으로 회사를 다니며 얻은 업무적, 기술적 전문 지식과 경험을 바탕으로 창업을 시작합니다. 직장인의 경우 비즈니스와 개인의 성향에 따라 자신만의 커리어를 구축하게 되는데, 그러다 보니 시간이 지날수록 자연스럽게 익숙해지는 업무 스킬과 성향이 있을 수밖에 없습니다.

  • 개발자, 연구소 출신: 기술적 전문성을 바탕으로 문제를 인식하여 새로운 기술이나 기존 기술을 혁신하여 해결을 시도합니다.
  • 영업인 출신: 고객과의 소통 능력과 시장 이해도를 바탕으로 비즈니스 모델을 혁신하거나 새로운 시장을 개척합니다.
  • 인문대 출신: 다양한 시각과 창의적인 사고를 바탕으로 문제를 이해하여 제품 디자인과 사용자 경험 향상에 중점을 둡니다.

저도 직장에서 오랜 기간 개발 업무를 하다 보니 일상 생활에서도 같은 방법으로 논리적으로 상황과 문제를 인식하고 해결하려는 것이 가끔 불편한 상황을 초래하는 경우가 있습니다. 주어진 환경과 맥락에 맞게 적절하게 대응해야 하는데, 직장 생활이 길어지고 나이가 40 대를 넘어가면 알게 모르게 쓸데없는 고집이 생겨나게 되어서인가 봅니다. 이것을 40대에서는 "곤조" 라는 일본어로 일에 대한 카리스마와 고집을 묘하게 섞은 말로 표현하고 하는데요.

제가 가진 사업 아이템에 대해 지인들과 이야기를 나누었을 때 한 지인이 "너는 곤조가 강해서 사업하면 안 된다"라는 말이 인상 깊게 남아 있습니다.

단순하게 사람을 상대할 때 "유" 해지라는 게 아니라, 직장을 다닐때는 "곤조"가 필요하지만 사업을 하기 위해서는 기존의 방식을 벗어나서 자신만의 방법으로 "스스로에게 사업의 존재 이유가 무엇인지 되새기고, 상대방이 원하는 것이 무엇인지 알아내기 위한 번뜩이는 질문을 던지는 실행력이 있어야 하며, 실패를 하더라도 문제의 원인을 찾아 해결책을 만들어내는 방법을 찾는 과정을 제시해야 하는 것"을 토대로 사업을 시작하는 마인드를 가져야 한다는 것을 의미합니다.

직장인과 창업가를 구분짓는 것이 특정 분야의 도메인 전문가가 아니라 출신에 상관없이 모든 분야에 관심을 갖고 배우는 자세가 필요합니다.

사업의 본질은 수익 모델

기업의 가장 중요한 본질은 수익 모델입니다. 당연한 말인데 그게 경험이 없다보니 어렵습니다.

저의 경우 정부지원사업의 초기창업패키지를 활용하여 시작하려고 준비하다가 떨어진 경험이 있는데, 나중에 곰곰이 생각해보니 내가 사업 계획서의 내용이 "사업 아이템이 아니라" 상용화를 위한 기술 개발을 조건으로 "유의미한 성과"를 아이템으로 준비했었던 거구나 라는 깨달음을 얻을 수 있었습니다.

수익 모델이란 기업이 어떻게 돈을 벌 것인지에 대한 구체적인 비즈니스 모델을 의미합니다. 특정 분야의 기술만 가지고 사업을 시작하면 남의 일만 해주고, 연명하는 용역 서비스의 길에서 쉽게 빠져나오기 힘들기 때문에, 사업 아이템에 대한 로드 맵은 생존을 위한 아이템이고 두 번의 기회는 없다는 의지가 필요합니다.

지식재산권, 특허, 브랜드 등 사업 아이템을 지킬 수 있는 핵심 역량 보유는 기본이어야 해서 시행착오를 줄이기 위해 가장 잘할 수 있는 분야에 집중했더니 기존 용역 서비스와 크게 다르지 않는 것을 아이템으로 추친을 하고 있었습니다.

적어도 내가 그려나가는 아이템을 제품의 완성까지의 시간과 비용을 계산해서 시장의 규모와 함께 형성되는 시기를 예측하는 지혜가 필요했습니다.

이때부터 직장인이 1인 기업이나 소수의 인원으로 스타트 업을 한다는 게 얼마나 많은 시행착오를 견뎌야 하는 여정인지 감이 오기 시작했습니다.

사업계획서는 필수 문서

사업계획서는 투자자들에게 사업의 가능성을 설득해서 투자를 받기 위한 문서라고 생각 했었는데, 그게 아닙니다. 창업의 성공을 위해 필수적으로 만들어야 하는 문서입니다.

제한된 일정과 자금의 압박속에 많은 시행착오를 견뎌야 하는 여정은 번아웃을 겪게 만들어 줍니다. 사업계획서는 그 와중에도 사업 아이템의 계획과 마일스톤을 체계적으로 정리하여 방향성을 명확히 하기 위한 스스로를 위한 문서이기도 하고, 언제든 힘든 여정에 함께 하는 팀원들이 사업의 목표와 전략을 이해하고 공감할 수 있는 문서이기 때문입니다.

사업계획서는 생각보다 간단하게 만들어도 됩니다. 대부분 엘리베이터 스피치나 커피챗과 같이 가볍게 아이템을 주제로 이야기를 할 수 있는 내용으로 작성해두고 언제든 업데이트가 편하게 유지하는 것이 좋은데, 향후에 다양하게 활용하기 위해서 다음의 항목만은 정리해두는 것이 좋습니다. 저의 경우 Markdown 으로 작성해서 OneDrive 에 개인 디렉토리로 보관해두어 집과 직장의 PC와 노트북으로 필요할 때 마다 언제든 내용을 업데이트 합니다.

  • 문제: 고객이 해결하고자 하는 문제를 명확히 정의합니다.
  • 아이템: 문제를 해결할 수 있는 제품이나 서비스를 설명합니다.
  • 고객 비전: 고객이 제품이나 서비스를 통해 얻을 수 있는 가치를 설명합니다.
  • 수익 모델: 아이템으로 어떻게 수익을 창출할 것인지 설명합니다.
  • 보유 기술: 사업에 필요한 핵심 기술과 고유한 강점을 설명합니다.
  • 팀의 능력: 제품이나 서비스 개발과 운영을 위한 팀원들의 역량과 역할을 설명합니다.
  • 경쟁사: 주요 경쟁사와 그들의 강점 및 약점을 분석합니다.
  • 시장 크기: 목표 시장의 규모와 성장 가능성을 평가합니다.
  • 자금 계획: 필요한 자금과 그 사용 계획을 상세히 설명합니다.
  • 로드맵: 사업의 주요 단계와 목표를 시간 순서대로 제시합니다.
  • 브랜딩: 브랜드 전략과 마케팅 계획을 설명합니다.
  • 예상 수익: 예상되는 수익과 그 근거를 제시합니다.

재능 있는 창업가 vs 사업을 만들어 낼 팀

창업을 하기 위해 만드는 비즈니스 모델과 사업계획서는 준비 과정에 불과합니다.

실제로 사업을 성공적으로 수행하기 위해서 개발과 업무 모두 풀 스택으로 모든 것을 다할 수 창업가가 1인 기업으로 어디까지 사업 확장이 가능할까요?

제품이나 서비스 개발, 마케팅, 고객 지원 등 다양한 역할을 최대한 간소화 해서 어느정도 수행할 수 있지만, 아직 수입 모델이 없고, 사업이 성장함에 따라 일이 양이 많아지게 되면 분명 한계에 부딪히게 되는 시점이 옵니다.

그래서 사업 초기라면 당장은 괜찮을 수 있지만 최소 기능 제품(Minimum viable product: MVP) 이후 이러한 한계를 극복하기 위해서는 팀을 구성하는 것이 필요합니다. 투자자들 사이에서는 "팀원이 없다면, 아무리 훌륭한 계획도 한 편의 소설에 불과할 수 있습니다." 라고 합니다.

IT 제품이나 서비스는 특성상 기업(Business)을 대상으로 하는 B2B와 소비자(Consumer)를 대상으로 한 B2C를 대상으로 하게 되는데 창업을 하면 고객에서 보여줄 수 있는 최소 기능 제품 개발 이후 시점에 고객에게 어필 할 수 있는 사업자를 설립하고 최소한의 브랜딩 작업을 한 다음 하나의 선택을 해야 합니다.

B2C를 대상으로 제품을 만들었다면 스타트 업 관련 대회에 참여하거나 투자를 받아야 하는 것을 적극적으로 고려를 해야합니다. 이때부터 창업투자회사의 모태펀드의 조합, 출자방식을 이해하고 투자자들을 대상으로 IR (Investor Relations) 활동을 해야하거나 이것이 가능한 팀 원을 반드시 영입을 해야합니다.

B2B를 하게 되면 고객이 관심을 가질만한 제품이나 서비스를 탄력적인 가격으로 고객과 대화를 하기 위해 학연, 지연, 혈연을 포함하여 주위의 모든 네트워킹을 활용하여 영업을 해야하거나 제품을 이해하고 고객과의 원활한 소통이 가능한 팀 원을 반드시 영입을 해야합니다.

저의 경우 HandStack을 최소 기능 제품 수준으로 개발하고 난 이후 이 시점에서 주변 지인들에게 데모로 보여주며, 향후 로드 맵을 구상을 했었는데 이때 얻은 결론은 사업 아이템의 계획과 방향성을 명확히 하는 데 많은 도움을 얻었습니다.

이번 글에서 요약

직장을 다니다가 IT 기술 창업에 대한 저의 경험과 생각을 공유해 보았습니다. 비즈니스 모델과 사업계획서는 준비 과정에 불과합니다. 실제로 사업을 성공적으로 수행하기 위해서는 현실적으로 이를 실행할 수 있는 팀이 필요합니다.

그래서 IT 기술 창업을 준비 중이시라면 사업자를 내고 시작하는 것이 아니라 지금 다니고 있는 직장에서 회사와 학연, 지연, 혈연을 포함하여 주위의 모든 네트워킹을 활용하여 주변 지인들과 윈윈할 수 있는 방안으로 진행을 하고, 어느정도 수익 모델이 확보가 되었을 때 사업자를 내시는 것을 권장합니다.

다음 글에서는 구체적인 창업 전략에 대해 이야기를 다루겠습니다. 감사합니다.

https://github.com/handstack77/handstack

개발자는 코드로 말합니다

· 약 15분
조준철
HandStack 개발자

저는 개발자에게 중요한 능력이 코드, 협업, 전달 세 가지에 있다고 생각합니다. 어떤 우선순위를 정하든, 개발자는 항상 코드에 많은 가치를 두어야 한다는 점은 변하지 않습니다.

코드는 단순한 도구를 넘어섭니다.

개발자들의 사고방식과 작업 방식을 반영하는 중요한 요소이기 때문인데 다음과 같은 이유들로 인해 개발자들은 코드로 말하는 것을 선호합니다.

  • 명확성과 정확성: 자연어는 모호할 수 있지만, 코드는 명확한 규칙과 구조를 가지고 있어 오해의 여지가 없습니다. 개발자는 코드를 통해 자신의 의도를 정확하게 전달할 수 있습니다.

  • 효율성: 복잡한 개념이나 로직을 코드로 표현하면, 이를 이해하는 사람들은 빠르게 그 내용을 파악할 수 있습니다. 이는 개발자들 뿐만 아니라 특정 도메인 전문가 간의 협업을 원활하게 하고, 문제 해결 속도를 높입니다.

  • 재사용성과 유지보수성: 잘 작성된 코드는 수정하기 용이하기 때문에 다른 프로젝트나 업무에서도 재사용될 수 있으며, 개발자들이 효율적으로 작업할 수 있도록 도와줍니다.

  • 자동화와 도구 활용: 예를 들어, 코드 가이드 준수, 번들링, 테스트 등등 개발 업무에 도움을 주는 도구와 함께 사용하면 코드의 품질을 높일 수 있습니다. 이는 개발자들이 더 나은 코드를 작성하고, 오류를 줄이는 데 도움을 줍니다.

  • 글로벌 커뮤니케이션: 개발자들은 서로 다른 언어를 사용하더라도, 코드를 통해 의사소통할 수 있는 전 세계적으로 통용되는 언어입니다. 이는 다양한 배경을 가진 개발자들이 함께 일할 수 있도록 합니다.

  • 문제 해결 능력 향상: 코드를 작성하는 과정은 문제를 분석해서 구조화하고, 단계별로 해결하는 과정입니다. 개발자들은 코드를 통해 문제 해결 능력을 향상시키고, 더 나은 솔루션을 찾습니다.

개발자들은 코드를 통해 새로운 아이디어를 구현하고, 독창적인 솔루션을 만들어낼 수 있습니다. 하지만 함께 고객과 일하는 사람들을 위해 코드와 제품을 공유할 때 그 가치는 더욱 의미가 있습니다. 이는 개발자들에게 큰 만족감을 줍니다. 제가 HandStack 프로젝트를 만들고 유지하는 이유입니다.

공유함으로써 얻는 가치는 중요합니다.

프로젝트의 성공 가능성을 높이기 위해 개발자들이 더 나은 협업 환경을 쉽게 조성하고, 동일한 목표로 함께 일하는 것은 매우 중요한 요소입니다. 다음은 그 이유들을 설명한 내용입니다.

  • 협업과 팀워크 향상: 새로운 프로젝트를 시작할 때, 기술적인 부분에 대한 공감대를 먼저 형성하면 팀원들이 서로의 작업을 이해하고, 더 잘 협력할 수 있습니다. 이는 프로젝트의 진행 속도를 높이고, 더 나은 결과물을 만들어내는 데 도움을 줍니다. 팀원들은 각자의 강점을 발휘하여 문제를 해결하고, 더 나은 솔루션을 찾을 수 있습니다.

  • 코드 품질 향상: 표준화된 소스코드 가이드라인은 다른 개발자들이 작성한 코드를 참조하고 리뷰하거나 코드의 품질을 일관되게 만들며, 버그를 줄이는 데 도움을 줍니다.

  • 지식 공유와 학습: 지식 공유는 팀 전체의 역량을 높이는 데 중요한 역할을 합니다. 새로운 기술이나 방법론을 배우고, 이를 실제 프로젝트에 적용할 수 있습니다.

  • 유지보수와 확장성: 여러 개발자가 코드를 이해하고 수정할 수 있기 때문에, 특정 개발자에게 의존하지 않고도 프로젝트를 지속적으로 발전시킬 수 기회가 열려있습니다. 이는 프로젝트의 안정성과 유지보수와 확장성이 향상됩니다.

  • 투명성과 신뢰성: 프로젝트의 투명성이 높아집니다. 팀원들은 프로젝트의 진행 상황을 명확하게 파악할 수 있고, 이는 신뢰성을 높이는 데 도움을 줍니다. 투명한 코드는 팀원들 간의 신뢰를 구축하고, 더 나은 협업 환경을 조성합니다.

  • 문제 해결 속도 향상: 문제를 빠르게 해결할 수 있습니다. 여러 개발자가 동시에 문제를 분석하고 해결책을 제시할 수 있기 때문에, 문제 해결 속도가 빨라집니다. 이는 프로젝트의 진행을 원활하게 하고, 일정 준수를 가능하게 합니다.

  • 창의성과 혁신 촉진: 다양한 아이디어와 관점이 반영될 수 있습니다. 팀원들은 서로의 아이디어를 바탕으로 새로운 접근 방식을 시도하고, 창의성과 혁신을 촉진하며 더 나은 결과물을 만들어낼 수 있습니다.

의도와 내용을 전달하는 방법을 알아야 합니다.

협업을 원활하게 하고, 코드의 품질을 높이는 데 중요한 것은 자신만의 루틴을 만들고 공유하는 겁니다. 다음과 같이 개발자들은 코드의 의도와 내용을 효과적으로 전달할 수 있습니다.

  • 주석 작성 최소화: 주석을 통해 코드의 목적, 동작 방식, 사용된 알고리즘 등을 설명할 수 있습니다. 개인적으로는 주석은 선호하지 않습니다. 주석보다 다른 개발자들이 코드를 이해하는 데 간결하고 명확하게 작성하는 것과 미사용되는 코드를 삭제하는 것이 중요합니다.

  • 명확한 변수 및 함수 이름 사용: 변수와 함수의 이름을 약어를 사용하지 않고 명확하게 짓는 것은 코드의 의도와 내용을 전달하는 데 큰 도움이 됩니다. 의미 있는 이름을 사용하면, 코드의 목적과 동작 방식을 쉽게 이해할 수 있습니다. 예를 들어, calculateTotal이라는 함수 이름은 함수가 총합을 계산하는 역할을 한다는 것을 명확히 전달합니다. 변수와 함수는 하나의 기능을 담당하도록 개발합니다.

  • 코드 구조화: 함수나 클래스를 적절하게 분리하고, 코드 블록을 논리적으로 배치하면, 코드의 가독성이 높아집니다. 이는 다른 개발자들이 코드를 이해하고 유지보수하는 데 도움을 줍니다.

  • 문서화: 코드와 함께 문서를 작성하는 것도 중요한 방법입니다. 문서에는 코드의 전체적인 구조, 주요 기능, 사용 방법 등을 설명할 수 있습니다. 특히, API 문서나 사용자 가이드는 다른 개발자들이 코드를 이해하고 사용하는 데 큰 도움이 됩니다. 특히 MarkDown 문법은 개발자에게 문서화에 들어 가는 많은 시간을 절감 시켜줍니다.

  • 코드 리뷰: 코드 리뷰는 다른 개발자들과 코드를 공유하고 피드백을 받을 수 있는 좋은 방법입니다. 코드 리뷰를 통해 코드의 의도와 내용을 명확하게 전달하고, 개선점을 찾을 수 있습니다. 이는 코드의 품질을 높이고, 개발자들 간의 협업을 촉진하기 위해 정기적인 업무 문화로 만드는 것이 필요합니다.

  • 테스트 코드 작성: 테스트 코드를 통해 코드의 동작 방식을 검증하고, 예상되는 결과를 확인할 수 있습니다. 이는 코드의 안정성과 신뢰성을 높이는 데 중요한 역할을 합니다. 개인적으로 단위 테스트 케이스 보다 기능 테스트를 위해 반복적으로 요청을 재현하고 검증하는 테스트 코드를 만드는 것을 선호합니다.

  • 코드 컨벤션 준수: 일관된 스타일과 포맷을 사용하면, 다른 개발자들이 코드를 이해하고 유지보수하는 데 도움이 됩니다. 코드 컨벤션은 팀 전체의 코딩 스타일을 통일하고, 협업을 원활하게 합니다.

  • 예제 코드 제공: 예제 코드를 제공하면, 코드의 사용 방법과 동작 방식을 쉽게 이해할 수 있습니다. 예제 코드는 많은 문서화 보다, 다른 개발자들이 코드를 활용하는 데 도움을 줍니다. 이는 특히, 라이브러리나 프레임워크를 개발할 때 유용합니다.

코딩 능력은 개발자의 핵심 업무입니다.

개발자의 가치는 설득이 아니라 증명입니다. 이는 바로 결과를 보여줄 수 있는 직업으로, 실질적인 성과를 만들어냅니다. 코드가 바로 개발자가 가장 중요하게 생각해야 할 부분이라고 할 수 있습니다.

협업은 팀원 간의 소통을 통해 더 나은 결과물을 만들어낼 수 있게 도와줍니다. 프로젝트를 진행하면서 다른 개발자와 의견을 나누고, 문제를 함께 해결하는 과정은 필수적입니다. 코드, 협업, 전달의 균형을 맞추는 것이 중요합니다. 그래야만 최상의 결과물을 만들어낼 수 있습니다.

약간 극단적으로 표현하면 코드 스킬은 본인의 주 업무이고 협업, 전달 능력은 다른 사람을 위한 부 업무라고 볼 수 있기 때문에, 개발 성향이 강한 개발자는 코드에 집착하며, 관리 성향이 강한 개발자는 코드보다 협업, 전달에 우선순위를 둡니다.

시간이 지남에 따라 본인의 커리어를 위해 다양한 선택을 해야 할 때, 지금까지 무엇에 가치를 두었고 앞으로 무엇에 더 가치를 둘 것인지 항상 생각하는 것이 좋습니다.

Marp와 OBS Studio를 활용하여 HandStack을 처음 사용하는 개발자들을 대상으로 동영상 자료를 만드는 중입니다. 아쉽게도 개인 사정상 정기적으로 컨텐츠를 올리기 어렵지만 꾸준히 올리도록 하겠습니다.

신입 개발자를 위한 온보딩 업무 팁

· 약 11분
조준철
HandStack 개발자

어떻게 하면 신입 개발자가 조직에 온보딩을 잘 할 수 있을까? 저의 경험을 바탕으로 한 조언을 3개를 정리 했습니다. 이 사람은 이랬었구나 하며 읽어 주시면 좋을 듯 합니다.

프로젝트를 진행하면 늘 제한된 자원과 상황에 놓이며 최종 기한에 쫓기며 살게 됩니다만, 적당한 스트레스는 업무 효율을 높이는 데 긍정적인 영향을 미칠 수 있습니다. 다양한 연구 결과와 사례도 많이 있습니다.

프로젝트에서 충분한 일정과 자원이 주어지면, 업무를 끊임없이 조정하고 다듬으며 "완벽한" 해결책을 찾기 위한 완벽주의의 함정에 빠지기 쉽습니다.

이를 잘 설명한 것이 파킨슨의 법칙(Parkinson’s Law)입니다. 영국의 시릴 노스코트 파킨슨(Cyril Northcote Parkinson)이 1955년에 제안한 개념으로, 업무를 마치는 데 걸리는 시간은 할당된 마감 시간만큼 늘어난다는 법칙입니다.

예를 들어, 프로젝트 단위 기능 개발이 2주 안에 완료되어야 하면, 그 작업은 2주 동안 계속 늘어질 수 있습니다.

무엇이 중요한가?

제가 3년 차일 때, 대기업의 Java, Oracle 기반 회계 프로그램을 .NET 2.0, SqlServer로 전환하는 프로젝트에 투입되었습니다. Typed DataSet이라는 ORM 초기 개념의 기술을 활용하여 Winform을 개발하는 프로젝트였는데, 10명 정도가 1년 동안 진행한 제법 큰 프로젝트였습니다.

문제는 제가 Java, Oracle 기술은 어디서 들어본 수준밖에 되지 않았고, 차변 및 대변의 의미를 모를 정도로 회계 업무에 대한 이해가 전혀 없었다는 점이었습니다. 업무와 기술이 부족하면 현실적으로 야근과 철야를 반복할 수밖에 없었습니다. 가진 것은 책임감과 체력이었으니까요. 물론 지금은 배포/운영 장애 상황이 아니면 야근하지 않습니다.

스트레스를 하나도 받지 않고 살 수는 없습니다. 그래서 스트레스를 어떻게 관리하느냐가 중요한데, 저의 경우 해본 적이 없는 새로운 업무에 대해 제 전공과 경력을 활용할 수 있는 상황이라면 다음과 같이 긍정적으로 생각합니다.

  • 레퍼런스가 있는가? 아주 좋아요! 검증된 가이드라인이 있다는 것은 업무에 대한 보고와 설득의 시간을 줄여주며, 완료 시기를 가늠하며 기승전결을 구상할 수 있습니다.
  • 레퍼런스가 없는가? 아주 좋아요! 누구도 해보지 못했던 경험을 나보다 잘 아는 사람이 많아지도록 업무에 대한 보고와 설득할 수 있는 권한이 생겼습니다.

부당하게 받아들일 수 있는 업무를 통해 새로운 기술이나 학습과 성장 기회를 습득할 수 있는 기회가 있는지 확인합니다. 내가 업무를 주도할 수 있는 기회는 흔하지 않습니다. 이는 본인에게 장기적으로 도움이 될 수 있습니다.

내 능력으로 할 수 없는 일은?

최종 기한은 일에 대한 우선순위와 실용적인 결정을 내리는 것에 대해 나를 위한 것인지, 조직을 위한 것인지, 고객을 위한 것인지 선택하도록 강제하는 효과가 있기 때문에 어렵고 힘이 듭니다. 하지만 반대로 일의 진행을 위한 주변의 반론을 줄이며 마일스톤을 찍을 수 있는 명분을 만들어주는 강력한 힘이 있습니다.

결자해지(結者解之) "맺은 자가 그것을 풀고, 일을 시작한 자가 마땅히 끝까지 책임져야 한다"는 의미를 마음에 품는 편인데, 10명 중 9명은 그것을 해내기 어렵고, 이것이 나의 강점으로 생각하기 때문입니다. 예전엔 이런 마음이 좀 먹혔던 것 같은데, 지금은 좀 달라진 것 같네요.

그래서 고객의 요청을 정리해서 팀원들에게 보고/설득/전달할 때와 직접 요청을 받아 기능의 추가/개선을 하기 위해 개발 일을 하기 전에 한 번 더 고민해봅니다.

  • 누구에게 꼭 필요한 기능인가?
  • 개발/납기 일정을 스스로 가늠할 수 있는가?
  • 협업 또는 위임이 나을 수 있는가?
  • 더 나은 다른 방안이나 솔루션은 없는가?
  • 결과로 인한 향후 추가 업무의 가능성은?

여건이 되지 않아 일을 마무리 짓기 어렵다면 위의 내용과 함께 보고/공유에 내가 아니더라도 이 작업을 완료하기 위해 필요한 내용을 추가해야 합니다. 예를 들면 다음과 같습니다.

  • 마무리에 필요한 지원 또는 조건 항목을 정리
  • 가능한 해결책을 명확하게 정리

부끄럽게도 제가 신입 개발자 때에는 업무를 뭉개거나, 모르는 체하거나, 파고들 생각을 못한다는 예기를 자주 들었습니다.

최종 기한은 3개로 나누는 게 좋습니다.

IT 프로젝트에서 흔하게 언급되는 단어로 마감일, 마지노선, 데드라인이 있는데, 각 단어의 유래를 찾아보면 사람이 하는 일들은 어디든 비슷비슷하다는 것을 알게 됩니다.

세 가지 용어 모두 어떤 작업이나 과제를 완료해야 하는 마지막 시점을 의미합니다. "최종 기한"이라고 표현할 수 있습니다. 일정에 대한 얘기는 생각보다 입장이나 역할에 따라 오해의 여지가 많아서 3개 정도로 구분해서 소통하는 게 좋습니다.

프로젝트를 하다 보면 흔히 하는 말들 중에 오해를 부르는 말이 있습니다.

  • XXX 이거 언제까지 완료할 수 있나요?
  • XXX 이건 언제까지 가능합니다.

두리뭉실한 이해당사자들 간의 프로젝트 일정에 대한 명확한 커뮤니케이션을 위해 다음과 같이 나누어 할 수 있습니다. 이렇게 구체적인 업무와 일정을 명시하면 오해를 줄이고, 각 업무 단계별로 필요한 업무 단위를 공유할 수 있습니다.

  • 개발 작업은 [날짜]까지 완료될 예정입니다.
  • 품질 검증 및 문서화 작업은 [날짜]까지 완료될 예정입니다.
  • 운영 적용은 [날짜]까지 완료될 예정입니다.

대부분의 경우 역할이 다른 이해당사자들은 서로의 업무가 어떻게 진행되는 지 잘 모르고, 입장이 다르기 때문에 개발을 하기 전과 하고 난 후에 일어날 일의 양에 대한 예측을 하고 공유하는 것이 좋습니다.

현재 HandStack 프로젝트를 기반으로 레퍼런스를 만들어 가는 중입니다. 이에 대한 개발 경험을 공유하기 위해 자료를 수집하고 정리 중입니다. 그래서 개발자들에게 효율적으로 지식을 공유하기 위해 동영상 강의와 문서화를 연계하는 방안을 고려하고 있습니다. 이를 위해 Marp와 OBS Studio의 사용법을 학습 중인데, 조만간 HandStack을 처음 사용하는 개발자들을 대상으로 자료를 공유하겠습니다.

https://github.com/handstack77/handstack

IT 프로젝트 패러다임의 변화

· 약 13분
조준철
HandStack 개발자

은 탄환은 없다. (No Silver Bullet)라는 표현을 아시나요?

이 표현은 소프트웨어 엔지니어링 분야에서 널리 사용되며, 1986년에 튜링상 수상자 프레드 브룩스가 쓴 논문 "No Silver Bullet Essence and Accident in Software Engineering"에서 처음 언급되었습니다.

이는 복잡한 문제를 한 번에 해결할 수 있는 완벽한 해결책(즉, 은 탄환)이 없다는 개념을 나타내는데, 해결해야 할 문제를 두고 자신이 잘 아는 솔루션이나 기술에 대해 은 탄환이라는 고정관념을 버리고 다양한 시각으로 문제에 접근해야 함을 의미합니다.

10년 주기 IT 프로젝트 패러다임의 변화

소프트웨어 공학 관점에서 1980년대 이후 10년 주기로 IT 프로젝트 패러다임의 변화는 다음과 같습니다

  • 1980년대: 제조업 중심의 전사적 품질 관리와 활동 기반 원가 관리에 초점을 맞추었습니다. 업무 프로세스의 지속적인 점진적 향상을 유도하면서, 업무를 담당하는 개인에 의한 투명한 성과 관리를 겨냥했습니다.

  • 1990년대: 비즈니스 프로세스 관리(BPM)의 도입으로 IT를 통해 완전히 업무를 자동화하거나 지원하는 것을 목표로 비용 효율을 추구했습니다.

  • 2000년대: 씬 클라이언트와 클라우드 컴퓨팅의 등장과 함께 IT 패러다임이 크게 변화했습니다. 이 시기에는 PC 중심의 패러다임이 점차 모바일과 클라우드 기반으로 이동했습니다.

  • 2010년대: 스마트폰의 보급으로 인해 PC 중심에서 모바일 중심의 새로운 비즈니스 기회가 창출되었고, ICT 기업들은 컴퓨팅 부문의 혁신을 주도하였습니다.

  • 2020년대: 코로나19 이후 하이브리드 및 멀티 클라우드 기반의 ChatGPT와 같은 LLM 기술의 발전과 보급으로 인해 디지털 전환 시대를 만들어 가는 중입니다.

IT 프로젝트 패러다임의 변화는 기술의 발전, 시장의 변화, 그리고 사용자의 요구에 따라 계속 진화하고 있습니다.

2030년대 IT 프로젝트 패러다임은 어떻게 다가올까요?

개인적으로 프로젝트의 본질적인 목적은 "돈을 벌기 위해서"라고 생각합니다. 그래서 부수적으로 "비효율적인 업무를 자동화" 또는 "개발 또는 운영 업무 비용을 절감"하기 위해 프로젝트가 만들어지고 유지된다고 보는 편입니다.

이러한 관점에서 최근 유행하고 있는 다양한 AI 기술과 로우 코드 기반의 솔루션들이 IT 업계에 얼마나 영향을 주고 있는가를 생각해보면 "도구"로서 개인의 IT 업무에 대한 도움이 되어 가는 것은 분명한데, 이것을 공식적으로 수치화해 보려고 하니 조금 까다롭습니다. 수치화해야 객관화를 할 수 있고, 사업성을 따져봐서 사업계획서나 제안서를 만들 수 있기 때문입니다.

IT 프로젝트 성공을 위한 주요 요소들을 살펴보면 다음과 같습니다.

  1. 인건비: 개발자, 디자이너, 프로젝트 매니저 등 다양한 전문가들의 인건비가 포함됩니다. 특히, 프로젝트의 복잡성과 요구되는 기술 수준과 일정에 따라 인건비가 크게 달라질 수 있습니다.

  2. 기술 스택: 사용되는 기술 스택에 따라 비용이 달라집니다. 예를 들어, 오픈 소스 기술을 사용하면 비용을 절감할 수 있지만, 독점 기술이나 최신 기술을 사용하면 라이센스 비용이나 전문 지식의 필요성으로 인해 비용이 증가할 수 있습니다.

  3. 프로젝트 관리: 프로젝트의 계획, 자원 할당, 위험 관리 등을 포함한 프로젝트 관리 비용도 중요한 부분입니다. 특히 IT 프로젝트의 경우 복잡성을 낮추고 성공률을 높이기 위해 업무를 작은 단위로 잘게 나누어 예측할 수 있는 일정으로 관리하는 전략이 필요합니다.

  4. 품질 보증(QA): 소프트웨어의 신뢰성과 안정성을 보장하기 위한 테스트와 버그 수정 비용이 포함됩니다. 이는 수동 테스트, 자동 테스트 등 다양한 방법론에 따라 달라질 수 있습니다.

  5. 인프라 비용: 하드웨어, 네트워킹, 호스팅 비용 등이 포함됩니다. 특히, 고가용성이나 높은 계산 자원이 필요한 프로젝트의 경우 인프라 비용이 커질 수 있습니다.

  6. 기술 부채: 최적이 아닌 결정을 내린 결과로 발생하는 장기적인 비용입니다. 이는 코드 리팩토링, 팀 교육, 효율적인 개발 방법론 사용 등을 통해 완화할 수 있습니다.

이 외에도 프로젝트의 범위와 복잡성, 개발 방법론, 지리적 위치, 아웃소싱 모델 등 다양한 요인들이 프로젝트의 성공에 영향을 미칩니다. 이러한 배경을 염두에 두고 앞으로의 IT 프로젝트 패러다임 변화의 예상을 해보면 다음과 같습니다.


전문 지식에 대한 비용이 크게 낮아지고 있습니다.

IT 기술들은 2010년대 이후 상향 평준화되어 가는 중이며, ChatGPT와 같은 LLM 기술의 발전과 보급으로 인해 전문 지식에 대한 접근성이 크게 향상되었습니다. 이는 IT 프로젝트를 수행하는 데 필요한 지식과 기술을 습득하는 비용을 크게 낮추었고 개발자들이 새로운 기술을 빠르게 배우고 적용할 수 있게 하여 IT 프로젝트의 효율성과 효과성을 높이는 데 기여하였습니다.

우리나라의 제조업 분야뿐만 아니라 IT, 영화, 음악, 예술, 학술 분야에서도 마찬가지로 저비용으로 다품종 소량생산이 가능한 시대가 오고 있음을 보여주고 있습니다.

일자리에서 일거리의 시대로 이동하고 있습니다.

디지털화와 자동화의 확산으로 인해 IT 업계는 전통적인 '일자리'에서 프로젝트 기반의 '일거리'로 변화하고 있습니다. 이는 개발자들이 특정 회사에 속하는 대신 다양한 프로젝트를 수행하며 경력을 쌓는 방식을 의미합니다. 이러한 변화는 IT 프로젝트의 유연성을 높이고, 개발자들이 다양한 경험을 쌓고 기술을 활용할 기회를 제공합니다.

이러한 변화의 가장 큰 이유는 프로젝트 개발 및 운영 비용은 매우 비싼 편이기 때문입니다. 기본적으로 IT 프로젝트의 개발과 운영은 큰 비용이 필요합니다. 이는 개발자의 시간, 하드웨어와 소프트웨어 자원, 테스트 및 유지보수 비용 등 다양한 요소를 포함합니다. 따라서, IT 프로젝트의 성공은 이러한 비용을 효과적으로 관리하고 최소화하는 데 크게 의존합니다.

특정 기술에 종속적으로 되느냐 아니냐가 중요한 것이 아닌 IT 프로젝트 성공을 위한 주요 요소들에서 필연적으로 발생하는 문제들을 해결하는 경험을 확보해야 합니다.

도구는 도구일 뿐 본질은 희소하며 가치가 필요합니다.

IT 프로젝트에서 사용하는 도구와 기술은 중요하지만, 이들은 결국 도구일 뿐입니다. 프로젝트의 성공은 이러한 도구를 효과적으로 사용하는 능력, 그리고 복잡한 문제를 해결하는 데 필요한 창의성과 전략적 사고 등의 '본질'에 크게 의존합니다. 이러한 본질은 희소하며 가치가 있으며, 이를 키우고 발전시키는 것이 IT 프로젝트의 성공을 위해 중요합니다.

의사결정자 입장에서 중요한 것은 ROI (Return on Investment)입니다. 정리하면 다음과 같습니다.

  • IT 기술들은 2010년대 이후 상향 평준화되었습니다.
  • 전문 지식에 대한 비용이 크게 낮아지고 있습니다.
  • 일자리에서 일거리의 시대로 이동하고 있습니다.
  • IT 분야에 저비용으로 다품종소량생산이 가능한 시대가 오고 있습니다.
  • 향후 IT 프로젝트 패러다임은 비용 최적화에 중점을 두고 있습니다.
  • 기업 고유의 IT 프로젝트 성공을 위한 각 주요 요소에 대해 개선을 고민하는 경험이 필요합니다.

결국 개인적인 판단일 뿐이에요. 위에 언급한 내용 외에도 분명 IT 프로젝트의 성공과 실패는 다양한 요인에 의해 좌우됩니다. 각 프로젝트는 고유한 문제와 목표를 가지고 있으며, 이를 해결하고 달성하는 방법은 프로젝트의 특성, 팀의 역량, 사용할 수 있는 자원 등에 따라 달라집니다. IT 프로젝트의 성공은 개인적인 판단과 수행사의 경험에 크게 의존합니다.

고객 사용자를 위한 IT 프로젝트의 화면/기능에 대한 도움말은 어떻게 만들고 계신가요?

· 약 8분
조준철
HandStack 개발자

IT 프로젝트에서 문서화의 품질은 이해당사자 간의 합의, 즉 프로젝트 관련자들이 문서화의 필요성과 중요성에 대해 동일한 이해를 하고 있는지가 중요합니다.

문서화는 시간과 비용이 많이 소요되는 작업이기 때문인데, 이들이 문서화의 목표와 방향에 대해 합의하면, 문서화의 품질과 정보 공유의 만족도가 좋아질 가능성이 높아집니다.

작성하게 되는 문서 분류는 크게 세 가지 주요 그룹을 대상으로 구성되어 있습니다.

  • 첫 번째 그룹은 고객 사용자들로, 제품이나 서비스에 대한 이해를 돕고, 고객의 요구사항을 충족시키는 데 초점을 맞추고 있습니다. 이러한 문서는 사용자 설명서, FAQ, 제품 사양서 등을 포함할 수 있습니다.
  • 두 번째 그룹은 운영 업무를 담당하는 사람들로, S/W, H/W, N/W 아키텍처, 내부 프로세스, 시스템 구조, 환경설정 문서화 등에 대한 정보를 제공하는 데 중점을 두고 있습니다. 이러한 문서는 운영 업무에 필요한 기술 사양서, 시스템 아키텍처, 프로젝트 관리 문서 등을 포함할 수 있습니다.
  • 세 번째 그룹은 개발 업무를 담당하는 사람들로, 이들에게 제공되는 문서는 주로 소프트웨어 개발, 시스템 아키텍처, 소스코드, 데이터 정보, 배포 관리 등에 대한 정보를 제공하는 데 중점을 두고 있습니다. 이러한 문서는 개발 가이드라인, 코드 문서화, 시스템 아키텍처 문서 등을 포함할 수 있습니다.

제가 주로 풀 스택으로 웹 개발을 하다 보니 웹 분야에 중점을 둔 내용이긴 합니다만, 이 중에서 개발자의 관점으로 첫 번째 그룹인 고객 사용자들을 위한 도움말을 어떻게 저비용으로 고효율을 만들고 유지할 수 있을까? 생각해 보았는데, 그 이유는 고객 사용자들과 직접적인 합의가 어렵기 때문입니다.

대부분은 IT 프로젝트의 문서화에 대한 지침이 없으므로, 먼저 IT 프로젝트에서 특정 화면이나 기능에 대한 도움말 문서를 작성해야 할 때 따라 할 수 있는 주어진 상황에 따라 적용할 수 있는 간단한 기준을 만들어봤습니다.

  • 읽는 대상 요구 파악하기: 누가 이 문서를 사용하게 될지 파악하고, 가능하다면 당사자의 요구를 확인하고 그것에 맞게 문서를 조정하는 것이 지름길입니다.
  • 튜토리얼 또는 레퍼런스를 작성하기: 사용자가 기능을 더 잘 이해하거나 사용하는 데 도움이 될 수 있는 추가 정보와 함께 화면/기능에 대한 사용 방법을 명확하게 설명하는 상세한 단계별 튜토리얼 또는 참조 가이드를 만듭니다.
  • 단순하게 만들기: 대부분은 문서가 길어지면 안 봅니다. 의도적으로 명확한 고객이 이해할 수 있는 전문 용어를 사용하세요. 필요한 경우에만 자세한 설명을 제공하세요.
  • 검색할 수 있게 만들기: 검색하기 쉬운 방식으로 문서를 정리하세요. 기능과 관련된 키워드를 사용하고 관련 주제나 기능에 대한 링크를 제공하세요. 사용자가 필요한 정보를 빠르게 찾을 방법이 필요합니다.
  • 최신 상태로 유지하기: 화면/기능이 추가 되거나 개선함에 따라 문서도 반영되어야 합니다.

문서의 품질은 사용자가 기능을 인식하고 사용하는 방식에 도움을 주기 때문에 시간을 들여 일관성 있고 명확하며 사용자 친화적인 도움말 가이드를 작성하는 것이 좋습니다. 약간의 노력이 필요할 수도 있지만 그만한 가치가 있습니다.

제가 고객 사용자를 위해 작성해 본 정보 형식은 워드나 파워포인트 파일을 PDF로 제공하는 문서 외에 고객 만족도가 좋았던 기능들은 다음과 같습니다.

  • HTML/Markdown 에디터로 만든 내용을 링크
  • 주요 입력 항목에 움직이는 애니메이션 placeholder 제공
  • 화면 내 주요 항목에 툴팁 제공
  • 화면 내 하드 코딩된 도움 문장을 보여주거나 숨기기
  • 화면 내 단계별로 동작하는 가이드 팝업

이 기능들을 위해 사용하는 오픈소스는 다음과 같습니다.

다른 웹, CLI/GUI 응용 프로그램, 기타 IT 프로젝트에서 고객 사용자를 위한 IT 프로젝트의 화면/기능에 대한 도움말은 어떻게 만들고 계시는지 궁금하네요.

오류투성이지만 코드 공유 프로젝트 Qrame을 소개합니다

· 약 6분
조준철
HandStack 개발자

지난 글을 올린지 한달이 되었네요. HandStack 개발 프레임워크를 작년 12월에 Github에 공개한 후 지속적으로 업데이트 하면서 좀 더 접근성이 좋게 만들 필요성을 느껴서 이런게 있으면 좋겠다~ 싶은 아이디어를 오픈 가능한 수준으로 만들기 위해 열심히 만드는 중입니다.

사이드 프로젝트로 진행하다보니 문서화도 안되고, 정리도 안되고, 버그나 예기치 못한 이슈에 대한 대응도 늦지만 중요한 건 하나하나 꾸준히 진행되고 있습니다.

HandStack 프로젝트는 한마디로 클라우드 네이티브 앱 개발 및 관리 SDK 입니다. 특화된 영역의 개발자를 대상으로 하다보니 초기 설정에서 부터 활용하기 까지 접근성이 높지만 이것을 기반으로 그룹웨어, 쇼핑몰 솔루션 개발과 회사 SI 프로젝트에 적용중이고, 지인 개발 회사에서도 도입하고 있는 오픈소스입니다.

그래서 HandStack 을 셀프 호스트로 세팅하지 않고 웹 브라우저로 바로 개발 경험 해 볼수 있는 방안을 고민하다가 HandStack SaaS 서비스 플랫폼이라는 아이디어를 오류투성이지만 코드 공유 프로젝트로 소개합니다.

  • HandStack === 클라우드 네이티브 앱 개발 및 관리 SDK
  • Qrame === HandStack 으로 개발된 SaaS 서비스 플랫폼

Qrame 서비스의 목표는 원래 HandStack 으로 할 수 있는 것을 UI 도구화 하는 것입니다. 여기에서 만들어진 코드는 셀프 호스트에서도 동작합니다. Qrame 서비스의 핵심 가치는 다음과 같습니다.

  • 코드 공유하기
  • 코드 검색하기
  • 코드 연계하기
  • 코드 협업하기
  • 코드 배포하기

이 가치를 기준으로 HandStack 을 이용하여 지속적인 기능 개선을 진행하고 있습니다. 제가 예전에 만든 게시판 예제는 다음에서 확인 할 수 있습니다. 게시판 소스코드에 대한 설명은 여기를 참조하세요.

https://qrame.kr 에 방문하시면 회원가입 없이 이메일로 시작 페이지를 발송하며, 구글 메일로 로그인 할 경우 바로 시작 페이지로 이동하게 됩니다. 처음 로그인하면 이름, 직급, 회사명과 같은 부가정보는 협업할 때 공유되므로 적절하게 입력하시면 됩니다.


한 달간의 여정 (2024-05-22 ~ 2024-06-22)

  • LoadModuleConfig 검증 추가
  • 클라이언트 모듈 설정 지원 추가
  • dark 모드 라이브러리 추가
  • 버그 수정 및 기능 개선
  • HTML 요소의 기본 type을 text로 고정
  • BearerToken 정보가 훼손되거나 확인 할 수 없을 때 문구 추가
  • 템플릿 내용 수정
  • 레이블 기본 마진값 변경
  • 버그 수정 및 기본 스크립트 변경
  • notifier.css 기본 추가
  • notifier 리소스 변경
  • 리소스 로드 기능 개선
  • Http 프록시 헤더 전달 및 로깅 기능 추가
  • Node.js 기반 checkip 서버 추가
  • ip 주소 조회 기능 개선
  • clientip 조회 Uri 개선
  • Referer 처리 기능 개선
  • 불 필요한 코드 삭제
  • 고유 ID 생성 확인 기능 추가
  • 터미널 명령 실행후 성공 종료 코드를 설정하도록 개선
  • base64 url 인코드, 디코드 기능 추가
  • moment 한국어 로케일 추가
  • moment.js 번들 추가
  • 빌드 설정 변경
  • 경로 오류 수정
  • 웹 폰트 적용
  • css bundle 대응 기본 경로 개선
  • 한줄문구 변경
  • bash 스크립트 캐리지 리턴 변경
  • handstack CLI 컴파일시 게시 디렉토리로 복사 추가
  • Forbes 앱 ID 부여 버그 수정
  • 참조 라이브러리 버전 업데이트 대응 문법 수정
  • 처음 실행시 checkup 실행 경로 로그 추가
  • dispose 앱 정리 버그 수정
  • task.bat, task.sh 업무 스크립트 개선
  • 태넌트 앱 > Forbes 앱 명칭 변경
  • 참조 라이브러리 버전 업데이트
  • 거래 로그 기록 개선
  • 로그 파일 기록 기능 및 UI 컨트롤 기능 개선
  • 공통 기능 개선 및 버그 수정
  • 캐시, 로그 경로 개선
  • 공통 기능 개선 및 버그 수정
  • 파일 동기화 대기시간 추가 및 버그 수정
  • AUIGrid 컨트롤 기능 추가
  • AI 메시지 영역 height을 100% 처리
  • prompter 모듈 빌드 추가

시맨틱 커널 기반 prompter 모듈 추가

· 약 24분
조준철
HandStack 개발자

최근 프롬프트 엔지니어링에 대한 관심이 생겨 마이크로소프트의 Semantic Kernel(시맨틱 커널)을 사용해서 HandStack 프로그램에서 생산성에 도움이 될 만한 다양한 문법을 테스트 해보고 있었습니다.

이를 통해 HandStack 프로그램에 적용할 수 있는 방법을 고민해보았고, 이에 대한 경험을 공유하는 게 의미가 있을 것 같아 이 글을 작성하게 되었습니다. 시맨틱 커널로 닷넷 기반 프로그램에 프롬프트 엔지니어링을 도입하는 방법을 고민하시는 분들에게 도움이 되었으면 합니다.

시맨틱 커널은 LLM 기반의 생성형 AI 기능을 프로그램에 적용하기 위한 C#, Java, Python 언어를 지원하는 프레임워크로, 특정 업무에 대한 프롬프트를 사전에 템플릿화 하여 실행하는 데 사용됩니다. 이를 통해 사용자의 요청에 대한 응답을 생성하거나, 또 다른 프롬프트를 실행하는 데 사용됩니다. 아마 Python, Typescript 등의 언어로 개발된 프로그램에서는 LangChain(랭체인)을 많이 사용하실 거라 생각합니다. 간단하게 시맨틱 커널은 C#, 랭체인은 Python 기반의 프로그램에 사용되는 프롬프트 엔지니어링 프레임워크입니다.

C# 기반의 프로그램에서 시맨틱 커널을 사용하는 방법에 대한 정보는 랭체인에 비해 상대적으로 부족한 편입니다. LLM 분야가 워낙 빠르게 발전하고 있는데다, 시맨틱 커널의 릴리즈가 거의 1주일에 한 번씩 이루어지다보니 구글 검색이나 ChatGPT 에 물어보는 정보는 대부분 호환성이 없는 불 필요한 정보들 뿐입니다.

이해가 되는 부분인 것이 LLM 분야는 춘추삼국시대와 같이 오픈 AI GPT, 메타 라마, 구글 제미나이를 중심으로 혼란스러운 시기에 있으면서 학술적으로도 많은 연구가 이루어지고 있습니다. 핵심 기능 자체가 외부 종속성을 기본적으로 가지고 있는 특징을 가지다보니 시맨틱 커널을 사용하는 방법에 대한 최신 정보가 부족한 것이 당연한 것이라 생각합니다.

LLM 분야는 미국에서 정부, 민간 차원에서 하드웨어, 소프트웨어, 학술적으로 주도하고 있기 때문에, 한국에서는 이에 대응하여 더 많은 정보를 얻을 수 있는 특화된 분야의 연구가 이루어지고 있습니다.

시맨틱 커널 시작하기

시맨틱 커널을 사용하기 위해서는 먼저 공식 문서를 참고하는 것이 가장 좋습니다.

LLM 분야가 빠르게 발전하는 중이어서 영어로만 공식 문서를 제공하고 있으니, 문서를 읽는 것이 부담스러우시다면, DeepL를 설치하여 번역을 참고하시면 됩니다.

공식 문서의 내용은 큰 그림이나 개념을 설명하는 데 중점을 두고 있어, C# 개발 언어에 익숙하지 않더라도 LLM 기능을 프로그램에 적용하기 위한 개념을 학습하는데 도움이 됩니다. (랭체인의 문서를 보는데도 도움이 됩니다.)

하지만 실제로 프로그램에 적용하기 위해서는 공식 문서보다도 Github의 예제 코드를 직접 참고하는 것이 더 도움이 됩니다.

시맨틱 커널의 C# 소스 코드는 거의 매일 업데이트 되고 있으며, 이에 대한 예제 또한 같이 업데이트가 되고 있어서 로컬에 git clone을 통해 소스 코드를 다운로드 받아서 사용하는 것이 좋습니다.

# git clone을 통해 소스 코드를 다운로드 받을 수 있습니다.
git clone microsoft/semantic-kernel

# git pull을 통해 최신 소스 코드를 받아올 수 있습니다.
git pull

# samples 해당 디렉토리로 이동하여 예제 코드를 확인할 수 있습니다.
cd \microsoft.semantic-kernel\dotnet\samples

개인적으로 Visual Studio 2022 통합 개발 도구를 설치해서 SK-dotnet.sln 실행하여 소스 코드를 확인하고, 예제를 확인 하는 것이 가장 편리하다고 생각합니다. 그 이유는 다음과 같습니다.

  • 주요 기능에 대한 단위 테스트가 포함되어 있어서, 소스 코드를 수정하거나, 새로운 기능을 추가할 때 테스트를 통해 검증할 수 있습니다.
  • 공식 문서에는 언급되지 않는 추가적인 내용이 많아서, 소스 코드를 확인하는 것이 더 도움이 됩니다.
  • 공식적으로 Open AI, Azure Open AI를 지원하지만 내부적으로 Google, HuggingFace, MistralAI, Onnx 등의 다양한 API를 사용 할 수 있도록 개발되고 있는 것을 알 수 있습니다.
  • 빠르게 변경되는 소스 코드에 대한 안정적인/실험적인 기능을 확인 할 수 있습니다. 실험적인 기능들은 다음 버전에 사라질 수 있으니 사용에 주의해야 합니다.

시맨틱 커널에 대한 문서는 많이 부족하지만, 소스 코드를 통해 확인하면서 이해하는 것이 가장 빠르게 프로그램에 적용하는 방법이라고 마이크로소프트 시맨틱 커널 개발팀이 말하고 있는듯 합니다.

프롬프트 엔지니어링

시맨틱 커널을 학습 하기 전에는 개인적으로 프롬프트를 작성하여 Copilot 이나 ChatGPT 에게 어떻게 하면 효과적인 질문을 할 수 있을지 고민하고 있었습니다.

그러나 개인(사람)이 아닌 프로그램에서 프롬프트를 작성하고, 더 효과적인 질문을 할 수 있게 하는것은 개인보다 더 상호 보완적인 관계를 가지고 있습니다.

프롬프트 엔지니어링은 사용자의 요청에 대한 응답을 생성하는 데 사용되는 기술로, 크게 다음과 같이 분류할 수 있습니다.

  • 사전 정의 프롬프트 템플릿
  • RAG (Retrieval Augmented Generation) 기반 프롬프트
  • Memory (Storage & Indexing) 기반 프롬프트

시맨틱 커널을 학습 하면서 느낀것은 RAG와 Memory는 의도적으로 안정화 되기 전까지 도입하기 힘들겠다는 것이었습니다. 그 이유는 RAG와 Memory는 LLM AI와 VectorDB 핵심 기능에서 주요 변경 사항이 있거나 새로운 기능을 추가할 때 시맨틱 커널에서 영향을 받을 경우 변경 가능성이 높은 기능들이기 때문입니다.

RAG를 지원하기 위해서는 적어도 로컬 또는 원격에서 오피스 문서, PDF 와 같은 파일들을 읽어와 임베딩을 생성하는 기능이 필요하고, Memory를 지원하기 위해서는 VectorDB 기반의 임베딩된 데이터를 인덱싱, 검색 기능이 필요합니다. 이러한 기능들은 시맨틱 커널에서 지원하는 기능이 아니라 별도의 라이브러리를 사용해야 하기 때문에 시맨틱 커널을 사용할 때 당분간은 프롬프트 템플릿을 활용하는 방법에 집중하는 것이 좋다고 생각합니다.

시맨틱 커널 소스에 RAG, Memory 기능을 사용하는 예제 코드가 있지만, 아직 실험적인 기능이 많기 때문에 안정화 되기 전까지는 사용에 주의해야 합니다.

사전 정의 프롬프트 템플릿

사전 정의 프롬프트 템플릿은 미리 정의한 문장에 사용자의 요청을 더해 응답을 생성하는 데 사용되는 기법으로, 특화된 업무에 따라 사용자의 요청에 대한 응답을 생성하는 데 사용됩니다.

예를 들면 "건강을 위해 칼로리 맞춤 요리 추천"을 위해 다음과 같은 프롬프트 템플릿을 사용할 수 있습니다.

너는 맛있는 음식을 쉽게 만들어 먹을 수 있는 레시피를 개발하는 요리 연구가야.
나는 1,800 칼로리 수준에서 맛있는 음식을 만들어 먹고 싶어.
매일 만들어 먹을 수 있는 5가지 초보 요리사를 위한 요리 레시피를 참고해서 제안해줘.

${UserMessage}

여기 ${UserMessage} 부분에 사용자의 질문을 더해 응답을 생성하는 데 사용됩니다. 예를 들어 사용자가 이렇게 질문을 요청합니다.

  • 나는 30대 남자이고 조금 살쪘어 어떤 요리가 좋을까?
  • 다이어트를 하는중인데, 여성을 위한 칼로리가 적은 음식을 추천해줘

어떠한 질문이든 사용자의 질문을 기반으로 맛있고 건강한 성인 남자 기준 하루 권장량인 1,800 칼로리 이내의 요리 레시피를 제안해 줍니다.

프롬프트 텍스트를 작성하는 기법은 다양하게 있습니다만 기본적으로 원칙을 준수하는 게 필요합니다. LLM 을 데이터베이스라고 생각하고 프롬프트 기법을 SQL 문법이라고 생각하는게 좋습니다.

구체적 지시 > 명확한 단어 > 맥락을 제공 > 응답 구조를 정의 > 일관성 유지

예시로 제공된 "건강을 위해 칼로리 맞춤 요리 추천" 텍스트는 제로샷(Zero Shot) 기법이고, 개인적으로 선호하는 방법은 다음과 같습니다.

  • Few Shot: 기본적이고 핵심적인 내용에 대한 예시를 제공하는 방법
  • 역할 지정: AI 모델에 특정한 역할을 부여하는 방법
  • 마크다운 활용: 텍스트를 구조화하여 질문을 생성하는 방법
  • 단락 구분 기법: 요청, 제약, 입력, 출력 등등 단락을 구분하여 질문을 생성하는 방법
  • 변수 활용: 프롬프트를 변수를 활용하여 동적으로 질문을 생성하는 방법
  • Q&A 기법: AI 모델이 질문에 대한 답변을 유도하여 생성하는 방법
  • 응답 형식 지정: 자연어 응답이 아닌 Json, Xml, Csv, Markdown 등등 특정 형식으로 템플릿 기반 응답을 생성하는 방법

구글 검색으로 각각의 키워드에 대해 알아보시면 다양한 정보를 확인할 수 있을겁니다. 다만 프롬프트에 대한 기법은 정답이 없습니다. 동일한 질문에 대해 GPT-3, GPT-4 모델과 매개변수 (TopP, Temperature, PresencePenalty, FrequencyPenalty) 설정에 따라 다른 결과를 생성할 수 있습니다. 이에 대한 것은 본인의 경험을 통해 효과적인 프롬프트를 작성하는 방법을 찾아보시길 권장합니다.

프롬프트 템플릿은 영어로 작성하는 게 더 좋은 결과를 만들어냅니다. 그 이유는 영어의 기본 흐름인 대화의 5형식을 기반으로 학습 데이터들이 제공되었기도 하지만 한국어만의 맛깔스러운(?) 뉘앙스를 영어로 번역하는 데 한계가 있어 다양한 질문을 번역되는 와중에 요청 의도와는 다른 응답을 생성하는 데 사용될 수 있기 때문입니다.

프롬프트 템플릿은 영어로 작성하고 질의는 한국어로 해도 어느정도 만족스러운 결과를 만들어냅니다. 그러나 한국어로 작성한 프롬프트 템플릿은 한국어로 질의하는 경우에만 사용하는 것이 좋습니다.

예제로 만든 프롬프트 템플릿

HandStack 프로그램에서 생산성에 도움이 될 만한 예제로 만든 프롬프트 템플릿은 gpt-3.5-turbo 를 기반으로 작성되었습니다. 프롬프트 템플릿 작성 참고용으로 봐주시면 좋을듯합니다. 여기에 있는 템플릿은 단일 대화 기능입니다.

프롬프트 엔지니어링에서 좀 더 실용적인 기능을 구현하기 위해서는 프롬프트를 실행하기 전에 도메인 데이터를 활용하여 동적으로 Few Shot을 구성하는 것과 이전 대화의 이력을 유지하는 것이 중요합니다. 이에 대한 예제는 다음에 작성하도록 하겠습니다.

prompter 모듈 시작하기

appsettings.json LoadModules 설정에 prompter 추가

dbclient, function 과 같이 이번에 추가된 prompter 모듈은 시맨틱 커널 기반으로 Open AI와 같은 LLM AI 연동 기능을 위해 프롬프트 템플릿 문법을 그대로 사용할 수 있도록 설계되었습니다. 이를 통해 다음과 같은 장점을 가집니다.

  • 클라이언트 요청에 전달되는 값은 프롬프트 템플릿내의 값 치환과 매개 변수로 매핑 둘다 가능합니다.
  • Open AI, Azure Open AI 등등 서비스를 지원합니다.
  • FewShow, History 기능을 지원합니다.
  • 프롬프트 템플릿을 동적으로 구성 가능하도록 설계되었습니다.

prompter 모듈을 활성화하기 위해 ack 서버 프로그램이 있는 디렉토리에 있는 appsettings.json 파일을 열고 LoadModules 설정에 prompter 추가합니다.

{
"AppSettings": {
......
"LoadModules": [
"wwwroot",
"transact",
"dbclient",
"function",
"repository",
"logger",
"checkup",
"prompter" <-- ack 서버 프로그램 실행시 로드할 모듈 추가
],
......
}
}

prompter module.json LLMSource 설정에 OpenAI ApiKey 추가

prompter 모듈내 Open AI을 API를 사용하기 위해 modules/prompter 디렉토리에 있는 module.json 파일을 열고 LoadModules 설정에 prompter 추가합니다.

{
"ModuleConfig": {
......
"LLMSource": [
{
"ApplicationID": "HDS",
"ProjectID": "*",
"DataSourceID": "LLM1",
"LLMProvider": "OpenAI",
"ApiKey": "[sk-proj-API...키]", <-- Open AI에서 발급한 API Key 추가
"ModelID": "gpt-3.5-turbo",
"IsEncryption": "N",
"Comment": "OpenAI 프롬프트 API"
}
]
......
}
}

업무 프로그램에 필요한 프롬프트 템플릿에 대한 분류는 다음과 같이 정리했습니다.

  • Classification (CLS): 사용자의 의도를 분류하고 파악하는 역할을 합니다. 질문이나 요청을 적절한 카테고리로 분류하여 적절한 응답을 생성하는 데 도움을 줍니다.
  • Grounding (GRD): 질문의 맥락을 이해하고, 그에 따라 엔터티를 추론하는 역할을 합니다. 이를 통해 대화가 자연스럽고 일관성 있게 이어질 수 있습니다.
  • Generater (GEN): 새로운 계획, 아이디어, 변환 등을 생성하는 역할을 합니다. 사용자의 요청에 따라 창의적인 아이디어를 제시하거나, 특정 문제에 대한 해결책을 제안하는 데 사용됩니다.
  • Coding (COD): 개발 관련 질문에 대한 예제나 소스 코드를 생성하는 역할을 합니다. 사용자가 요청하는 코드를 작성하거나, 특정 코드에 대한 품질을 올리는 데 사용됩니다.
  • Summarize (SMZ): 회의록, 요약, 대화 주제 등을 생성하는 역할을 합니다. 긴 대화나 문서를 요약하여 핵심 내용을 간략하게 전달하는 데 사용됩니다.
  • Writer (WTR): 보고서, 문서 등을 생성하는 역할을 합니다. 사용자의 요청에 따라 특정 주제에 대한 보고서나 문서를 작성하는 데 사용됩니다.

프롬프트 템플릿은 서로 다른 역할을 가지고 있지만, 함께 작동하여 사용자의 다양한 요청에 대응하고, 효과적인 대화를 위해 필요한 기능들을 제공합니다.

prompter 모듈 데모

prompter에 등록된 XXXXXX.xml 파일은 화면 및 모듈에서 사용됩니다. 다음은 화면에서 prompter 모듈을 사용하는 데모입니다. 화면 소스는 다음과 같습니다.

CLS010: 문장 대화의 의도를 파악

CLS020: IT 시스템 장애 등급 수준을 파악

GRD010: 지정된 주제와 관련된 엔티티를 추출

GEN010: 제로샷 프롬프트 확인

GEN020: 국가 언어 번역기

GEN030: 회의 전 스몰 토크 주제 생성

COD010: 소스 코드 버그 수정 및 개선

COD020: 소스 코드 주석 추가

COD030: 데이터베이스 SQL 생성

SMZ010: 회의록 요약 정리

WTR010: 당신의 명언 또는 인용구

WTR020: 프롬프트 엔지니어링을 위한 한국어 문장 영어 번역


한 주간의 여정 (2024-05-13 ~ 2024-05-22)

  • 프롬프트 템플릿 추가
  • prompter 모듈 추가
  • 버그 수정 및 기능 개선
  • 공통 기능 개선 및 DataSource에 LLM 서비스 정보 추가
  • 문법 개선
  • 오류 처리 개선
  • 처리 되지 않은 오류를 전역 변수에 기록
  • 거래 응답 결과를 DataSet 으로 변환 기능 추가
  • 소스 코드 정리
  • 변수명 변경
  • 함수 설정 값 타입 변경
  • 테스트 기능 개선
  • CSharp, Javascript 함수 테스트 호출 기능 개선
  • 거래 로그 삭제 주기 개선
  • DummyFile 데이터로 transact 응답을 내려줄 수 있는 기능 추가
  • 종속 패키지 버전 업데이트

개발자에게 필요한 툴민의 논증 모델

· 약 7분
조준철
HandStack 개발자

개발자는 코드를 작성하거나 문제를 해결할 때 숙고하며 알고리즘을 구상하는 논리적인 사고에 익숙합니다. 그래서 특정 주제를 가지고 사람들 앞에서 발표하거나 회의에서 자신이 주장하는 내용에 유연한 사고를 해야 하는 상황을 어려워하는 경우가 있습니다.

여기에는 여러 가지 원인이 있겠지만 이때, 툴민의 논증 모델을 활용하면 주장을 더 명확하게 표현하고, 그 주장을 지지하는 증거와 논거를 제시하며, 반론을 예상하고 대응할 수 있습니다.

툴민의 논증 모델은 영국의 철학자인 스티븐 툴민이 개발한 논증법으로, 어려운 내용은 제쳐두고 당장 써먹을 만한 실용적인 논증법을 제시합니다.

핵심은 주장하고자 바의 설득력을 높이려면 단순히 근거를 몇 개 제시하기보다는 자신이 제시한 정당한 이유를 반박하는 반론을 본인이 구상하고 그것을 재반박해서 얻게 된 결론이 설득력을 얻게 된다는 겁니다.

개발자의 숙고하며 논리적인 사고에 익숙한 장점을 활용하여 발표나 회의 전에 주제에 대해 미리 생각해 보고, 툴민의 논증 모델을 활용해 보세요. 그러면 주장을 더 명확하게 표현하고, 그 주장을 지지하는 증거와 논거를 제시하며, 반론을 예상하고 대응할 수 있습니다.

툴민의 논증 모델은 다음과 같이 6개의 구성 요소로 이루어져 있습니다.

  • 주장 (Claim): 주장은 논증의 목표로, 증명하려는 주제나 판단입니다.
  • 증거 (Data/Frame/Evidence): 증거는 주장을 지지하는 사실이나 정보입니다.
  • 논거 (Warrant): 논거는 주장과 증거 사이의 논리적 연결고리입니다.
  • 보강 (Backing): 보강은 논거를 지지하는 추가적인 정보나 설명입니다.
  • 조건 (Qualifier): 조건은 주장의 힘을 약화하거나 한정하는 역할을 합니다.
  • 반론 (Rebuttal): 반론은 주장이나 논거에 대한 예외 사항이나 반대 의견을 제시하는 것입니다.

논증 모델은 크게 기본구조 (4) + 보조구조 (2)로 구성합니다. 기본구조는 (주장, 증거, 논거, 보강)으로 이루어져 있고, 보조구조는 (조건, 반론)으로 이루어져 있고, 상황에 따라 필요한 구성 요소를 추가하거나 수정해서 사용하면 됩니다.

논증의 구성 요소에 대한 주요 흐름을 이렇게 구성하면 좋습니다. & (AND) | (OR) 는 각 구성 요소를 구분하기 위한 구분자입니다.

  1. 주장 (Claim)
  2. 근거 - 증거 (Data/Grounds/Evidence)
  3. 왜냐하면 - 논거 (Warrant) & 때문에 - 보강 (Backing)
  4. 그래서 So (So) | 어쩌면 - 조건 (Qualifier) | 예외로 - 반론 (Rebuttal)
  5. 주장 (Claim)

주요 흐름에 대한 예시를 들면 다음과 같습니다. 본인 성향에 따라 필요한 구성 요소를 추가하거나 수정해 보세요.

  1. 나는 우리 반 학생들이 모두 A 학점을 받을 것이라고 믿는다. "주장 (Claim)"
  2. 왜냐하면 우리 반 학생들은 모두 열심히 공부했기 때문이다. "증거 (Data/Grounds/Evidence)"
  3. 우리 반 학생들은 좋은 시험 성적을 거두었으며, 과제물에서도 좋은 평가를 받았다. "논거 (Warrant)" & 시험성적과 과제물 점수가 높은 학생은 학칙에 따라 좋은 점수를 부여하게 되어 있다. "보강 (Backing)"
  4. 그래서 "So (So)" | 어쩌면 대부분의 학생은 "조건 (Qualifier)" | 따라서 시험에서 부정을 저지르거나 수업시간에 불성실한 태도를 보인 경우가 아니라면, "반론 (Rebuttal)"
  5. A 학점을 받게 될 것이다 "주장 (Claim)"

한두 번만 활용해 보면 동료들에게 더 명확하게 주장하고 설득하는 사람으로 인지되어, 향후 예상하지 못한 돌발 상황에서는 좀 더 생각해 보고 다시 예기할 수 있는 상황을 만들 수 있습니다.


한 주간의 여정 (2024-05-06 ~ 2024-05-10)

  • 프로젝트 빌드에 필요한 시간을 줄이는 MSBuild 옵션 추가
  • 종속 패키지 버전 업데이트
  • 변수명 변경
  • Node.js 함수 테스트 기능 개선
  • 스크립트 로더 기능 개선
  • 공통 리소스 BindingAction (Replace, Append, None) 옵션 추가
  • 배치 스크립트 디렉토리명 변경
  • 디자인 개선
  • LoadOptions 중복 방지를 위해 시스템에서 부여하는 키에 '$' 접두어 사용
  • 거래 실행시 접근 권한 정보를 dbclient, function 모듈에 전달하도록 개선
  • JSON 데이터 쿼리 및 변환 라이브러리 jsonata 추가
  • C# 서버리스 함수 개발 테스트 API Controller 추가
  • Node.js 서버리스 함수 개발 테스트 서버 추가

본인의 칼은 본인이 갈아야 한다

· 약 8분
조준철
HandStack 개발자

살다보면 가끔 내적인 이유든 외적인 이유던지간에 가볍게 또는 진지하게 그냥 막막하거나 무엇이 맞는 것인지, 어떻게 시작해야 할지 도저히 모를 때가 있는 슬럼프가 찾아옵니다.

그럴때 용기와 희망을 주는 의미를 담고 있는 자기관리 명언이나 책들을 보면 머리로는 이해가 되는데 생각보다 내 상황에 도움이 되지 않는 데 그 이유는 대부분 "성공"이라는 목표를 가지고 있기 때문입니다.

성공이라는 목표를 가지고 있으면 그 목표를 달성하지 못했을 때 좌절하게 되고, 그 좌절로 인해 더 막막해지고, 무엇을 해야할지 모르게 힘든 시기를 겪게 되는데, 이를 극복하고 성장하는 과정을 통해 더 강해지고 성숙해질 수 있습니다.

"본인의 칼은 본인이 갈아야 한다" 라는 말은 지인이 제게 자주 하는 말입니다. 성공의 기반이 되는 것은 자신의 노력과 끈기로 경험을 통해 얻는 것들을 말합니다만, 여기에는 좀 더 생각 해볼 만한 철학적인 의미를 가지고 있습니다.

내 경험을 쌓기 어려운 시대

예전에는 "젊어서 고생은 사서한다." 라는 속담이 있을정도로 경험을 쌓기 위해 노력하고 경험을 통해 성장하는 과정을 거쳤지만, 현재는 인터넷과 스마트폰, 결정적으로 AI 기술이 발달하면서 정보를 얻기 쉬워졌습니다. 이 말은 이러한 정보를 통해 얻는 지식은 경험을 통해 얻는 지식보다 덜 가치가 있다는 것일까요? 아니요. 그렇지 않습니다. 사실에 근접한 정보는 가치에 우위가 있을 수 없습니다.

문제는 경험을 쌓기 위해 노력하고 성장하는 과정의 기회가 점점 줄어들고 있다는 것입니다. 학습(지식을 습득)을 한다는 것은 누군가 잘 정리해둔 정보를 받아들이는 것이지만, 경험을 통해 성장한다는 것은 그 정보를 받아들이고, 이를 토대로 자신만의 결과와 지혜를 만들어내는 것입니다. 분명히 아는 것과 전달 하는 영역은 다릅니다.

습관적으로 미디어, 책, 강의 등을 통해 정보를 얻는 것만 한다면 그 정보를 토대로 자신만의 지혜를 만들어내는 것은 뇌과학적으로도 어렵습니다. 사람은 본능적으로 시각 + 청각적인 자극에서 80% 에 가까운 집중력을 보인다고 합니다. 문제는 새로운 자극을 받아들이기 위해 수많은 정보들은 잊혀집니다. 그래서 본인의 칼을 만들어야합니다.

성공이 아닌 성장을 목표로 삼는 것

한번 쯤은 내가 성공했을 때의 모습을 상상해보았을 것입니다. 그리고 그 상상을 통해 당신이 어떤 사람이 되고 싶은지, 어떤 모습을 가지고 싶은지 생각해보았을 것입니다. 그리고 그 모습을 향해 나아가기 위해 노력하고 있을 것입니다.

그런데 성공을 하면 그 이후에는 무엇을 할 것인가요? 성공을 위해 칼을 갈고, 닦고, 쓰고, 다시 갈았는데, 성공을 하고 나면 그 칼은 더 이상 갈 필요가 없어집니다. 그리고 그 칼을 버리고 새로운 칼을 만들어야 할 지 모릅니다.

먹고 사는 것은 기초적인 삶을 위해 기본적으로 필요한 것이지만, 그 이상의 삶을 살기 위해서는 좋아 하는 일, 해야 하는 일, 할 수 있는 일을 찾아내고, 그것을 통해 좀 더 편하게 해낼 수 있는 본인의 칼을 갈아야 하는 과정을 자연스럽게 해야합니다.

나를 만들어가는 것

그런데 제일 어렵고 중요한 것은 칼을 버릴 줄 알아야 하는 것입니다. 칼은 성장을 위한 도구이지 무기가 아닙니다. 그래서 성장에 더 도움이 된다면 더 많은 칼을 만들고 사용할 수 있도록 언제든 본인의 칼을 버릴 수 있어야합니다.

칼을 바꾸거나 버린다는 것은 어떤 이에겐 자신이 그동안 해온 것들을 부정하는 것 같아 더욱 쉽지 않습니다. 그래서 평생 한 직장에서 근무한 직장인이나 스포츠 선수들이 전성기를 지나 은퇴 이후에는 무엇을 할지 고민하는 것은 당연한 일입니다.

칼을 버린다는 것은 당신이 성공하지 못했다는 것이 아닙니다. 오히려 칼을 무기로 생각한다면 내가 나의 칼로 다칠 수도 있다는 것입니다.

사람들은 나의 칼을 보고 신기해 하거나 부러워 할 수 있어도 그것만으로 알아주거나 인정하지 않습니다. 오히려 크기에 상관없이 그 사람만이 할 수 있는 결과나 능력 또는 고민하지 않고 믿고 맡길 수 있는 신뢰를 쌓아야합니다.

증명하거나 설득할 필요없이 작더라도 하나씩 하나씩 자신만의 더 나은 내일을 만들기 위해 노력하는 당신은 이미 성공한 사람입니다.


한 주간의 여정 (2024-04-29 ~ 2024-05-03)

  • 환경설정 자동화 기능 개선
  • 배치 스크립트 호출 후 로그 출력을 콘솔, 파일로 출력하는 기능 추가
  • 운영체제에 따라 사전에 정의된 배치 스크립트 업무를 수행 기능 추가

알아두면 써먹을 게 많은 프롬프트 엔지니어링

· 약 9분
조준철
HandStack 개발자

작년부터 개발을 하면서 ChatGPT 도움을 많이 받다 보니 프롬프트 엔지니어링에 대한 관심이 생겨 최근에 마이크로소프트의 Semantic Kernel을 사용해서 HandStack 프로그램에서 생산성에 도움이 될 만한 다양한 문법을 테스트 해보고 있습니다.

몇 년 전에 머신러닝을 기초 레벨에서부터 학습을 해본 적이 있습니다. 회귀, 분류, 군집, 예측, 추천 기능을 활용해서 업무 프로그램에 적용해야 하는 미션을 부여받아 진행했는데, 그 당시 고생한 거에 비하면 의미 있는 성과를 내지는 못했습니다.

머신러닝은 기본적으로 적용하려는 수학적 알고리즘에 의한 매개변수 값에 따라 의도한 결과가 달라지다 보니 만족할 만한 학습 모델을 만들기 까지 반복되는 살짝 지겨운 (?) 학습 과정을 많이 거쳐야 하는데, 이렇게 만들어진 학습 모델을 운영 서비스에 적용해서 클라이언트에서 확인하기 위한 자동화된 MLOps 프로세스와 그에 필요한 인력이 필요합니다. 지금에서 생각해보니 크게 2개의 이슈가 있었네요.

  1. 업무 시나리오에 따라 필요한 학습 데이터의 수량이 부족하거나 불균형하게 되어 있으면 학습 모델의 성능이 떨어지게 되어 실제 운영 환경에서는 예측한 결과가 실제 결과와 다르게 나타나는 경우가 종종 발생합니다. 학습 모델은 학습 시점의 과거 데이터를 기반으로 하기 때문에 정기적으로 최신 데이터를 추가한 학습 데이터의 재학습이 필요하게 되는데 이 부분을 얼마나 자동화 할 수 있는지가 중요합니다.

  2. 그렇게 고생하며 얻은 지식이 1년도 안 되어 Auto ML로 불리는 학습 데이터의 크기와 그에 적절한 학습 시간만 넣으면 알아서 최적의 수학 알고리즘과 매개변수의 재학습을 통해 결과로 만들어주는 솔루션이 나왔습니다. Auto ML의 학습 모델 성능이 좋다는 것을 보고 그 당시에 AI의 발전 속도가 개인이 기초 분야에서 학습하는 속도보다 빠르다는 것에 놀랐습니다.

그동안 딥러닝 기반의 AI로 음성인식, 영상 객체 인식, 자율주행, 상담원 챗봇 등 사람이 하는 업무 보조 역할을 대체하는 기술들로 발전하고 일반사람들이 쉽게 접근하지 못하는 스며드는 방식으로 도입이 되었었다고 한다면, 최근에는 다양한 좋은 품질의 학습 모델을 내려받거나 API로 호출할 수 있는 서비스를 제공하는 허깅페이스(https://huggingface.co) 를 보며 이전보다 초기 접근성이 좋아졌다는 것을 새삼 느꼈습니다.

그 중에서 LLM(Large Language Model)은 기존의 AI와는 다르게 상상할 수 없는 대규모의 데이터를 학습하여 텍스트 생성, 번역, 요약 등 다양한 언어 처리 작업을 수행하는 데 사용됩니다. 큰 변화의 핵심은 수요자가 필요한 업무에 따라 활용 용도에 따라 학습 곡선의 선택지가 생겼다는 것인데, 접근성이 좋아진 만큼 더 많은 사람이 쉽게 AI 기술을 활용하고 있습니다.

예를 들어 최근 Meta에서 ChatGPT 4 와 유사한 성능을 보여줄 것으로 보이는 Llama3 학습 모델을 오픈소스로 공개했습니다. 당연히 영어로 학습된 모델을 발 빠르게 야놀자에서 한국어로 파인 튜닝해서 공개를 해주었고, 이제 AVX2 명령어를 지원하는 최신 CPU를 탑재하고 NVIDIA의 RTX 3060+ 또는 AMD 의 RX 7800+ 그래픽 카드를 가지고 있는 개인 PC에서도 파이썬이나 랭체인 같은 기술을 모르더라도 LM Studio (https://lmstudio.ai) 와 같은 도구를 활용하거나 랭서브(https://www.langchain.com/langserve) 를 이용해서 셀프 호스트로 ChatGPT 서비스를 실행할 수 있습니다.

Open AI에서 제공하는 ChatGPT API를 사용하려면 유료 API 키를 발급받아야 하는데, 셀프 호스트로 동일한 품질의 서비스를 운영하고 ChatGPT 질문과 결과값을 벡터 값으로 임베딩하여 저장하고 검색할 수 있는 벡터 DB들을 사용 가능하면 기업에서는 물론 개인이나 학생들도 쉽게 AI 기술을 활용할 수 있을 것입니다.

그런 의미에서 학생, 직장인에 상관없이 누구나 프롬프트에 필요한 문법을 정리하고 이를 활용해서 ChatGPT를 사용하는 방법을 알아두면 앞으로 써먹을 게 많을 거로 보여집니다.

문법을 학습하기 위한 참고 웹 사이트로 랭스미스 (https://smith.langchain.com/hub) 를 추천드립니다. 예를 들어 데이터베이스 쿼리를 생성하기 위한 프롬프트에 대한 예로 https://smith.langchain.com/hub/rlm/text-to-sql/playground 를 참고하시면 괜찮을 것 같네요. 굳이 Open AI의 유로 API 키가 없더라도 여기에 있는 문법을 ChatGPT에 그대로 적용해도 됩니다.

영어로 되어 있지만 DeepL로 번역해서 얻은 프롬프트를 ChatGPT에 붙여서 사용해 보면 확실히 기존보다 좀 더 나은 답변을 얻으실 수 있으실 겁니다.

랭스미스와 유사한 방식으로 기업 또는 개인이 프롬프트에 대한 문법을 정리하고 이를 테스트 하기 위한 셀프 호스트 가능한 오픈소스로 랭퓨즈 (https://github.com/langfuse/langfuse) 를 추천드립니다.


한 주간의 여정 (2024-04-22 ~ 2024-04-26)

  • arm64 빌드 ack 프로그램 삭제
  • Http 응답 상태 코드 표준화 정리
  • 환경변수 비밀키 로드 및 조회 기능 개선
  • 환경변수, 포함 리소스 조회 기능 개선
  • 배포 스크립트 개선
  • HandStack 개발 환경 설치가 완료 후 실행 방법 개선
  • checkup.sln 솔루션 파일 삭제
  • C# 함수 반환 결과가 Task 일 경우 대응 수정
  • WordWrap 확장 메서드 추가
  • Semantic Kernel 기본 패키지 추가
  • CLI list 에 명령 인수가 출력되도록 개선