비전공자용 4단계 시작
- 1) 설치: `npm ci` + `npm run start`
- 2) MCP 연결: Codex 또는 Claude Code에 도구 등록
- 3) 첫 질의: `kgentool_query`로 오늘 목표 3개 요청
- 4) 결과 저장: `kgentool_save_artifacts`로 다음 작업에 재사용
목표는 먼저 완벽이 아니라, 5분 안에 첫 호출 성공입니다.
이렇게 쓰면 잘 맞는 조합
- 기획팀: 요구사항 정리를 `key` 기준으로 표준화
- 개발팀: 브라우저 세션 유지 작업 + 리뷰 흐름 합치기
- PM: 산출물 저장 루틴으로 보고서 작성 시간 단축
반복성 기반 운영이 결국 운영 효율을 만듭니다.
Visual Collage
GitHub Pages 한 화면 미리보기
설치 흐름, 기능 매트릭스, 아키텍처를 잘라서 한 장처럼 묶었습니다. 처음 방문한 사람도 제품 범위를 몇 초 안에 파악할 수 있게 구성했습니다.
SVG 인포그래픽을 HTML에서 직접 크롭해 반응형 콜라주로 배치했습니다. GitHub Pages에서도 별도 빌드 없이 그대로 렌더링됩니다.
5분
첫 실행 목표 시간
설치, 실행, MCP 등록, 첫 호출까지 최소 동선 제공
3개
기본 *_ko 워크플로
`cpp_refactor_ko`, `vendor_hardening_ko`, `mcp_extension_ko`
1곳
공식 문서 루트
이 GitHub Pages가 단일 진입점입니다.
복붙 샘플
도구 호출 예시
아래 JSON은 터미널 명령이 아니라 MCP 클라이언트 도구 호출 예시입니다.
kgentool_query
{
"tool": "kgentool_query",
"arguments": {
"key": "quickstart",
"prompt": "현재 저장소에서 오늘 바로 할 작업 3개를 한국어로 정리해줘."
}
}kgentool_workflow_run
{
"tool": "kgentool_workflow_run",
"arguments": {
"workflowName": "cpp_refactor_ko",
"prompt": "C++ 리팩터링 우선순위와 검증 순서를 한국어로 제안해줘."
}
}신규 도입 시 문서/운영 모두 `*_ko`를 기본 추천으로 사용합니다.
문서 경로
운영 팁
- 작업별 `key`를 고정해 문맥 재사용
- 처음엔 작은 범위 질의 후 확장
- 로그인 이슈가 있으면 FAQ/브라우저 백엔드 문서 확인
권장 운영 원칙: 먼저 실패가 적은 시나리오부터 자동화하고, 로그로 원인-해결-재실행 루틴을 고정하세요.