안녕하세요! 20기 여러분. 👋 오늘은 제가 안티그래비티(AntiGravity) IDE를 가지고 놀다가 발견한 "개발자 없이 나만의 지식 기지(Wiki) 구축하는 법"을 공유하려고 합니다.
처음에는 그냥 "강의 자료 좀 정리해줘"라고 에이전트한테 말을 걸었을 뿐인데... 결과물이 꽤 괜찮아서 이걸 '누구나 쓸 수 있는 자동화 도구'로 역설계(Reverse Engineering)까지 해버렸네요. 😂
이 글을 다 읽으시고 나면, 여러분도 명령어 한 줄로 파이썬 강의, 요리 레시피북, 회사 매뉴얼을 뚝딱 만드실 수 있게 됩니다.
1. 왜 '강의 위키'인가요? 🤔
안티그래비티 강의를 준비하다가 여진님의 워크스페이스를 봤는데, '위키(Wiki)' 형태의 문서 구조가 너무 매력적이더라고요.
📂 커리큘럼(MOC): 모든 문서가 링크로 연결된 지도
📄 상세 문서: 클릭하면 나오는 구체적인 이론과 실습
📚 용어 사전: 초보자를 위한 친절한 설명
이렇게 정리해두면 단순 히 강의록으로 끝나는 게 아니라...
PPT 제작: "이 위키 문서 참고해서 장표 만들어줘" 하면 끝!
전자책 출판: 파일들만 묶으면 바로 책 한 권 분량!
유튜브 대본: 설명 부분만 다듬으면 대본 완성!
이른바 OSMU(One Source Multi Use)의 끝판왕이 될 수 있겠다는 생각이 들었습니다. 무엇보다 위키 웹사이트 만드는 복잡한 과정 없이, "그냥 폴더에 파일만 있으면 되는" 방식이라 비개발자에게도 압도적으로 편리하고요.
2. 맨땅에 헤딩부터 자동화까지 (Feat. 역설계)
제가 작업한 방식은 이렇습니다. 처음엔 무식(?)하게 시켰어요.
Phase 1: 자연어로 툭 던지기
제가 실제로 입력한 프롬프트입니다.
"이 커리큘럼의 각 소제목들을 문서링크로 만들어서 각 소제목 마다 자세한 문서를 만들거야.이 커리큘럼이 moc가 되는 거지. 이론 부분은 비개발자도 이해하기 쉽게 설명했으면 하고, 새로운 용어에 대해서도, 링크를 걸어서 설명을 넣어주고 싶어. 일종의 위키를 만드는 거지. 실습부분은 비개발자도 스텝바이 스텝으로 쉽게 따라할수 있게 단계별 문서가 있으면 해. 자세한 튜토리얼 형식이면 좋겠고, 여기도 마찬가지로 어려운 부분이나. 새로운 용어, 개발 용어 들에 대해선 링크로 자세한 설명이 있어야하고, 설치가 필요하거나, 참고해야할 홈페이지등 웹링크가 있으면 그것도 잘 들어가 있어야 할거 같아. 한번에 이렇게 위키문서가 뿅 나오면 좋겠지만 이 정도 맥락으로 가능할지 모르겠어. 가능할까? 부족 하다면 어떤점을 보완해야할지, 혹은 의혹이 해소되지 않는 부분이 있다면 나에게 자세히 물어봐줘. 인터뷰 하듯이"
이렇게 주절주절 되는데로 썻는데도 이 똑똑한 녀석이 폴더(
01-1주차)도 만들고, 파일(이론.md)도 만들고, 링크까지 걸어주는 겁니다! (소름)
Phase 2: "어? 이거 패턴인데?" (역설계)
결과물이 나름 괜찮아서 욕심이 생겼습니다. 그래서 에이전트에게 다시 요청했습니다.
"오늘 작업한 안티그래비티 강의 위키 만들기를 안티그래비티를 처음 설치해본 수강생이 바로 따라할수 있게 하고 싶어. 재사용할수 있는 프롬프트나, 스킬, 서브에이젼트, 플러그인 같은 형식으로 만들어서 누구나 바로 커리큘럼이나 구체적인 강의 내용만 넣으면 강의 위키가 만들어지게 하는 거야. 어떤 방식으로 하는게 좋을지 여기 채팅창에 제안해줄래?."
이렇게 입력하자 안티그래비티는 워크플로우 방식을 추천해 주었어요.
추천 솔루션: [제안 1] 워크플로우 파일 만들기 가장 깔끔하고 안티그래비티다운 '워크플로우(.md)' 방식으로 만들어보는 게 어떨까요? 제가 지금 setup-course-wiki.md의 초안을 작성해서 보여드릴 수 있습니다.
이 워크플로우에 들어갈 내용:
입력: 강의 주제, 대상, 기간 (사용자에게 물어봄)
구조 생성: 00-커리큘럼(MOC) 01-1주차 ~ 04-4주차 폴더 99-용어사전, 98-참조사이트
폴더 파일 생성: 각 폴더에 이론.md, 실습.md 템플릿 생성 (우리가 만든 양식 적용)
링크 연결: 커리큘럼 파일에 모든 주차 파일을 자동으로 링크 연결.
그렇게 탄생한 게 바로 setup-wiki 라는 자동화 스크립트입니다. 이제 어떤 주제든 상관없습니다. 자료가 없으면 에이전트가 알아서 구글링(리서치)해서 위키를 만들어줍니다.
3. [따라하기] 여러분도 지금 바로 해보세요! 🚀
자, 이제 여러분 차례입니다. 안티그래비티만 설치되어 있다면 3분 컷입니다.
📥 준비물: 안티그래비티 IDE
아직 없으신가요? 구글 아이디만 있으면 무료로 쓸 수 있습니다. 👉 공식 다운로드 바로가기 (antigravity.google)
Step 1. 워크플로우 파일 받기
아래 코드블럭의 내용을 복사해서 여러분 프로젝트의 .agent/workflows/setup-wiki.md 라는 파일로 저장하세요.
# 🏗️ 지능형 강의 위키 생성기 (Ver 4.0 - 튜토리얼 마스터)
이 워크플로우는 단순한 요약본을 만드는 것이 아닙니다. 초보자가 보고 그대로 따라 할 수 있는 **친절하고 상세한 튜토리얼**을 만들고, **용어 사전과 참조 자료**까지 자동으로 완성해줍니다.
## 1. 인터뷰 (Needs Assessment)
1. **기본 스펙**: 강의 제목, 타겟 독자, 총 기간.
2. **의도(Intent)**: "어떤 스타일의 강의를 원하시나요?"
3. **참고 자료**: "URL이나 파일이 있나요? 없으면 제가 찾겠습니다."
## 2. 자료 수집 및 팩트 체크 (Research)
* 자료가 없으면 스스로 웹 검색을 통해 표준 커리큘럼과 공식 문서를 찾습니다.
* **중요**: 실습 단계를 작성하기 위해, 실제 해당 도구나 라이브러리(예: Antigravity, Python 등)의 **공식 튜토리얼(Getting Started)** 문서를 반드시 참고하세요.
## 3. 구조 설계 (Architecture)
* **4단계 MOC 구조**: `00-커리큘럼` -> `주차별 폴더` -> `상세 문서` -> `용어/참조`
## 4. 콘텐츠 작성 (Content Generation)
아래 원칙을 준수하여 각 파일을 작성하세요.
### A. 실습 문서 작성 원칙 (튜토리얼 스타일) ⭐
* **Target**: "아무것도 모르는 초보자"라고 가정하세요.
* **Detail**: "버튼을 누르세요" 대신 "**우측 상단의 파란색 `Save` 버튼을 누르세요**"라고 쓰세요.
* **Format**:
1. **준비물**: 시작 전 필요한 것.
2. **Step-by-Step 가이드**: 번호(1, 2, 3...)를 매겨서 따라 하게 하세요.
3. **코드/명령어**: 복사해서 쓸 수 있는 코드 블록을 제공하세요.
4. **예상 결과**: "이 명령을 실행하면 화면에 `Success`라고 떠야 합니다."라고 알려주세요.
### B. 이론 문서 작성 원칙
* 어려운 개념은 비유(Metaphor)를 들어 설명하세요.
## 5. 용어 및 참조 자동화 (Automation) ⭐
본문 작성이 끝나면 다음 작업을 반드시 수행하세요.
1. **용어 사전 생성**:
* 문서 내에 쓰인 `[[키워드]]`나 중요한 기술 용어를 모두 추출하세요.
* `99-용어사전` 폴더에 각 용어별로 `키워드.md` 파일을 만드세요.
* 내용은 **"비전공자도 이해할 수 있는 쉬운 정의 + 예시"**로 채우세요. (빈 파일 금지!)
2. **참조 사이트 정리**:
* 작성 중 참고한 모든 공식 문서, 블로그, 유튜브 링크를 수집하세요.
* `98-참조사이트/01-추천_자료_모음.md` 파일에 카테고리별로 정리해서 저장하세요.
## 6. 최종 보고
1. 생성된 파일 트리 구조 요약.
2. "실습 가이드와 용어 사전까지 모두 생성되었습니다. 이제 바로 따라 해보세요!"라는 멘트로 마무리.
Step 2. 명령어 실행
채팅창에 이렇게 치세요.
/setup-wiki
Step 3. 인터뷰 답변하기
🤖: "어떤 강의를 만드시나요? 자료가 없으면 제가 찾아드릴까요?"
👤: "유튜브 영상 편집 강의 만들 거야. 4주 과정이고, 초보자용이야. 자료는 없으니 네가 검색해서 짜줘."
Step 4. 결과 감상
잠시 후... 짠! ✨ 폴더 구조, 커리큘럼, 주차별 강의안 초안, 참고 사이트 목록까지 완벽하게 생성됩니다.
4. 마치며
다음 주부터는 이 시스템을 활용해 실제로 나만의 강의 사례를 만드는 실습을 진행하고 발표할 예정입니다. 안티그래비티에 관심 있으신 분들은 미리 설치해오시면, 제 사례를 보면서 바로 따라 하실 수 있을 거예요!
AI, 어렵게 공부하지 말고 일단 말부터 걸어보세요. 그 대화 속에 답이 있고, 도구가 있습니다.
감사합니다!
제 활동에 관심이 있으면 아래 링크를 클릭하세요.
계속 업데이트 될거예요.
