📝 한줄 요약
AI 코딩 도구를 3개(클로드코드, 안티그래비티, 오픈코드 등)나 쓰게 되면서 대화 기록이 흩어졌다. 사례글을 쓰려면 모든 대화가 필요했기에, 5개 도구의 세션을 한 번에 모아오는 스킬로 업그레이드했다.
🎯 이런 분들께 도움돼요
여러 AI 코딩 도구를 번갈아 쓰면서 작업 기록이 분산되는 게 불편한 분
사례글을 써야 하는데 막막한 분 -> 사례글 작성 스킬!
🧭 작업 순서 (요약)
Antigravity 설계: 멀티 도구 세션을 통합하는 구조 설계 + 구현 계획 작성
OpenCode 전수 조사: 5개 도구의 세션 저장 위치/형식 파악 (웹 검색 + 로컬 확인)
OpenCode 구현: 스킬에 멀티 도구 파싱 규칙과 프로젝트 단위 통합 규칙 추가, Antigravity는 내부 검색/외부 파싱 경로 분리
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 생성
여기서 중요!
어떤 도구에서 사례글을 쓰게 되더라도 각 환경에서 해당 스킬을 "스킬"로 인식할 수 있어야 했다
그래서 각 도구별 스킬이 저장되어야 하는 위치를 지정해주고, 각 경로에 스킬 폴더가 복제되게끔 했다
💬 이 과정에서 배운 점
✅ 효과적이었던 것
도구별 역할 분담: 설계는 Antigravity, 조사+구현은 OpenCode — 각 도구의 강점을 살려 분업하니 효율이 올랐다
AI에게 조사를 시키면 깊이 파준다: 5개 도구의 세션 구조, 암호화 여부, 우회 방법까지 웹 검색과 로컬 탐색을 교차 검증하며 찾아냈다
스킬이 스킬을 개선하는 구조: skill-creator 스킬의 가이드라인을 write-post 스킬에 적용해 구조를 개선한 경험
🚀 앞으로의 계획
팀원들에게 배포해서 실제 AX 사례글 작성에 활용하게 하고, 피드백을 받아 개선할 예정
현재 실사용한 도구는 Claude Code + OpenCode + Antigravity 3개이므로, 나머지 2개(Codex CLI, Gemini CLI)도 실제 테스트 진행 예정
