Skip to content

getting-started.md

Latest commit

 

History

History
132 lines (98 loc) · 3.31 KB

getting-started.md

File metadata and controls

132 lines (98 loc) · 3.31 KB

빠른 시작 가이드

시작 시퀀스

sequenceDiagram
    actor Dev as 개발자
    participant Rust as MCP Server
    participant Web as Dashboard
    participant RAG as RAG Engine

    Dev->>Rust: cargo run -- --with-web
    Rust->>Rust: API 서버 시작 (:4070)
    Rust->>Web: Vite 개발 서버 시작 (:5173)

    Dev->>Web: 브라우저에서 접속
    Web->>Rust: POST /api/runtime/init
    Rust->>Rust: .agentCompany/ 워크스페이스 생성
    Rust->>RAG: RAG 재인덱싱 (자동)

    Dev->>Web: 에이전트 생성
    Web->>Rust: POST /api/runtime/agents
    Dev->>Web: Directive 제출
    Web->>Rust: POST /api/runtime/directives
    Rust->>Rust: 사이클 시작 (PLAN→WORK→...)
Loading

전제 조건

도구 설치 확인 용도
Rust (cargo) cargo --version MCP 서버 빌드
Node.js (npm) node --version 웹 대시보드
uv uv --version RAG 엔진 (Python)
claude CLI which claude Claude 에이전트 실행
gemini CLI which gemini Gemini 에이전트 실행 (선택)
codex CLI which codex Codex 에이전트 실행 (선택)

API 키 (RAG 임베딩용, 선택)

  • GOOGLE_API_KEY — Gemini 임베딩 (우선)
  • OPENAI_API_KEY — OpenAI 임베딩 (차선)
  • 둘 다 없으면 로컬 sentence-transformers 사용

개발 모드

# 1. MCP 서버 + 웹 개발 서버 동시 시작
cd mcp-server && cargo run -- --with-web

# API: http://127.0.0.1:4070
# Web: http://127.0.0.1:5173

프로덕션 모드

# 1. 웹 빌드
cd web && npm install && npm run build

# 2. 서버 시작 (정적 파일 서빙 포함)
cd mcp-server && cargo run --release

# 또는 스크립트 사용
scripts/run-local.sh

첫 에이전트 생성

1. 워크스페이스 초기화

브라우저에서 http://localhost:5173 접속 후:

  1. 워크스페이스 경로 입력 (예: /Users/user/my-project)
  2. "초기화" 버튼 클릭

또는 API:

curl -X POST http://127.0.0.1:4070/api/runtime/init \
  -H "Content-Type: application/json" \
  -d '{"workdir": "/Users/user/my-project"}'

2. 에이전트 생성

대시보드에서 에이전트 생성 폼을 통해:

  • 타입: claude / gemini / codex
  • 이름: Strategy Chief
  • 역할: strategy-chief
  • 조직 레벨: chief
  • 페르소나: 전략 수립 및 범위 확정 전문

초기화 시 기본 Chief 에이전트가 자동 생성됩니다.

3. Directive 제출

대시보드 Directive 입력란에 지시를 입력합니다:

로그인 페이지에 2FA 인증을 추가해줘

제출하면 자동으로 사이클이 시작됩니다:

  1. PLAN: Chief가 실행 계획 수립
  2. WORK: CLI로 코드 구현
  3. REVIEW: 리뷰 및 품질 검증
  4. COMPOUND: 산출물 통합
  5. CYCLE_END: CEO 최종 승인

4. 자동 실행 설정

수동 승인 없이 자동으로 사이클을 진행하려면:

~/.agentCompany/settings.json:

{
  "directiveAutoApprove": true,
  "claudeExtraArgs": "-p --dangerously-skip-permissions"
}

RAG 인덱싱

워크스페이스 초기화 시 자동으로 RAG 재인덱싱이 실행됩니다.

수동 재인덱싱:

scripts/reindex-rag.sh --workdir /path/to/workdir

# 또는 직접 실행
cd rag-engine && uv sync
uv run --project rag-engine rag-engine/cli.py ingest