본문으로 건너뛰기

Architecture

Layer 3

Project Config

프로젝트별 설정

pola.config.yaml
Layer 2

MCP Server + API

표준 인터페이스

mcp-server.js
Layer 1

Agent Core

파트너, 프롬프트, 라우팅

agents/

MCP Tools

pola_chat파트너에게 메시지를 전송하고 AI 응답을 받습니다live
pola_discuss에이전트 간 논의를 시작합니다live
pola_memory파트너 메모리를 조회합니다api
pola_slash슬래시 명령을 실행합니다live
pola_adapt프로젝트 적응 논의를 시작합니다live

Quick Start

1

설정 생성

node packages/cli/bin/pola-init.js
2

API 키 설정

export GEMINI_API_KEY=your-key
3

MCP 연결

node functions/dt/mcp-server.js
4

적응 실행

pola_adapt → 파트너 역할 자동 정의

pola.config.yaml

project:
  name: "내 프로젝트"
  language: "ko"

partners:
  enabled:
    - leader    # 앤드류 — 리더
    - planning  # 다니 — 기획
    - design    # 유나 — 디자인
    - dev       # 카이 — 개발
    - audit     # 렉스 — 감사

context:
  techStack: "Next.js, Firebase"
  targetAudience: "B2B SaaS"
  industry: "AI"

api:
  geminiModel: "gemini-2.5-flash"
  maxTokens: 8192

Test Results

12

project-config

설정 로더, env, 캐시

14

mcp-server

프로토콜, 도구, 리소스

4

mcp-executor

API 보안, 에러 핸들링

4

middleware

req 주입, next() 보장

34 tests passedin 1.3s

Partner Team

앤드류
앤드류리더
다니
다니기획 파트너
유나
유나디자인 파트너
카이
카이개발 파트너
미소
미소마케팅 파트너
주노
주노영업 파트너
하나
하나비서 파트너
렉스
렉스감사 파트너

Partner Commentary

카이 아바타
🔧 카이개발 파트너

3계층 아키텍처로 설계하여 각 프로젝트가 Layer 3(config)만 교체하면 동일한 Agent Core를 재사용할 수 있습니다. MCP 프로토콜 준수로 VS Code, Cursor 등 어떤 IDE에서든 연결됩니다.

렉스 아바타
🛡️ 렉스감사 파트너

API 키는 URL이 아닌 x-goog-api-key 헤더로 전송됩니다. 프롬프트 인젝션 방어는 시작부와 끝부에 이중 배치했습니다. 34개 자동화 테스트로 회귀를 방지합니다.

앤드류 아바타
👑 앤드류리더

pola_adapt 도구를 통해 새 프로젝트에 배치될 때 파트너들이 자동으로 프로젝트 컨텍스트를 분석하고 각자의 역할을 정의합니다. 인간 팀처럼 적응하는 AI 팀입니다.

유나 아바타
🎨 유나디자인 파트너

CLI 인터페이스는 4단계 인터랙티브 프롬프트로 설계했습니다. 프로젝트 정보, 컨텍스트, 파트너 선택, API 설정을 순서대로 안내하여 누구나 쉽게 설정할 수 있습니다.