neozest : neo+zest

회사 동료와 이런저런 아이디어를 나누다가 하드웨어 가젯을 만들어 보는 주제가 나왔다. 오랜만에 임베디드. 쿵짝쿵짝하다가 재미삼아 만지작거려 보자고 의기투합하게 되었다. 그 친구는 라즈베리 파이를 구입했는데, 나는 라즈베리파이나 아두이노, 마이크로비트를 다뤄본 적이 있는지라 그냥 ESP32 호환 보드를 구입해서 가지고 놀아야겠다는 생각을 했다.

오랜만에 ESP32 개발 보드를 구입하려고 검색해 보았는데, 정말 저렴하다. 대충 3천원대가 있는 반면 내가 고른 것은 IdeaSpark라는 브랜드로 와이파이와 BLE가 지원되는, 0.96인치 조그마한 OLED 화면을 장착한 개발보드로 13000원에 TEMU에서 구매했다. 배송까지는 대략 1주일 걸린 것 같다.

 다음과 같이 생겼고, 사양은 아래와 같다.

먼저 데이터통신이 되는 케이블을 찾아서 연결한 다음, 아두이노 IDE를 설치했다.

요즘은 임베디드도 VS Code에서 개발할 수 있는 것같은데, 오랜만에 하는 것이라 정석대로 아두이노 IDE부터 가지고 놀아보기로 했다. VS Code를 주목한 것은 당연히 AI Code Assistant 기능을 이용할 수 있기 때문이다.

Arduino IDE의 Preference 메뉴에서 추가 보드 정보에 다음 URL을 추가한다.

https://dl.espressif.com/dl/package_esp32_index.json

그런 다음 ESP32 보드를 설치해 준다.

또한 보드와 PC 연결을 위하여 CH340 드라이버를 설치했다. 설치하고 나니 COM5로 연결된다.

이제 아두이노 IDE에서 ESP 32 Dev Module을 보드로 선택하고 COM5를 포트로 설정했다.

그런 다음 몇가지 부가 라이브러리를 설치했다.

OLED 표시를 위하여 ESP8266 and ESP32 OLED driver for SSD1306 displays 라이브러리를 설치했다. 또한 u8g2, Adafruit GFX, Adafuit SSD 1306, TimeLib을 설치했다.

예제 파일로 제공되는 코드에서 Time Clock을 선택한 다음, display 와이어링 옵션을 다음과 같이 변경해 주었다.

// 기존: SSD1306Wire display(0x3c, SDA, SCL);   
SSD1306Wire display(0x3c, 21, 22);

이제 컴파일한 후 보드에 업로드해본다. 정상 동작 확인 완료. 이제 개발환경 설정은 끝났고, 아이디어를 구현해 보자.

이번달부터 회사 개발자 직군에게 코파일럿에 이어 커서도 지원하기로 결정했다. 이로써 우리 회사 개발자들은 Copilot, Cursor, Q Developer를 사용할 수 있다. 물론 나처럼 Cline + Gemini Pro 2.5/MS Azure OpenAI를 사용하는 경우도 있다.

이왕 지원하기로 했으니, 그동안의 경험을 바탕으로 나름 체득한 더 잘 사용할 방법을 정리해 보자.

다른 AI도구를 사용하여 명확하고 상세한 계획을 작성한다.

ChatGPT나 Claude를 사용하여 무엇을 만들고 싶은지에 대한 질의응답과정을 주고 받는다. 이 과정에서 명확한 지시문을 만드는 것이 좋다. 완성된 버전을 얻게 되면 이 내용을 마크다운 파일로 내려 받아서 코딩 지원 AI에게 전달한다. 한 번에 모든 문제를 해결하기 보다는 단계별 분업을 지시하는 것이 코딩 AI의 오류를 줄일 수 있다.

AI가 전체적으로 지켜야할 규칙을 설정한다.

예를 들어 “테스트 코드를 작성한 후 기능을 구현하고, 테스트가 통과할 때까지 반복한다. 나는 깔끔한 코드를 좋아한다” 등이 될 수 있다. 커서의 경우.cursorfules 파일에 명시한다. 다른 도구들을 사용할 경우 사용자 정의 프롬프트에 넣는다. 자신이 좋아하는 아키텍트나 기준이 있으면 명시적으로 지시한다. 다른 사람들이 만들어둔 규칙 파일도 잘 활용하자. https://github.com/PatrickJS/awesome-cursorrules 에 가면 많이 볼 수 있다.

명령이 아니라 생각의 흐름을 프롬프트에 담아 선언적으로 기술한다.

프롬프트도 일종의 코드이다. 다만 AI 코딩 보조 도구를 사용할 때 명령형이 아닌 선언형으로 인식하고 프롬프트를 작성해야 한다.

개발자로서 나의 의도와 생각의 흐름을 AI에게 설명해 줘야 한다. 

AI가 코드를 잘 작성하든 그렇지 않든, 그냥 똘똘한 주니어 사회 초년생에게 지시한다고 생각하고 작성하자.

자주 사용하는 프롬프트는 계속 저장/유지보수해 나가자.

시스템 프롬프트로  공통 요구사항(명확하고 간결한 답변 제시, 대안을 항상 제시, 불필요한 설명 방지(요금 줄이기), 기술적 디테일 우선시) 등을 적용한다.

다른 사람이 작성한 코드도 잘 읽어보자. 이를 정리한 사이트인 https://context7.com/나 https://cursor.directory/ 도 참고하자.

깃으로 코드를 관리하면서 조금씩 점진적으로 코드를 작성한다.

AI가 어디로 튈지 모른다. 튀는 걸 막는 것이 문제라기 보다는 튀기 전의 상태로 복귀시키기가 어려운 것이 문제다.

깃으로 조금씩 변경하고, 항상 테스트 코드를 작성한다. 에이전트일 경우 무조건 이 테스트를 통과하도록 작성하라고 지시한다. 그러면 실패했을 경우 AI가 원인을 분석한 다음 수정한다. 

일단 동작하는 코드를 얻었다면 항상 AI가 작성한 코드를 검토한 다음 커밋한다.

AI가 튀었다면 이전 대화기록을 요약해서 다시 대화를 시작하는게 낫다.

이가 없으면 잇몸으로라도....수동 A2A를 이용하자.

A2A가 있지만 아직은 우리가 사용하는 에이전트들끼리 상호 작용을 하지 못한다. 그럼 어떡할 것인가. 수동으로라도 해줘야지.

문제가 발생하면 여러 도구를 사용하자. 문제 원인과 코드를 ChatGPT나 Claude에게 물어보자. 어떻게 고쳐야 하니 물어보면 답해주는 경우가 많다. 물어보는 것도 귀찮으니 커서에게 문제와 관련된 파일 목록, 기능, 문제점을 하나의 보고서로 요약하게 만들자. 이 파일을 다른 AI에게 던져주고 답을 얻는다.

알짜정보만 AI에게 제공하자.

맥락 정보가 길면 길수록 AI가 작업을 잘 이해한다. 파일을 참조할 때에는 @를 사용하고, 쓸데없는 중간 파일은 .cursorignore 파일에 정의하여 제외시킨다. 맥락을 유지하면서 계속 일을 잘 할 수 있는게 중요하다. 이 부분에서는 AI로 만화를 그리는 분들은 어떻게 활용하는지 잘 살펴볼 필요가 있다. 일관되게 해당 작업을 개선하는 것은 AI가 의외로 잘하지 못한다.

결국 적고보니 한마디로 정리된다.

"개발 프로세스에서 코드 작성이라는 영역은 AI에게 맡기더라도 개발자들은 설계와 구조에 좀 더 집중해야 한다."