DG
DonggriGent Docs

워크플로 가이드

누구를 위한 문서: MCP 등록을 끝냈고 실전 자동화를 시작하려는 사용자

완료 기준: 작업 목적에 맞는 `*_ko` 워크플로를 선택해 1회 이상 실행

기본 추천 워크플로

  • cpp_refactor_ko: C++ 리팩터링/구조 개선
  • vendor_hardening_ko: 인증/팝업/의존성 하드닝
  • mcp_extension_ko: MCP 도구 확장/계약 정리
처음 시작하거나 한국어 보고서/리뷰가 필요하면 `*_ko`를 먼저 선택하세요. 기존 자동화 호환이 필요할 때만 non-`_ko`를 사용하세요.

실행 전 확인

cd ~/DonggriGent
codex mcp list
claude mcp list
cd ~/DonggriGent
npm run start

앱 실행 상태에서 워크플로 호출이 안정적으로 동작합니다.

워크플로 실행(JSON 예시)

아래 JSON은 터미널 명령이 아니라 MCP 도구 호출 예시입니다.

{
  "tool": "kgentool_workflow_run",
  "arguments": {
    "workflowName": "vendor_hardening_ko",
    "prompt": "현재 저장소 기준 보안 우선순위와 즉시 적용 패치 후보를 한국어로 정리해줘."
  }
}
{
  "tool": "kgentool_workflow_run",
  "arguments": {
    "workflowName": "cpp_refactor_ko",
    "prompt": "C++ 리팩터링 범위를 1주 단위로 나눠서 실행 계획을 제시해줘."
  }
}

상황별 선택 가이드

  • 구조 개선 중심: cpp_refactor_ko
  • 보안/운영 안정성: vendor_hardening_ko
  • 도구 계약 확장: mcp_extension_ko

레거시/선택 사항: 워치 폴더

워치 폴더 계열은 현재 레거시 alias(`agentify_*`)를 사용합니다. 첫 사용자는 이 단계 없이 `kgentool_*`만으로 시작해도 됩니다.

{
  "tool": "agentify_add_watch_folder",
  "arguments": {
    "name": "inbox",
    "folderPath": "/home/$USER/DonggriInbox"
  }
}
워치 폴더는 전용 inbox만 등록하고, 홈 디렉터리/저장소 루트는 등록하지 마세요.

운영 체크리스트

  • 작업별 `key`를 고정해서 문맥 재사용
  • 작은 범위부터 실행 후 확장
  • 산출물 저장 후 다음 작업 첨부 루프 유지
  • 필요 시 `kgentool_status`로 런타임 확인

문제 발생 시

  • FAQ에서 인증/포트/권한 이슈 확인
  • 브라우저 백엔드가 불안정하면 chrome-cdp 전환 검토
  • 테스트 재실행: npm test
다음 문서: 아키텍처