Agent Starter Kit 크몽 발행 — 검증 → 템플릿 6 종 → 등록까지 하룻밤
한 줄로
agent-starter-kit 가 크몽에 정식 발행됐다. 5/18 V4 전략보고서가 박은 TIER 1 항목 4 개 중 첫 항목이 30 시간 안에 라이브로 갔다.
무엇을 했나
1. 서브 계정 클린 환경 검증
메인 PC 의 새 Windows 사용자 계정 student 를 만들었다. 진짜 학생의 클린 환경을 그대로 흉내내려 했다. 메인 계정과 격리됐고, 환경 변수 / 설치된 SW / 캐시 = 0.
그 환경에서 AgentClient.exe v1.0-beta 를 더블클릭부터 시작해서 끝까지 갔다.
2. 8/8 PASS
도구 5 개 + 보안 + 설정 persistence 동시 검증.
/start인사 정상- 파일 쓰기 →
hello.txt생성 OK - 파일 읽기 → 내용 정확
- 웹 검색 → Gemini grounding 답변 정상
- URL fetch →
example.com본문 정확 list_files→ 파일 목록 정확- Path traversal 차단 → 시스템 파일 거부
- .exe 재실행 시 키 자동 입력 OK
학생이 받자마자 5 분 안에 봇 작동 확인할 수 있는 흐름. 검증으로 확정.
3. 발견한 결함 3 개
| # | 결함 | 등급 | 해결 |
|---|---|---|---|
| 1 | BotFather 로 봇 만든 직후 묵묵부답 → 학생 패닉 | 🔴 블로커 | 가이드 명시 추가 (README) |
| 2 | GUI 에 ALLOWED_USER_IDS 입력란 없음 → 보안 갭 | 🟡 보안 | 코드 핫픽스 별도 |
| 3 | 재실행 시 "시작" 버튼 수동 클릭 | ⚪ 마이너 | 가이드 한 줄 |
가장 무거운 건 #1 — "내가 만든 봇이 왜 안 답하지?" 가 학생에게 가장 큰 panic 트리거였다. 답은 단순: BotFather 가 만든 봇 = 빈 껍데기. AgentClient.exe 가 켜져야 봇이 깨어남. SIM 카드 vs 핸드폰 비유로 가이드에 박았다.
4. 컨텍스트 엔지니어링 템플릿 6 종
| 파일 | 역할 |
|---|---|
CLAUDE.md | AI 에게 주는 프로젝트 지침 |
AGENTS.md | 도구 공통 컨벤션 (2026 산업 표준) |
MEMORY.md | 세션 간 영속 메모리 |
TESTING.md | 검증 절차 + 완료 조건 |
GLOSSARY.md | 한국어 / 영어 / 코드 식별자 매핑 |
docs/adr/0001-template.md | 결정 기록 (MADR 표준) |
조사 결과 발견 = AGENTS.md 가 사실상 2026 년 글로벌 산업 표준 (Claude Code / Cursor / Aider / Devin / Copilot / Gemini CLI / Windsurf / Amazon Q 모두 native 자동 로드). Linux Foundation 산하 Agentic AI Foundation 이 관리. 한국어로 정리된 자료는 거의 없는 영역.
각 템플릿 = "예시 + 빈 칸 + 안 채우면 어떻게 되는지" 박힘. 학생이 즉시 복사해서 자기 프로젝트에 채워서 사용 가능.
5. README v2
새로 쓴 README 에 추가된 섹션:
- 5 분 셋업 (Python 흐름 + .exe 흐름 둘 다)
- 컨텍스트 엔지니어링 6 종 안내
- 모델 비교 표 3 종 (Gemini 2.5 Flash vs OpenRouter 무료 모델 vs 로컬 Ollama)
- "가장 효과적으로 사용하는 방법" — 일일 / 주간 리츄얼, Function Calling sweet spot, 봇 호출 패턴
6. Vercel build fix
이 사이트의 빌드가 깨져있었다. 원인 = 5/16 publish 한 글 (can-gemma4-defend-what-it-builds) 의 frontmatter date 가 따옴표 없는 ISO 8601 형식. YAML 이 Date 객체로 파싱 → Next.js getStaticProps 가 JSON 직렬화 실패. 1 줄 픽스 (따옴표 추가) → 정상.
7. /projects 페이지 V4 brutal filter 반영
11 → 14 프로젝트 재구성. agent-starter-kit / RedJack Pipeline / Gemma 4 시리즈 / BLOOD BARGAIN / BAPTISM IN SILK 추가. Jackstack (Sniper Kmong CUT) / CEK (통합) 제거. WILD_SNIPER restatus = "실거래 검증 중" → "데이터 자산 보존 (봇 셧다운)".
8. 크몽 발행
가격 ₩39,000 단일가. 카테고리 IT·프로그래밍 > AI 에이전트. 검색 키워드 5 개. FAQ 8 개. 상세 이미지 9 장 (PNG → JPG 변환 후 통과).
왜 이게 의미 있는가
V4 전략보고서 (5/18 06:50 KST) 가 박은 TIER 1 항목 = 4 개:
agent-starter-kit← 오늘 라이브 ⭐- 전자책 3 종
- BB Korean
- Gemma 4 챌린지
첫 항목이 V4 박힌 지 30 시간 만에 시장에 노출됐다. 첫 결제 / 첫 후기 / 첫 데이터가 다음 3 가지를 결정한다:
- TIER 1 의 다른 3 항목 페이스
- 가격 인상 / tier 확장 / 1:1 컨설팅 옵션 추가 타이밍
- "한국어 indie AI dev 시장" 의 수요 실측 데이터
다음 페이스
- 5/19 ~ 5/22: 첫 5 건 결제 데이터 수집 (양 vs 단가 trade-off 측정)
- 5/20 09:00 KST: Gemma 4 챌린지 5 편 publish target
- 5/25 PDT 16:00: Gemma 4 챌린지 마감
- 6 월 첫째 주: 5 건 후기 누적 후 가격 인상 (
₩59K) 검토 - 6 월 중순: 강의 2 편 (셸 도구 추가) + 3 편 (24/7 클라우드) 시작
정리
검증부터 발행까지 30 시간. 한 사람이 1 인 개발자 + 1 인 디자이너 + 1 인 마케터 + 1 인 영업으로 통째 진행. AI 에이전트가 코드 작성 / 템플릿 작성 / 이미지 생성 / 컨텍스트 정리를 보조. V4 전략보고서가 "어디부터 갈지" 의 답을 명확히 박아둔 게 컸다.
다음 일지는 5/19 ~ 5/20 사이의 첫 결제 / 첫 응답 / 첫 후기 데이터 (도달 시) 또는 Gemma 4 5 편 publish 후.