본문으로 건너뛰기

[사내AX] AI 도구가 늘어나니 사례글 쓰기가 어려워졌다 — 대화를 전부 모아오는 스킬로 업그레이드한 후기 - 2탄

닿

2026.01.26

📝 한줄 요약

AI 코딩 도구를 3개(클로드코드, 안티그래비티, 오픈코드 등)나 쓰게 되면서 대화 기록이 흩어졌다. 사례글을 쓰려면 모든 대화가 필요했기에, 5개 도구의 세션을 한 번에 모아오는 스킬로 업그레이드했다.

🎯 이런 분들께 도움돼요

  • 여러 AI 코딩 도구를 번갈아 쓰면서 작업 기록이 분산되는 게 불편한 분

  • 사례글을 써야 하는데 막막한 분 -> 사례글 작성 스킬!

🧭 작업 순서 (요약)

  1. Antigravity 설계: 멀티 도구 세션을 통합하는 구조 설계 + 구현 계획 작성

  2. OpenCode 전수 조사: 5개 도구의 세션 저장 위치/형식 파악 (웹 검색 + 로컬 확인)

  3. OpenCode 구현: 스킬에 멀티 도구 파싱 규칙과 프로젝트 단위 통합 규칙 추가, Antigravity는 내부 검색/외부 파싱 경로 분리

  4. skill-creator 적용: 모놀리식 파일을 SKILL.md + references로 분리해 컨텍스트 효율 개선

😫 문제 상황 (Before)

이전에 write-post라는 스킬을 만들었다. Claude Code에서 작업한 대화 세션을 자동으로 파싱해서 개발 로그(DEVLOG)를 만들고, 그 로그를 바탕으로 비개발자 대상 사례 게시글까지 써주는 스킬이었다.

지난 사례글 먼저 보기

문제는, 점점 Claude Code 하나만 쓰지 않게 됐다는 것이다.

OpenCode도 쓰고, Antigravity도 쓰고 — 하나의 프로젝트를 여러 도구로 번갈아 작업하다 보니, 대화 기록이 세 곳에 흩어졌다. 사례글을 쓰려면 내가 뭘 시켰고 AI가 뭘 했는지 전체 맥락이 필요한데, 그 기록이 도구마다 따로 저장되어 있으니 하나의 DEVLOG로 뽑아낼 수가 없었다.

기존 스킬은 Claude Code 세션만 읽을 수 있었다. 매번 스킬을 2번씩 나눠 쓰는 것도 비효율적이었고, 도구가 늘어날수록 이 문제는 더 심해질 게 뻔했다.

🛠️ 사용한 도구

  • Antigravity: 범용화 아키텍처 설계, 구현 계획 수립

  • OpenCode: 멀티 도구 지원 계획 수립 + 구현 + 구조 개선

  • Claude Code: 이전 버전 (1탄) 개발에 사용


🔧 작업 과정

🧭 먼저 Antigravity에게 설계를 맡겼다

여러 도구의 세션을 모아오려면 아키텍처부터 짜야 했다. 각 도구가 저장하는 형식이 전부 다를 텐데, 이걸 어떻게 통합할지부터 결정해야 했다.

자동 Devlog 생성기 (Auto Devlog Generator)를 설계해줘

Antigravity가 "Agent-Agnostic Context Extraction"이라는 이름의 아키텍처를 설계했다. 핵심은 환경을 자동 감지하고, 도구별로 다른 추출기를 돌리는 구조였다. 구현 계획서까지 아티팩트로 뽑아줬다.

설계는 Antigravity에게, 구현은 OpenCode에게 — 이렇게 역할을 나누니 효율적이었다.


🗂️ 5개 도구의 세션 저장 위치를 전수 조사했다

구현에 앞서 OpenCode에게 각 AI 코딩 도구가 대화 세션을 어디에, 어떤 형식으로 저장하는지 조사를 시켰다.

에이전트별 대화 세션 저장 위치를 파악해서, 사례 게시글 쓰는 스킬이 한 번에 모든 대화를 가져오도록 업데이트하고 싶어

OpenCode가 웹 검색과 로컬 파일 확인을 교차 검증하면서 5개 도구의 세션 구조를 전부 파악했다:

  • Claude Code: JSONL 파일 (프로젝트 경로를 폴더명으로 인코딩)

  • OpenCode: JSON 3단계 구조 (세션 → 메시지 → 파트)

  • Codex CLI: 날짜별 폴더에 JSONL

  • Gemini CLI: 프로젝트 해시 디렉토리에 JSON

  • Antigravity: 마크다운 아티팩트 + 암호화된 Protobuf

도구마다 저장 형식이 전부 달랐다. JSONL, JSON, 마크다운, 심지어 암호화된 바이너리까지. 이걸 하나의 스킬로 통합해야 했다.

한국어 페이지 스크린샷

🔒 암호화 벽에 부딪혔다 — 그리고 우회했다

가장 까다로웠던 건 Antigravity였다. 대화 원문이 담긴 .pb 파일이 Google 암호화 키 없이는 읽을 수 없었다.

OpenCode가 이 한계를 스스로 파악하고 대안을 제시했다 — Antigravity는 작업하면서 brain/ 폴더에 요약 문서(마크다운 아티팩트)를 자동으로 남기는데, 이걸 "대화 세션의 대리물"로 활용하자는 것이었다.

여기서 한 단계 더 나갔다. 추가 조사를 해보니, Antigravity Power User Guide에서 흥미로운 사실을 발견했다 — Antigravity 에이전트는 내부적으로 과거 대화를 검색하는 기능이 있었다. "지난주에 작업한 내용 찾아줘"라고 하면 이전 세션을 직접 참조할 수 있는 것이다.

결국 두 가지 경로를 모두 스킬에 반영했다:

  • Antigravity 내부에서 스킬 실행: 에이전트 자체 검색으로 과거 대화 직접 참조 (암호화 파일 포함)

  • 다른 도구에서 Antigravity 세션 파싱: brain/ 마크다운 아티팩트만 활용


🧩 skill-creator 스킬로 구조를 개선했다

멀티 도구 지원을 추가하다 보니 스킬 파일이 390줄이 넘어갔다. AI가 이걸 한 번에 읽고 이해해야 하는데, 너무 길어지면 컨텍스트 효율이 떨어진다.

이때 skill-creator라는 다른 스킬을 활용했다. 스킬을 잘 만드는 방법을 알려주는 스킬인데, 여기서 "Progressive Disclosure" 패턴을 적용했다 — 핵심 워크플로우만 담은 메인 파일(SKILL.md)과 필요할 때만 참조하는 보조 파일(references/)로 분리하는 구조다.

skill-creator 스킬의 가이드라인을 적용하여 write-post 스킬을 구조적으로 개선해줘

392줄짜리 단일 파일이 SKILL.md(250줄) + references/case-study-template.md(140줄)로 깔끔하게 분리됐다. 스킬이 스킬을 개선하는 순간이었다.


✅ 결과 (After)

📊 Before vs After

항목

Before

After

지원 도구

Claude Code 1개

5개 (Claude Code, OpenCode, Codex CLI, Gemini CLI, Antigravity)

세션 수집

단일 도구만 파싱

프로젝트 단위로 모든 도구의 세션 자동 스캔 + 통합

스킬 구조

390줄 단일 파일

SKILL.md(250줄) + references(140줄) Progressive Disclosure

Antigravity 대화

읽기 불가 (암호화)

내부 실행 시 자체 검색 가능 / 외부에서는 brain/ 아티팩트 활용

📎 결과물

  • GitHub 리포지토리: https://github.com/daht-mad/write-post

  • Mac/Windows 원클릭 설치 스크립트 (5개 도구 선택 설치)

  • 프로젝트 단위 멀티 도구 세션 스캔 + 통합 DEVLOG 생성

여기서 중요!

  • 어떤 도구에서 사례글을 쓰게 되더라도 각 환경에서 해당 스킬을 "스킬"로 인식할 수 있어야 했다

  • 그래서 각 도구별 스킬이 저장되어야 하는 위치를 지정해주고, 각 경로에 스킬 폴더가 복제되게끔 했다

한국어 텍스트가 있는 페이지의 스크린샷

💬 이 과정에서 배운 점

✅ 효과적이었던 것

  1. 도구별 역할 분담: 설계는 Antigravity, 조사+구현은 OpenCode — 각 도구의 강점을 살려 분업하니 효율이 올랐다

  2. AI에게 조사를 시키면 깊이 파준다: 5개 도구의 세션 구조, 암호화 여부, 우회 방법까지 웹 검색과 로컬 탐색을 교차 검증하며 찾아냈다

  3. 스킬이 스킬을 개선하는 구조: skill-creator 스킬의 가이드라인을 write-post 스킬에 적용해 구조를 개선한 경험

🚀 앞으로의 계획

  • 팀원들에게 배포해서 실제 AX 사례글 작성에 활용하게 하고, 피드백을 받아 개선할 예정

  • 현재 실사용한 도구는 Claude Code + OpenCode + Antigravity 3개이므로, 나머지 2개(Codex CLI, Gemini CLI)도 실제 테스트 진행 예정

24

함께 이야기해요 24

로그인하고 댓글을 남겨 주세요

정옥선 프로필 이미지
정옥선2026.02.01

너무 좋아요~~ 윈도우용 부탁드려요~🙏💕

닿 프로필 이미지
닿2026.02.03

윈도우도 사용 가능해요! 이미 있어요!

김길호 프로필 이미지
김길호2026.01.31

그전 write-post가 저절로 업글되는 건 아니죠?

닿 프로필 이미지
닿2026.02.03

다시 설치하면 업데이트 자동 되어요!~

김길호 프로필 이미지
김길호2026.01.31

이갓 쓰려면 write-post 지워야하니요? 두개가 충돌할까요? 근데 설치한 스킬은 어떻게 지워요?

oneshot 프로필 이미지
oneshot2026.01.31

사례글 쓰는 법 특강 부탁해요

AI 잘 쓰지도 못하는 주제에 자꾸 외주를 주다보니 이제는 생각조차 하기 싫어졌어요

김태현 프로필 이미지
김태현2026.01.30

실제 사례를 써 보면서 느낀 점은 흥미로운 지점이 자꾸 생략되는 것 같더라구요. 그런데 사실 그런 부분을 알아서 잘 해주는 것도 불가능에 가깝다 싶기도 합니다.

닿 프로필 이미지
닿2026.01.30

그걸 좀 개선해보려고요!! 사실 흥미롭다기 보다는 좀 더 읽는 사람으로 하여금 배울 수 있는 지점들을 잘 도출하게끔 하려고 했어요. 이번에 누리님 사례 읽으면서 깃헙 액션이나 cloudflare 등 핵심 개념들이 중간중간 코드블럭으로 설명 삽입되면 좋겠다고 생각했어요.

태현님이 말씀하시는 '흥미로운 지점'의 예시가 어떻게 될까요?

김태현 프로필 이미지
김태현2026.01.30

@닿

누리님이 Kick 이라고 부르는 것, 사람들이 댓글 달때 우와 이거 신박해요 하는 것인데, 이걸 AI가 미리 파악하는게 쉽지 않아 보이긴해요.

예를 또 들면, Linear 데이터를 로컬 캐시에서 가져온것 정말 대박이잖아요.

뭔가 전통적인 방식과 직관을 벗어나는 하지만 더 효율적인 / 효과적인 접근 방법? 이 흥미로운 지점이지 싶습니다.

닿 프로필 이미지
닿2026.01.30

@김태현

요런 걸 기가막히게 잘 뽑아낼 수 있도록 한 번 머리싸매봐볼게요! 피드백 감사합니다 🙂

한바둑 프로필 이미지
한바둑2026.01.27

와, 이거 진짜 공감되는 문제를 멋지게 해결하셨네요! 👏

저도 여러 AI 도구를 번갈아 쓰다 보면 "내가 뭘 시켰더라?" 하고 기억이 흩어지는 경험이 있었는데, 그걸 스킬로 자동화해버리셨다니 대단합니다.

특히 인상 깊었던 부분:

  1. "설계는 Antigravity, 구현은 OpenCode" - 도구별 강점을 살린 분업이 정말 스마트해요. AI도 적재적소에 배치하면 시너지가 나는군요.

  2. 암호화 벽을 만났을 때 "우회 경로"를 찾은 과정 - 막히면 포기하기 쉬운데, brain/ 폴더 아티팩트를 대리물로 활용한 발상이 👍

  3. "스킬이 스킬을 개선하는 구조" - skill-creator로 write-post를 리팩토링한 건 정말 메타적이고 재밌네요 ㅋㅋ

GitHub 리포지토리 바로 북마크했습니다. 저도 사례글 쓸 때 활용해볼게요!

팀원분들 피드백 반영된 다음 버전도 기대됩니다 🙌

SOPA 프로필 이미지
SOPA2026.01.27

오 잘쓰겠습니다~!

닿 프로필 이미지
닿2026.01.28

윈도우는 각 폴더 위치가 또 다 달라서 다시 얼른? 업데이트 해드릴게요 ㅋㅋㅋㅋㅋ 윈도우 버전 테스트를 못해봐서리.. ㅋㅋㅋ

진여진 프로필 이미지
진여진2026.01.27

언제 Oh-my-opencode 영역까지 진입하셨대요...?

무섭습니다 이젠..

닿 프로필 이미지
닿2026.01.27

어제 오늘 열심히 씨름 중입니다 ㅋㅋㅋㅋㅋ 교감 중.....

김태현 프로필 이미지
김태현2026.01.27

잘 쓰겠습니다!

닿 프로필 이미지
닿2026.01.27

방금 하나 추가했어요! 상단에 "바쁘시면 이거만 읽어도 돼요" 섹션 추가 ㅋㅋㅋㅋ 새로 설치하심이..(죄송)

행복한공유 프로필 이미지
행복한공유2026.01.26

오오!! 역시 문제를 해결하는게 제일이네요!!

박카스 프로필 이미지
박카스2026.01.26

우와..! 얼른 스터디원분들께 소개드려야겠네요. 귀차니즘때문에 사장될수있는 많은 꿀팁과 시행착오들이 잘 공유되겠네요. 감사합니다(__)

닿 프로필 이미지
닿2026.01.27

어떤 도구도 무섭지 않다!! 이거 만들면서 덕분에 각각 스킬이 어디에 저장되어야 발동하는지, 대화 세션은 어디에 저장되는지 알게됨... 강제 공부쓰..ㅋㅋㅋ

윤누리 프로필 이미지
윤누리2026.01.26

딱 오늘 불편하다... 하고 생각하던 부분이었는데 이렇게 바로 해결해주시다니 그저 빛 닿님

닿 프로필 이미지
닿2026.01.26

바로 써주셔서 감사합니다 꾸벅 ㅎㅎㅎ

물결2 프로필 이미지
물결22026.01.26

어우 사례글 이제 쏟아질 일만 남았네요?!

닿 프로필 이미지
닿2026.01.26

내친김에 2개 씀요 ㅋㅋㅋㅋㅋㅋㅋㅋ 진짜 이제 어디서 작업해도 세션관리 되니까 넘 좋아요... 세션관리 툴도 하나 만들어야지

필요한 AI 정보만
메일함에 쏙쏙 넣어드려요.

지금 핫한 AI 소식부터 직접 해 본 사례까지, 월요일마다 무료로 받아보세요

우리 회사에도 이런 자동화를 도입하고 싶다면

회사 업무에 맞춘 AI 교육을 함께 설계해요.

기업교육 문의하기

함께 읽어보세요

AX 현장 전체 보기