Workflow Adapter

Multi-agent workflow system for Claude Code. 여러 AI agent가 협업하여 feature를 개발합니다.

Installation

Via devops-marketplace (Recommended)

# Add the devops-marketplace
/plugin marketplace add pubg-devops/devops-marketplace

# Install the plugin
/plugin install workflow-adapter@devops-marketplace

Direct GitHub Install

/plugin install github:pubg-devops/workflow-adapter

After installation, restart Claude Code to activate the plugin.

---

Quick Start

# 1. 프로젝트에 agent 시스템 설치 (3개 agent + orchestrator)
/workflow-adapter:install 3

# 2. 새 feature 계획
/workflow-adapter:feature 로그인 기능을 만들고 싶어

# 3. Agent들 실행
/workflow-adapter:execute login

# 4. 진행률 확인
/workflow-adapter:validate login

# 5. PR 생성
/workflow-adapter:pr login

---

Commands

/workflow-adapter:install <n>

프로젝트에 n개의 agent + orchestrator를 설치합니다.

/workflow-adapter:install 3

생성되는 것들:

• .claude/commands/alpha.md, beta.md, delta.md, orchestrator.md
• doc/agents/principle.md - Agent 행동 원칙
• doc/agents/messages/ - Agent 간 통신 폴더
• doc/feature_example/ - Feature 문서 템플릿
• .gitignore (git init 포함)

Agent 이름 순서: alpha → beta → gamma → delta → epsilon → zeta...

---

/workflow-adapter:feature <description>

새 feature를 계획합니다. 브레인스토밍 → Spec → Plan 순서로 진행됩니다.

/workflow-adapter:feature AWS SQS redrive CLI를 만들고 싶어

동작:

1. 프로젝트 컨텍스트 파악 (CLAUDE.md, README.md 읽기)
2. feature/sqs-redrive 브랜치 생성
3. 브레인스토밍 파일 생성 (70% 미리 채움)
4. 사용자 검토 후 Spec, Plan 문서 생성
5. Git 커밋

생성되는 파일:

doc/feature_sqs-redrive/
├── sqs-redrive_brainstorming.md
├── sqs-redrive_spec.md
└── sqs-redrive_plan.md

---

/workflow-adapter:execute <feature> [iterations]

Agent들을 백그라운드에서 실행합니다.

# 기본 (5회 반복)
/workflow-adapter:execute sqs-redrive

# 10회 반복
/workflow-adapter:execute sqs-redrive 10

동작:

1. 각 agent별 실행 스크립트 생성
2. 백그라운드에서 모든 agent 실행
3. 로그는 logs/{agent}.log에 저장

Agent 종료 조건:

• 모든 task 완료 후 완료 메시지 작성 시
• 최대 iteration 도달 시

---

/workflow-adapter:validate <feature>

진행률을 확인하고 피드백을 생성합니다.

/workflow-adapter:validate sqs-redrive

출력 예시:

╔══════════════════════════════════════════════════════════════╗
║           Feature Progress Report: sqs-redrive               ║
╚══════════════════════════════════════════════════════════════╝

Overall Progress
────────────────────────────────────────────────────────────────
[████████████████████░░░░░░░░░░░░░░░░░░░░] 52% (13/25 tasks)

Agent Progress
────────────────────────────────────────────────────────────────
Alpha    [████████████████████████████████████████] 100%  ✅
Beta     [████████████████████░░░░░░░░░░░░░░░░░░░░]  50%  🔄
Gamma    [████████░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░]  20%  ⏸️

---

/workflow-adapter:stop [agent]

실행 중인 agent를 중지합니다.

# 모든 agent 중지
/workflow-adapter:stop

# 특정 agent만 중지
/workflow-adapter:stop alpha

---

/workflow-adapter:pr <feature>

완료된 feature의 Pull Request를 생성합니다.

/workflow-adapter:pr sqs-redrive

동작:

1. Feature 브랜치 push
2. Spec/Plan에서 PR 설명 자동 생성
3. gh pr create 실행

---

Workflow 예시

┌─────────────────────────────────────────────────────────────┐
│                      install                                │
│  /workflow-adapter:install 3                                │
│  → alpha, beta, gamma agent + orchestrator 설치              │
└─────────────────────────────────────────────────────────────┘
                            ↓
┌─────────────────────────────────────────────────────────────┐
│                      feature                                │
│  /workflow-adapter:feature 새 기능 설명                        │
│  → 브레인스토밍 → Spec → Plan 문서 생성                           │
│  → feature/{name} 브랜치 생성                                  │
└─────────────────────────────────────────────────────────────┘
                            ↓
┌─────────────────────────────────────────────────────────────┐
│                      execute                                │
│  /workflow-adapter:execute {feature}                        │
│  → Agent들이 백그라운드에서 작업 시작                               │
│  → 각자 plan의 자기 섹션 task 수행                               │
│  → 완료 시 messages 폴더에 보고                                  │
└─────────────────────────────────────────────────────────────┘
                            ↓
┌─────────────────────────────────────────────────────────────┐
│                      validate                               │
│  /workflow-adapter:validate {feature}                       │
│  → 진행률 확인 (progress bar)                                  │
│  → 미완료 agent에게 피드백 메시지                                 │
└─────────────────────────────────────────────────────────────┘
                            ↓
┌─────────────────────────────────────────────────────────────┐
│                        pr                                   │
│  /workflow-adapter:pr {feature}                             │
│  → Pull Request 생성                                         │
└─────────────────────────────────────────────────────────────┘

---

Agent 역할

Agent	역할
Alpha, Beta, Gamma...	Plan의 자기 섹션에 정의된 task 수행
Orchestrator	Spec과 Plan을 기준으로 작업 완료 검증

---

파일 구조

project/
├── .claude/
│   └── commands/
│       ├── alpha.md
│       ├── beta.md
│       ├── gamma.md
│       └── orchestrator.md
├── doc/
│   ├── agents/
│   │   ├── principle.md      # Agent 행동 원칙
│   │   └── messages/         # Agent 간 통신
│   └── feature_{name}/
│       ├── {name}_brainstorming.md
│       ├── {name}_spec.md
│       └── {name}_plan.md
├── src/                      # Agent들이 생성하는 코드
├── scripts/                  # Agent 실행 스크립트
└── logs/                     # Agent 실행 로그

---

Tips

• 진행 중 확인: tail -f logs/alpha.log
• 모든 agent 중지: /workflow-adapter:stop
• 프로세스 확인: ps aux | grep run-
• Git 브랜치: feature/{name} 형식으로 자동 생성
• 커밋 규칙: Conventional Commits (feat, fix, refactor...)