giip FDE Agent 🤖📦

당신의 PC에 설치되는 포워드 배포형(Forward-Deployed) AI 엔지니어링 팀

🆕 What's New — 최근 업데이트 · 일주일 이내 갱신 내용을 여기서 확인하세요.

**FDE(Forward Deployed Engineer)**는 원격에서 지원하는 대신 고객의 현장에 직접 배치되어 그 조직의 문제를 함께 풀어내는 엔지니어를 뜻합니다. Palantir가 만든 용어로, 요구사항 분석부터 설계·구현·통합·배포까지 고객 옆에서 전 주기를 책임지는 것이 특징입니다. (Wikipedia)

giip FDE Agent는 이 개념을 AI 에이전트로 구현한 것입니다. 사람 대신 AI 엔지니어링 팀이 여러분의 PC(=현장)에 상주하며, .agent 폴더 하나로 이식되어 스스로 계획하고(Plan) 구현하며(Do) 검증하고(Check) 자가 최적화하는(Act) **"생각하는 에이전트 팀"**을 프로젝트에 즉시 투입합니다. 데이터와 컨텍스트는 로컬을 벗어나지 않습니다.

이 에이전트는 giip의 FDE 역량 — AI 기반 풀사이클 개발과 엔터프라이즈 운영 — 을 하나로 묶어 제공하는 giip FDE Box의 실행 주체입니다. 인프라 운영부터 AI 네이티브 개발까지, 엔터프라이즈 운영 전 주기를 여러분의 로컬 환경에서 수행합니다.

💡 설치·설정 지식이 전혀 없어도 괜찮습니다. giip FDE Box를 신청하기만 하면 전문가가 giip FDE Agent의 설치·연동을 대신 해드리고, 여러분은 곧바로 자유롭게 사용할 수 있습니다.

빠른 시작 가이드에서 5분 만에 첫 에이전트를 가동해 보세요!

도구 다운로드 · Antigravity 사용법 · 90분 온보딩 · 운영 거버넌스 · Slack 봇 연결 · 유용한 링크

giip-fde-agent는 public 레포지토리입니다. 따라서 이 레포 폴더 안에서 바로 작업하지 말고, 레포를 받아 → 여러분이 작업 메인으로 쓸 폴더로 필요한 파일을 복사한 뒤 → 그 폴더를 워크스페이스로 삼아 Slack 봇을 띄우는 것이 가장 빠르고 안전한 시작입니다. 이렇게 하면 업데이트를 받을 때 레포를 다시 pull 해도 여러분의 작업물과 섞이지 않습니다.

아래 순서대로 하면 Slack에서 @봇 <요청>으로 FDE Agent에게 일을 시킬 수 있는 상태까지 도달합니다.

• Node.js 18+ (node -v)
• Claude CLI 설치 및 로그인 — 봇은 Anthropic API Key 없이 claude -p CLI를 그대로 구동합니다. claude --version이 동작하고, 한 번 로그인(claude 실행 후 인증)돼 있어야 합니다. → Claude Code
• Slack 워크스페이스 관리자 권한 (앱을 설치할 수 있어야 함)

먼저 레포를 클론하고, 여러분이 작업 메인으로 쓸 폴더(예: C:\work\my-project)를 만든 뒤 그 폴더로 에이전트 파일을 복사합니다(.git 폴더 제외).

# 1) 레포 클론 (임의 위치)
git clone https://github.com/LowyShin/giip-fde-agent.git

# 2) 작업 메인 폴더 생성 (경로는 원하는 대로)
New-Item -ItemType Directory -Force "C:\work\my-project"

# 3) 에이전트 + slack-bot 파일을 작업 폴더로 복사
cd giip-fde-agent
Copy-Item -Path ".agent", "GEMINI.md", ".cursorrules", "COPILOT_INSTRUCTIONS.md", "slack-bot" -Destination "C:\work\my-project" -Recurse -Force

# 1) 레포 클론
git clone https://github.com/LowyShin/giip-fde-agent.git

# 2) 작업 메인 폴더 생성
mkdir -p ~/work/my-project

# 3) 에이전트 + slack-bot 파일을 작업 폴더로 복사 (.git 제외)
cd giip-fde-agent
rsync -av --exclude='.git' .agent GEMINI.md .cursorrules COPILOT_INSTRUCTIONS.md slack-bot ~/work/my-project/

이후 모든 작업은 복사한 작업 폴더(C:\work\my-project)에서 진행합니다. 원본 giip-fde-agent 폴더는 업데이트 수신용으로만 두세요.

봇은 공개 URL이 필요 없는 Socket Mode로 동작합니다. api.slack.com/apps에서 앱을 만들고 아래 두 토큰을 발급받으세요.

1. Create New App → From scratch 로 앱 생성
2. Socket Mode 활성화 → App-Level Token 생성(스코프 connections:write) → xapp-... 복사
3. OAuth & Permissions → Bot Token Scopes: chat:write, app_mentions:read, channels:history, channels:read, groups:history, im:history, im:read, im:write, users:read
4. Event Subscriptions 활성화 → Subscribe to bot events: app_mention, message.im, message.channels, message.groups
5. Install to Workspace → 설치 후 Bot User OAuth Token xoxb-... 복사

상세한 스크린샷 수준 가이드는 slack-bot/SLACK_APP_SETUP.md를 참고하세요.

작업 폴더 안의 slack-bot으로 들어가 의존성을 설치하고 .env를 채웁니다.

cd C:\work\my-project\slack-bot
npm install
Copy-Item .env.example .env   # (Mac/Linux: cp .env.example .env)

.env에서 최소 3개 값을 채우면 됩니다.

SLACK_BOT_TOKEN=xoxb-...                 # 2단계 5)에서 복사한 Bot Token
SLACK_APP_TOKEN=xapp-...                 # 2단계 2)에서 복사한 App-Level Token
WORKSPACE_DIR=C:\work\my-project         # 1단계에서 만든 작업 폴더 (.agent 가 있는 곳)

# 선택
# SLACK_CHANNEL_IDS=C0123456789          # 봇이 들을 채널 ID (미지정 시 DM은 항상 동작)
# BOT_NAME=My Team Bot
# GITHUB_TOKEN=ghp_...                    # !issues 명령용 GitHub PAT (repo scope)
# GITHUB_REPO=your-org/your-repo

WORKSPACE_DIR은 .agent/가 들어있는 작업 폴더를 가리켜야 합니다. 봇은 이 폴더 기준으로 태스크를 처리하고 git push 합니다.

node index.js

Socket Mode connected 로그가 뜨면 성공입니다. 항상 켜두려면 pm2로 상시 구동을 권장합니다.

npm install -g pm2
pm2 start index.js --name giipclaude-bot
pm2 save
pm2 logs giipclaude-bot     # 로그 확인

봇을 사용할 채널에서 초대한 뒤 멘션하면 됩니다.

/invite @<봇 이름>

@<봇 이름> 설정 페이지에 다크모드 토글 추가해줘
→ 봇이 요청을 분석해 태스크 계획(ID 포함)을 올림

go 20240601120000
→ 서브에이전트가 실행 후 git push, 결과 GitHub URL을 회신

기타 명령: tasklist(대기 태스크), cancel <taskID>, !issues, DM으로 직접 대화 등. 전체 사용법은 slack-bot/README.md에 있습니다.

FDE Agent는 **오케스트레이터(Orchestrator)**가 전체 전략을 세우고, **서브 에이전트(Sub-Agents)**들이 각자의 전문 분야에서 작업을 실행하는 구조입니다.

graph TD
    A[사용자 요청] --> B{Orchestrator}
    B -- 계획 수립 --> C[dispatch/*.task.md 생성]
    C -- 실행 명령 --> D[launch_subsession.ps1]
    D -- 역할 수행 --> E[전문 에이전트/Dev/Test/Sec]
    E -- 결과 보고 --> F[Trace & History 기록]
    F -- 검증 --> B
    B -- 최종 완료 --> G[사용자 보고]

에이전트를 구성하는 4대 요소(역할·규칙·스킬·워크플로우)의 상세는 👉 시스템 아키텍처 가이드를 참고하세요.

1. Zero-Tool Setup: 서드파티 툴 설치 없이, PowerShell과 기존 AI 개발 도구(Cursor, Antigravity 등)만으로 즉시 구동됩니다.
2. Local-First / Forward-Deployed: 에이전트가 현장(PC)에 상주하여 코드·인프라·문서 옆에서 직접 작업합니다.
3. Korean-First Workflow: 한국 개발 생태계에 최적화되어 한글 문서화와 상호작용성에서 독보적입니다.
4. Advanced Engineering DNA: Bkit(PDCA), Superpowers(TDD/Debugging), Gstack(보안/안전)의 정수를 통합했습니다.
5. Native Optimization: 리눅스·WSL2 없이 Windows 환경에서 실행 추적(Trace)과 자가 프롬프트 최적화(AI-Optimize)를 지원합니다.

• AI Native 개발자: 페어 프로그래밍을 넘어 에이전트 팀을 관리하려는 분
• 스타트업 & MVP 팀: 최소 인원으로 고품질 코드와 체계적 문서를 동시에 확보하려는 팀
• 레거시 관리자: Systematic Debugging과 TDD로 안전하게 리팩토링하려는 분
• 자동화 매니아: 반복 운영 업무를 신뢰할 수 있는 에이전트에게 위임하려는 분

FDE Agent는 아래 최신 AI 개발 도구들과 완벽하게 호환됩니다.

FDE Agent에는 검증된 프레임워크의 정수가 통합되어 있습니다. 각 역량의 상세 원리·명령어는 👉 심화 역량 가이드 (CAPABILITIES.md)에서 확인하세요.

코딩 전 행동 원칙(Think Before Coding / Simplicity First / Surgical Changes / Goal-Driven)은 Karpathy 가이드라인을 따릅니다.

전문적인 서버 구축이나 AI 기반 인프라 관리가 필요하신가요?

• giip FDE Box 제안서: 한국어 · 日本語 · English · 中文
• 공식 홈페이지: giip.littleworld.net
• 문의 메일: contact@littleworld.net

이 시스템은 다음 프로젝트들의 영감을 받아 구축되었습니다:

• Superpowers (Engineering Rigor)
• Bkit (PDCA Methodology)
• Gstack (Product Thinking & Safety)
• Agent Lightning (Tracing & APO)

참고 분석: SkillOpt와 Agent Lightning의 GIIP Dev Agent 적용 비교 분석

© 2026 giip FDE Agent. Optimized for Antigravity & AI-Native Builders.